Skip to content

docs: update GITOPS-STUDY-GUIDE — Reloader, orphaned PVC, ArgoCD diagnostics#273

Merged
swares merged 4 commits into
mainfrom
docs/gitops-guide-updates
Jul 22, 2026
Merged

docs: update GITOPS-STUDY-GUIDE — Reloader, orphaned PVC, ArgoCD diagnostics#273
swares merged 4 commits into
mainfrom
docs/gitops-guide-updates

Conversation

@swares

@swares swares commented Jul 22, 2026

Copy link
Copy Markdown
Owner

Three targeted additions based on live debugging 2026-07-22:

  • Reloader: documents the reloader.stakater.com/auto pattern and which deployments use it
  • Orphaned PVC: adds the case where a PVC manifest exists but no pod mounts it — stays Pending forever with WaitForFirstConsumer, causing ArgoCD Progressing; fix is deleting the manifest
  • ArgoCD health diagnostic: adds the jq resource-health query and app controller log command as first steps before hard refresh

swares added 4 commits July 22, 2026 02:31
- CLAUDE.md: clarify RPi 4B / opi-zero2w-1 DNS roles
- ARCHITECTURE.md: add Reloader and Zot to services table
- HARDWARE.md: fix OPi Zero 2W #4 role (MQTT secondary broker)
- WORKFLOWS.md: note that standard workloads don't need gitops/apps/ entry
- services.md: add Reloader and Zot entries
- STANDUP.md: remove Proxmox API token ref; archive Phase 5
- LAB-DESIGN.md: add design-proposal disclaimer (Proxmox not implemented)
The PVC was never mounted by the Deployment (only config and secrets
volumes are used). It has been Pending for 3 days as local-path waits
for a consumer that never arrives, causing ArgoCD to report the app as
Progressing indefinitely.

No data loss risk: the PVC was never bound.
…CD health diagnostics

- Add Reloader section (Section 4): explains Stakater Reloader annotation and
  which deployments carry it (Authelia, Semaphore, Zot)
- Expand ArgoCD Progressing diagnostic: add jq resource-health query and
  app controller log command before the hard refresh step
- Expand PVC Pending cause: distinguish orphaned PVC (no consumer, stays
  Pending forever with WaitForFirstConsumer) from provisioner errors;
  document the fix (delete manifest, ArgoCD prune cleans it up)
@swares
swares merged commit 20a0f3a into main Jul 22, 2026
4 checks passed
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.

1 participant