Skip to content

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

Open
shikanime wants to merge 1 commit into
mainfrom
doc/zone-infra-repo
Open

shikanime wants to merge 1 commit into
mainfrom
doc/zone-infra-repo

Conversation

@shikanime

Copy link
Copy Markdown
Member

Why

Console#2807 porte le pont zone GitLab vers server-nestjs : chaque zone reçoit un dépôt infra system-managed, supprimé avec la zone. La liste des dépôts gérés n'en parle pas — le critère documentation de Console#2864 reste décoché.

What

  • docs/services/gitlab.md, liste « Dépôts techniques » : ajoute le dépôt infra de zone avec son cycle de vie (provisionné à la création, supprimé avec la zone, manifests Argo CD).

References

  • Console#2864 (critère documentation)
  • Console#2807 (pont zone)

The zone bridge provisions a system-managed infra repository per zone; the managed-repositories list omitted it, so a reader could not tell zone repos apart from orphaned manual ones.

Refs #2864

Co-authored-by: Automata <automata@shikanime.studio>
Signed-off-by: William Phetsinorath <william.phetsinorath-open@interieur.gouv.fr>
Change-Id: I7666f0678250413ff26db570d57de5db6a6a6964

@StephaneTrebel StephaneTrebel left a comment

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.

Le cycle création/suppression de zone correspond bien au pont Console #2807 désormais fusionné, mais l’ajout confond le groupe infra avec le nom du dépôt et l’insère dans un périmètre de réconciliation projet qui ne le gère pas : correction demandée inline. Le Markdown, les liens locaux de la page et le contrôle CI Test app build sont valides ; aucun build applicatif local n’a été exécuté. Sans ledger direct dans ce dépôt ; le suivi Console #2864 existe et n’a pas été modifié par cette revue.

Comment thread docs/services/gitlab.md
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

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.

@shikanime shikanime linked an issue Oct 21, 2026 that may be closed by this pull request
3 tasks done
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.

💡 [REQUEST] - Porter le pont zone GitLab vers server-nestjs

2 participants