Formations — 1 037 leçons en français

Accueil › Git & CI/CD › Promouvoir un artefact entre environnements

Promouvoir un artefact entre environnements

Livraison et déploiement continusavance

Un artefact se construit une fois et se promeut ensuite. Ce qui change d'un environnement à l'autre, c'est la configuration, pas le contenu déployé.

jobs:
  construire:
    runs-on: ubuntu-latest
    outputs:
      image: ${{ steps.p.outputs.ref }}
    steps:
      - uses: actions/checkout@v4
      - run: mvn -B package
      - id: p
        run: |
          REF="ghcr.io/equipe/api:${GITHUB_SHA}"
          docker build -t "$REF" . && docker push "$REF"
          echo "ref=$REF" >> "$GITHUB_OUTPUT"

  recette:
    needs: [construire]
    environment: recette
    runs-on: ubuntu-latest
    steps:
      - run: ./deployer.sh recette "${{ needs.construire.outputs.image }}"

L'étiquette ${GITHUB_SHA} est le point clé : elle est immuable. La recette et la production désignent alors le même objet, octet pour octet.

Pourquoi latest casse tout

10 h 00  construire → pousse ghcr.io/equipe/api:latest   (commit A)
10 h 05  recette    → tire latest                        (A, testé)
10 h 12  construire → pousse latest                      (commit B)
10 h 20  production → tire latest                        (B, jamais testé)

Rien n'a échoué, aucun message d'erreur n'apparaît, et la production reçoit un artefact que personne n'a validé. Une étiquette mobile ne peut pas servir de référence de promotion.

Ce qui change entre environnements

Les URL, les secrets, les seuils. Ils sont fournis à l'exécution, par les variables et secrets de l'environnement. S'ils sont compilés dans l'artefact, il faut un artefact par environnement — et la promotion n'existe plus.

Les termes à connaître

Construire une fois

Règle fondatrice : l'artefact est produit une seule fois, puis promu tel quel d'environnement en environnement. Reconstruire pour la production, c'est déployer autre chose que ce qui a été testé.

Promotion

Faire passer un artefact déjà construit à l'environnement suivant, sans le modifier. Ce qui change entre deux environnements est la configuration, jamais le contenu de l'artefact.

Environnement

Dans GitHub Actions, un objet nommé portant des secrets, des variables et des règles de protection. Un travail déclare environment: et hérite de ces règles.

Règle de protection

Condition attachée à un environnement : approbation d'une ou plusieurs personnes, délai d'attente, branches autorisées. Elle suspend le travail avant sa première étape.

Immuabilité de l'étiquette

Un artefact étiqueté par l'empreinte du commit ne change jamais de contenu. Une étiquette mobile comme latest casse la promotion : elle ne désigne plus le même objet d'un environnement à l'autre.

Configuration externe

URL de base de données, clés, seuils — fournis à l'exécution par variables d'environnement ou secrets. Les mettre dans l'artefact oblige à en construire un par environnement.

Lire l'explication détaillée et faire le quiz →

Cette page présente la partie essentielle de la leçon. Les exemples commentés, les pièges courants et les trois questions de quiz sont dans l'application.