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
latestcasse 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.
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.