Skip to content

doc(gitlab): document the zone infra repository lifecycle #127

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
shikanime wants to merge 1 commit into
base: main
Choose a base branch
from
Open

doc(gitlab): document the zone infra repository lifecycle #127

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 2 additions & 0 deletions docs/services/gitlab.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -92,6 +92,8 @@ qui le distingue des dépôts créés manuellement :
lors de la réconciliation. On y trouve :
- le dépôt `mirror` : pilote la synchronisation des dépôts externes ;
- le dépôt `infra-apps` : dépôt d'infrastructure du projet ;
- le dépôt `infra` de chaque zone : provisionné à la création de la zone et

@StephaneTrebel StephaneTrebel Oct 21, 2026

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🟠 important (documentation): Distinguer le groupe infra du dépôt portant le slug de zone

L’ajout présente un dépôt littéralement nommé infra parmi les dépôts du groupe projet, alors que infra est le groupe et que le dépôt s’appelle <zoneSlug> : son chemin est <PROJECTS_ROOT_DIR>/infra/<zoneSlug>, hors de <NOM_ORGANISATION>/<NOM_PROJET>. Il est réconcilié par zone.upsert et supprimé par zone.delete, pas par le reprovisionnement du projet décrit dans cette section. Un administrateur cherchant les manifests à partir de ce texte est donc orienté vers le mauvais nom et le mauvais périmètre.

Ajout concerné :

+  - le dépôt `infra` de chaque zone : provisionné à la création de la zone et
+    supprimé avec elle, il porte les manifests Argo CD de la zone ;

Sources Console vérifiées à 17e109e2 : constante du groupe, construction du chemin et consommateurs zone. Le test existant du client attend également path_with_namespace: 'forge/infra/zone-1' et name: zoneSlug.

Présenter explicitement le dépôt d’infrastructure de zone avec son chemin réel, dans un paragraphe distinct des dépôts techniques du projet, en conservant le cycle de vie documenté. Cela répond au suivi Console #2864 sans attribuer sa gestion au reprovisionnement projet.

supprimé avec elle, il porte les manifests Argo CD de la zone ;
- les dépôts techniques associés aux plugins activés (par exemple le dépôt
d'observabilité).

Expand Down
Loading