Skip to content

Deployment Documentation Index

Start here

This set is written to be deployment-agnostic with parameter placeholders, while preserving implementation evidence from:

  • hello-world-main/, the source repository is here.
  • helm-hello-world-main/, the source repository is here.
Gitlab Link
Harbor Link
ArgoCD Link

Parameter-first reading

Read 00-overview.md first to align on:

  • ENTITY_NAMESPACE (example: france-titres)
  • APP_SLUG
  • REGISTRY_HOST
  • K8S_NAMESPACE
  • RELEASE_NAME

Document order

  1. 00-overview.md - architecture and parameter model
  2. 01-build-and-image-publish.md - Docker build/tag/push model
  3. 02-gitlab-cicd-pipeline.md - pipeline stages/jobs/rules/promotion
  4. 03-docker-compose-local-and-ci-usage.md - local runtime vs CI behavior
  5. 04-helm-chart-deployment.md - chart behavior and install/upgrade
  6. 05-virtualservice-routing.md - namespace-aware routing deep dive
  7. 06-end-to-end-deployment-runbook.md - operational runbook and rollback

Notes on evidence

Each major claim references real files. When behavior is missing from implementation, assumptions are explicitly marked.