jramos/homelab
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

refactor(repo): reorganize repository structure for improved navigation and maintainability

Browse Source 
Implement comprehensive directory reorganization to improve discoverability,
logical grouping, and separation of concerns across documentation, scripts,
and infrastructure snapshots.

Major Changes:

1. Documentation Reorganization:
   - Created start-here-docs/ for onboarding documentation
     * Moved QUICK-START.md, START-HERE.md, GIT-SETUP-GUIDE.md
     * Moved GIT-QUICK-REFERENCE.md, SCRIPT-USAGE.md, SETUP-COMPLETE.md
   - Created troubleshooting/ directory
     * Moved BUGFIX-SUMMARY.md for centralized issue resolution
   - Created mcp/ directory for Model Context Protocol configurations
     * Moved OBSIDIAN-MCP-SETUP.md to mcp/obsidian/

2. Scripts Reorganization:
   - Created scripts/crawlers-exporters/ for infrastructure collection
     * Moved collect*.sh scripts and collection documentation
     * Consolidates Proxmox homelab export tooling
   - Created scripts/fixers/ for operational repair scripts
     * Moved fix_n8n_db_*.sh scripts
     * Isolated scripts with embedded credentials (templates tracked)
   - Created scripts/qol/ for quality-of-life utilities
     * Moved git-aliases.sh and git-first-commit.sh

3. Infrastructure Snapshots:
   - Created disaster-recovery/ for active infrastructure state
     * Moved latest homelab-export-20251202-204939/ snapshot
     * Contains current VM/CT configurations and system state
   - Created archive-homelab/ for historical snapshots
     * Moved homelab-export-*.tar.gz archives
     * Preserves point-in-time backups for reference

4. Agent Definitions:
   - Created sub-agents/ directory
     * Added backend-builder.md (development agent)
     * Added lab-operator.md (infrastructure operations agent)
     * Added librarian.md (git/version control agent)
     * Added scribe.md (documentation agent)

5. Updated INDEX.md:
   - Reflects new directory structure throughout
   - Updated all file path references
   - Enhanced navigation with new sections
   - Added agent roles documentation
   - Updated quick reference commands

6. Security Improvements:
   - Updated .gitignore to match reorganized file locations
   - Corrected path for scripts/fixers/fix_n8n_db_c_locale.sh exclusion
   - Maintained template-based credential management pattern

Infrastructure State Update:
   - Latest snapshot: 2025-12-02 20:49:54
   - Removed: VM 101 (gitlab), CT 112 (Anytype)
   - Added: CT 113 (n8n)
   - Total: 9 VMs, 3 Containers

Impact:
   - Improved repository navigation and discoverability
   - Logical separation of documentation, scripts, and snapshots
   - Clearer onboarding path for new users
   - Enhanced maintainability through organized structure
   - Foundation for multi-agent workflow support

Files changed: 90 files (+935/-349)
   - 3 modified, 14 new files, 73 renames/moves

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
Jordan Ramos
2025-12-02 21:39:33 -07:00
parent eec4c4b298
commit 4f69420aaa
90 changed files with 935 additions and 349 deletions
Download Patch File Download Diff File Expand all files Collapse all files

212
disaster-recovery/homelab-export-20251202-204939/SUMMARY.md Normal file
View File

@@ -0,0 +1,212 @@
# Collection Summary Report
## Collection Metadata
- **Date/Time**: 2025-12-02 20:49:54
- **Hostname**: serviceslab
- **Collection Level**: full
- **Script Version**: 1.0.0
## Sanitization Settings
- **IP Addresses**: false
- **Passwords**: true
- **Tokens/Keys**: true
## Collection Statistics
### Successfully Collected
Total items collected: 50
- Proxmox VE version
- Hostname
- Kernel information
- System uptime
- System date/time
- CPU information
- Detailed CPU info
- Memory information
- Detailed memory info
- Filesystem usage
- Block devices
- LVM physical volumes
- LVM volume groups
- LVM logical volumes
- IP addresses
- Routing table
- Listening sockets
- Installed packages
- Datacenter config
- Storage config
- User config
- Auth public key
- VM 100 (docker-hub) config
- VM 104 (ubuntu-dev) config
- VM 105 (dev) config
- VM 106 (Ansible-Control) config
- VM 107 (ubuntu-docker) config
- VM 108 (CML) config
- VM 109 (web-server-01) config
- VM 110 (web-server-02) config
- VM 111 (db-server-01) config
- Container 102 (nginx) config
- Container 103 (netbox) config
- Container 113 (n8n
n8n
n8n) config
- Network interfaces config
- Hosts file
- DNS resolver config
- Storage status
- ZFS pool status
- ZFS pool list
- ZFS datasets
- Samba config
- iSCSI initiator config
- Vzdump config
- Cluster resources
- Recent tasks
- VM list
- Container list
- All guests (JSON)
- Systemd services
### Skipped Items
Total items skipped: 1
- Authentication domains
### Errors
Total errors: 5
- HA configuration
- Additional interface configs
- SDN configuration
- Cluster status
- Cluster nodes
## System Overview
### Proxmox Version
```
proxmox-ve: 8.3.0 (running kernel: 6.8.12-8-pve)
pve-manager: 8.3.3 (running version: 8.3.3/f157a38b211595d6)
proxmox-kernel-helper: 8.1.0
proxmox-kernel-6.8: 6.8.12-8
proxmox-kernel-6.8.12-8-pve-signed: 6.8.12-8
proxmox-kernel-6.8.12-4-pve-signed: 6.8.12-4
ceph-fuse: 17.2.7-pve3
corosync: 3.1.7-pve3
criu: 3.17.1-2+deb12u1
glusterfs-client: 10.3-5
ifupdown2: 3.2.0-1+pmx11
ksm-control-daemon: 1.5-1
libjs-extjs: 7.0.0-5
libknet1: 1.28-pve1
libproxmox-acme-perl: 1.5.1
libproxmox-backup-qemu0: 1.5.1
libproxmox-rs-perl: 0.3.4
libpve-access-control: 8.2.0
libpve-apiclient-perl: 3.3.2
libpve-cluster-api-perl: 8.0.10
libpve-cluster-perl: 8.0.10
libpve-common-perl: 8.2.9
libpve-guest-common-perl: 5.1.6
libpve-http-server-perl: 5.2.0
libpve-network-perl: 0.10.0
libpve-rs-perl: 0.9.1
libpve-storage-perl: 8.3.3
libspice-server1: 0.15.1-1
lvm2: 2.03.16-2
lxc-pve: 6.0.0-1
lxcfs: 6.0.0-pve2
novnc-pve: 1.5.0-1
proxmox-backup-client: 3.3.2-1
proxmox-backup-file-restore: 3.3.2-2
proxmox-firewall: 0.6.0
proxmox-kernel-helper: 8.1.0
proxmox-mail-forward: 0.3.1
proxmox-mini-journalreader: 1.4.0
proxmox-offline-mirror-helper: 0.6.7
proxmox-widget-toolkit: 4.3.4
pve-cluster: 8.0.10
pve-container: 5.2.3
pve-docs: 8.3.1
pve-edk2-firmware: 4.2023.08-4
pve-esxi-import-tools: 0.7.2
pve-firewall: 5.1.0
pve-firmware: 3.14-3
pve-ha-manager: 4.0.6
pve-i18n: 3.3.3
pve-qemu-kvm: 9.0.2-5
pve-xtermjs: 5.3.0-3
qemu-server: 8.3.7
smartmontools: 7.3-pve1
spiceterm: 3.3.0
swtpm: 0.8.0+pve1
vncterm: 1.8.0
zfsutils-linux: 2.2.7-pve1
```
### Virtual Machines
```
VMID NAME STATUS MEM(MB) BOOTDISK(GB) PID
100 docker-hub running 8200 100.00 1370101
104 ubuntu-dev stopped 5000 32.00 0
105 dev stopped 16000 32.00 0
106 Ansible-Control running 4096 32.00 1020188
107 ubuntu-docker stopped 4096 50.00 0
108 CML stopped 32000 100.00 0
109 web-server-01 running 2048 32.00 1124720
110 web-server-02 running 4096 32.00 1159023
111 db-server-01 running 4096 32.00 1165739
```
### Containers
```
VMID Status Lock Name
102 running nginx
103 stopped netbox
113 running n8n
```
### Storage
```
Name Type Status Total Used Available %
PBS-Backups pbs active 1009313392 245697632 712271788 24.34%
Vault zfspool active 4546625536 487890756 4058734780 10.73%
iso-share nfs active 3298592768 46755840 3251836928 1.42%
local dir active 45024148 6655444 36049140 14.78%
local-lvm lvmthin active 68988928 6898 68982029 0.01%
```
### Disk Usage
```
Filesystem Size Used Avail Use% Mounted on
udev 87G 0 87G 0% /dev
tmpfs 18G 4.7M 18G 1% /run
/dev/mapper/pve-root 43G 6.4G 35G 16% /
tmpfs 87G 46M 87G 1% /dev/shm
tmpfs 5.0M 0 5.0M 0% /run/lock
efivarfs 64K 39K 21K 66% /sys/firmware/efi/efivars
/dev/sda2 1022M 12M 1011M 2% /boot/efi
Vault 3.8T 128K 3.8T 1% /Vault
Vault/subvol-102-disk-0 2.0G 721M 1.3G 36% /Vault/subvol-102-disk-0
Vault/subvol-103-disk-0 4.0G 1.7G 2.4G 43% /Vault/subvol-103-disk-0
/dev/fuse 128M 24K 128M 1% /etc/pve
192.168.2.150:/mnt/Vauly/iso-vault 3.1T 45G 3.1T 2% /mnt/pve/iso-share
192.168.2.150:/mnt/Vauly/anytype 3.1T 0 3.1T 0% /mnt/pve/anytype
Vault/subvol-113-disk-0 20G 2.2G 18G 11% /Vault/subvol-113-disk-0
tmpfs 18G 4.0K 18G 1% /run/user/0
```
## Next Actions
1. Review any errors or skipped items above
2. Consult collection.log for detailed information
3. Manually verify sensitive information was sanitized
4. Add this export to your documentation repository
5. Create diagrams and additional documentation in respective folders
---
*Report generated 2025-12-02 20:49:58*