Skip to main content
Ce document rassemble les conventions de nommage, l’arborescence des fichiers et le format des messages de commit dans le dépôt argo-production. Il sert de référence pour nommer les applications, organiser les fichiers et rédiger des commits cohérents.

​
Arborescence (13.1)

Les fichiers d’application et de valeurs suivent une structure hiérarchique basée sur le produit, le client et l’environnement.
Arborescence
Trois formes de nommage coexistent dans le dépôt. Adoptez la première :

​
Nom des Applications (13.2)

Deux ordres de segments existent pour le nom d’une Application ArgoCD. Retenez celui qui trie correctement et se lit comme le nom de fichier :
Exemple : biolab-api-prod, sema-odoo-gateway-stg.
Le nom d’une Application est le préfixe de toutes ses ressources Kubernetes. Il n’est pas librement modifiable. Pour les contraintes liées au renommage, consultez la page Renommage.

​
Un fichier, une application (13.3)

24 fichiers contiennent plusieurs Applications ArgoCD séparées par ---. Cette pratique est tolérée pour des composants indissociables (par exemple un backend et son worker déployés ensemble), mais la règle reste : un fichier par application.

​
Coquilles gelées (13.4)

Certains chemins et labels contiennent des fautes de frappe historiques. Elles doivent être conservées telles quelles pour ne pas casser les déploiements existants.
Les corrections sont souhaitables, mais elles doivent être réalisées dans des commits dédiés, application par application, avec une fenêtre de coupure planifiée.

​
Messages de commit (13.5)

Le format attendu est :
Exemples de commits conformes :
  • biolab: ajoute WHATSAPP_BOT_NUMBER (stg)
  • airflow: fixe le broker-url en secret statique (prod)
  • sema: retire l'app odoo, garde sema-odoo-gateway
L’historique contient majoritairement des messages génériques du type update. La nouvelle convention ci-dessus est à généraliser progressivement.