Aller au contenu principal
pipelinebrut.fr — CI/CD · automatisation · terrain
CI/CD

Promouvoir les artefacts plutôt que les reconstruire : le chaînon manquant des déploiements fiables

Pourquoi reconstruire à chaque environnement fragilise les livraisons, et comment promouvoir un artefact immuable de la CI à la production.

Par Julien Mercier 7 min de lecture
Promouvoir les artefacts plutôt que les reconstruire : le chaînon manquant des déploiements fiables

Construisez l’artefact une seule fois, testez-le en staging, puis déployez exactement ce même artefact en production. Une promotion fiable s’appuie sur une identité immuable, un registre ou un gestionnaire d’artefacts, et une étape distincte de la compilation.

Reconstruire pour la production crée une nouvelle livraison, même avec le même commit Git et le même numéro de version. Des dépendances récupérées à une autre date, une image de base modifiée ou un outil de build différent peuvent produire un objet différent.

Identifier l’artefact à promouvoir

Promouvez le résultat figé de la CI : image OCI, paquet, archive, binaire ou chart Helm. Une version lisible reste utile, mais elle ne suffit pas à identifier l’objet exact déployé.

Pour une image de conteneur, utilisez le digest du manifeste, tel que sha256:…. Un tag comme v1.8.2 peut être déplacé, tandis qu’un digest désigne un contenu précis, comme l’explique la documentation sur les digests de Docker.

  • Version applicative : pour communiquer sur la livraison.
  • Digest ou checksum : l’identité technique à déployer.
  • Commit Git : la source associée.
  • ID et URL du pipeline : le contexte de construction et de validation.
  • Provenance disponible : date, dépendances et outils de build.

Conservez ces données dans les métadonnées du dépôt d’artefacts, les labels d’image ou une attestation. Les attestations prises en charge par GitHub Actions relient un artefact à son processus de construction ; elles ne lui attribuent pas une confiance implicite.

Les builds reproductibles réduisent les écarts, mais ne remplacent pas la promotion d’un objet déjà validé. Les horodatages, dépendances externes et environnements de compilation compliquent cette garantie de bout en bout, objectif documenté par Reproducible Builds.

Organiser la promotion

La CI construit l’artefact, le pousse dans le registre, exécute les tests et publie son digest pour les étapes suivantes. Les déploiements de staging et de production ne compilent plus.

  • Build : produire l’artefact et enregistrer son digest, son commit et les métadonnées utiles.
  • Staging : déployer ce digest et exécuter les contrôles nécessaires.
  • Promotion : approuver ou automatiser le passage de ce même digest vers la production.
  • Production : déployer le digest validé et conserver le lien vers le pipeline initial.

Dans un registre OCI, un tag de promotion comme production peut être ajouté au manifeste existant. Configurez toutefois le déploiement pour tirer le digest, et non ce tag.

Pour un binaire ou une archive, copiez ou référencez l’objet validé vers le dépôt de production sans relancer la compilation. Vérifiez que l’opération conserve le checksum et les métadonnées : un objet réemballé n’est pas nécessairement le même artefact.

Séparer configuration, migrations et rollback

L’artefact contient le code ; les URL, secrets, identifiants et limites de ressources restent propres à chaque environnement. Ne reconstruisez pas pour modifier une URL de base ou une clé d’API.

Injectez cette configuration au déploiement avec le mécanisme adapté à votre environnement : variables du runner, fichiers gérés hors du dépôt d’artefacts ou coffre de secrets. Des identités de courte durée peuvent compléter cette approche, dans l’esprit d’un usage OIDC en CI/CD.

Les migrations de base de données doivent être exécutées explicitement, même si leur code voyage avec l’artefact. Rendez-les idempotentes lorsque c’est possible et maintenez leur compatibilité avec la version précédente pendant le déploiement.

Un rollback applicatif ne restaure pas automatiquement le schéma de données. Préférez le modèle « expand/contract » : ajoutez d’abord des structures compatibles, basculez l’application, puis supprimez les anciens éléments dans une livraison ultérieure.

Pour revenir en arrière, redéployez un digest précédemment validé plutôt que de reconstruire une ancienne branche. Conservez la correspondance entre environnement, digest et résultat du déploiement ; elle permet de retrouver l’objet réellement exécuté et d’appuyer les décisions de rollback.