Skip to content

v0.9.0 — Documentation

Latest

Choose a tag to compare

@mcansem mcansem released this 21 Jul 01:23

Ninth release of the infra repository: Documentation. The last two v0.1.0 stubs, plus the roadmap's remaining items - architecture diagrams, operational runbooks, onboarding documentation.

Added

  • docs/architecture.md - real content replacing the v0.1.0 stub: three Mermaid diagrams (component/data-flow, externally-reachable network topology matching scripts/harden-host.sh's role_ports(), CI/CD sequence matching vars/standardDeployPipeline.groovy's stage order), rendered natively by GitHub
  • docs/recovery.md - real content replacing the v0.1.0 stub: the authoritative host-lost runbook, consolidating what was scattered across backup.md/restore.md/platforms/homelab.md, plus explicit RPO (~24h, tied to the daily backup cadence) and RTO (an honest estimate - under two hours - explicitly caveated as untested, not a real SLA)
  • docs/runbooks.md - one playbook per Prometheus alert (HostDown, DiskSpaceLow, ContainerMissing): what it means, likely causes, concrete investigate/fix commands
  • docs/onboarding.md - how a new application repo starts using this infrastructure: Jenkinsfile shape, image/port expectations, what to do if it doesn't fit the existing docker/app/ service shape, new-subdomain certificate bootstrap

Changed

  • docs/project-specification.md's Documentation section gains runbooks.md, onboarding.md

What's next

v1.0.0 - Production Ready Stable Release. Final stabilization pass - the last phase on the current roadmap.

Full changelog: CHANGELOG.md