docs: add fleet change log 2026-05-27 (ansible branch consolidation), add PRD status tracker

This commit is contained in:
2026-05-27 11:16:20 -04:00
parent 73e42cc8ab
commit e6cfa11ca6
2 changed files with 75 additions and 0 deletions

View File

@@ -0,0 +1,45 @@
# Fleet Operations Change Log
## 2026-05-27 — Ansible Pull Branch Consolidation
### Event
Fleet-wide ansible-pull-deploy repository consolidated from dual-branch (`master` + `main`) to single canonical `main` branch. All nodes updated to pull from `main`.
### Root Cause
- `master` and `main` had diverged by 3 commits
- Swarm worker host_vars (mk-33, mk-34, mk-39, mk-42) existed only on `main`
- Systemd-based G9 nodes (MK33/34/39/42) were pulling `master` — would fail on next run since `master` was stale and missing swarm configs
- README still showed decommissioned `bones.yml` and non-existent `roles/common/` structure
### Actions Taken
1. Merged `master``main` (already up-to-date, `main` was ahead)
2. Deleted `master` branch locally and on Gitea remote
3. Removed `host_vars/bones.yml` (Bones decommissioned)
4. Updated `README.md` with accurate 11-node fleet map
5. Fixed `ansible-pull.service` and `ansible-pull-fixed.service` to clone/pull `main` branch
6. Updated Artemis local repo (`/var/lib/ansible/local`) to latest `main`
7. Rolled out service fix to MK33/34/39/42 via SSH
8. Pruned stale `origin/master` refs from all 4 nodes
### Fleet State After Fix
| Node | Mechanism | Branch | Status |
|------|-----------|--------|--------|
| Artemis | cron | `main` | ✅ synced |
| MK7 | cron | `main` | ✅ already correct |
| MK33 | systemd | `main` | ✅ fixed + pruned |
| MK34 | systemd | `main` | ✅ fixed + pruned |
| MK39 | systemd | `main` | ✅ fixed + pruned |
| MK42 | systemd | `main` | ✅ fixed + pruned |
| Neo | cron | `main` | ✅ already correct |
| Cinnamint | cron | `main` | ✅ already correct |
| Mark5 | cron | `main` | ✅ already correct |
| Shield | cron | `main` | ✅ already correct |
| MK44 | powered off | — | N/A |
### Commits
- `75de374` — fix: consolidate under main branch, remove bones.yml, update README fleet map, fix service files to pull main
---
*Logged by Artemis. Next update: PRD Chunk2 completion.*

30
prd-status-tracker.md Normal file
View File

@@ -0,0 +1,30 @@
# PRD Status Tracker
## Homelab Services Stack PRD
| Chunk | Status | Commit | Notes |
|-------|--------|--------|-------|
| Chunk 1 — Purpose, Scope, Success Criteria | ✅ Complete | `73e42cc` | Merged into `homelab-services-stack-prd.md` |
| Chunk 2 — Constraints, Service Catalog, Network Architecture | 🔄 In Progress | — | Awaiting completion |
| Chunk 3 — Data & Persistence, Security Model | ⏳ Pending | — | Blocked on Chunk 2 |
| Chunk 4 — Deployment Phases, Open Questions, Appendix | ⏳ Pending | — | Blocked on Chunk 3 |
## Operational Documentation
| Document | Status | Last Updated |
|----------|--------|--------------|
| `swarm.md` | ✅ Live | 2026-05-25 |
| `01-purpose-and-scope.md` | ✅ Live | 2026-05-25 |
| `02-success-criteria.md` | ✅ Live | 2026-05-25 |
| `03-constraints.md` | ✅ Live | 2026-05-25 |
| `04-service-catalog.md` | ✅ Live | 2026-05-25 |
| `05-network-architecture.md` | ✅ Live | 2026-05-25 |
| `06-data-and-persistence.md` | ✅ Live | 2026-05-25 |
| `07-security-model.md` | ✅ Live | 2026-05-25 |
| `08-deployment-phases.md` | ✅ Live | 2026-05-25 |
| `09-open-questions.md` | ✅ Live | 2026-05-25 |
| `10-appendix.md` | ✅ Live | 2026-05-25 |
---
*Tracked by Artemis. Updated after each PRD chunk completion or operational event.*