Skip to content

docs: TrueNAS SCALE migration + lab compute tier - #42

Merged
rgardner4012 merged 6 commits into
mainfrom
docs/update_to_current_layout
Jun 23, 2026
Merged

docs: TrueNAS SCALE migration + lab compute tier#42
rgardner4012 merged 6 commits into
mainfrom
docs/update_to_current_layout

Conversation

@rgardner4012

@rgardner4012 rgardner4012 commented Jun 23, 2026

Copy link
Copy Markdown
Owner

Summary

  • Update README, ADRs, DR, and naming-and-ips for the UGOS → TrueNAS SCALE migration (5x20TB RAIDZ2 data pool, 2x SSD mirrored boot pool, ~53TB usable).
  • Add a new Lab Compute tier for skills prep — R620 running Nutanix CE, XPS 9510 running Proxmox to host AAP and a Terraform Enterprise agent VM.
  • New ADR-010 (TrueNAS migration) and ADR-011 (lab compute tier, including the TFE-agent-on-Proxmox-over-RKE2 rationale).

Test plan

  • Skim rendered Markdown on the PR for table/heading layout
  • Confirm ADR-010 numbering and cross-links resolve
  • Confirm ADR-011 numbering and cross-links resolve
  • Verify naming-and-ips Lab Compute table reflects: idrac .120, r620 .38, cvm .39, pve .45, aap .178, tfagent TBD
  • Verify disaster-recovery NAS Recovery section reads correctly end-to-end

Rick Gardner added 2 commits June 23, 2026 11:04
- README hardware row now reflects TrueNAS SCALE and 53TB usable
- ADR-010 records the UGOS -> TrueNAS SCALE move and the 5x20TB RAIDZ2 + 2x SSD mirrored boot pool topology
- disaster-recovery gains TrueNAS/ZFS checklist items, RTO/RPO rows for the data pool, boot pool, and TrueNAS config, and a NAS Recovery section
- naming-and-ips nas.homelab row notes TrueNAS SCALE and pool layout
- README hardware table split into Core and Lab sub-sections; adds R620 and XPS 9510 rows
- ADR-011 records the lab compute decision and the TFE-agent-on-Proxmox choice over RKE2
- disaster-recovery adds a single lab-tier row (rebuild from scratch, no preserved state)
- naming-and-ips adds a Lab Compute table for idrac/r620/cvm/pve/aap/tfagent and flags the scattered IP block
Copilot AI review requested due to automatic review settings June 23, 2026 15:38

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Documentation update to reflect the homelab’s UGOS → TrueNAS SCALE migration and to introduce a separate “Lab Compute” tier (Nutanix CE + Proxmox) that’s intentionally kept outside the GitOps-managed core.

Changes:

  • Update top-level README hardware inventory to reflect TrueNAS SCALE and add the Lab Compute tier.
  • Extend naming-and-ips.md with Lab Compute host/IP assignments and update NAS notes for the new ZFS pools.
  • Expand disaster recovery docs with TrueNAS/ZFS backup items and a new NAS recovery runbook; add ADR-010 (TrueNAS migration) and ADR-011 (Lab compute tier rationale).

Reviewed changes

Copilot reviewed 4 out of 4 changed files in this pull request and generated 4 comments.

File Description
README.md Updates hardware inventory and adds Lab Compute tier to align README with the new architecture.
docs/naming-and-ips.md Adds Lab Compute addressing and updates NAS row to match TrueNAS/ZFS details.
docs/disaster-recovery.md Adds ZFS/TrueNAS backup checklist items and a NAS recovery procedure section.
docs/adr.md Adds ADR-010 (TrueNAS migration) and ADR-011 (Lab compute tier) to capture key architecture decisions.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment thread README.md Outdated
Comment thread README.md Outdated
Comment thread docs/naming-and-ips.md Outdated
Comment thread docs/disaster-recovery.md
rgardner4012 and others added 4 commits June 23, 2026 11:47
Gb to GB

Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
Gb to GB

Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
mirror/mirrored

Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
drop re-merge to main wording.

Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
@rgardner4012
rgardner4012 merged commit 46fc4bb into main Jun 23, 2026
8 checks passed
@rgardner4012
rgardner4012 deleted the docs/update_to_current_layout branch June 23, 2026 15:51
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants