Accueil › Git & CI/CD › Artefact ou cache
Artefact ou cache
Artefacts, cache et duréeavance
Deux objets circulent dans une chaîne d'intégration, et on les confond constamment.
Un artefact est produit parce que quelqu'un en a besoin ensuite : un autre travail, un déploiement, un humain qui enquête sur un échec. Un cache est une copie gardée pour aller plus vite. La différence tient en une phrase :
Effacez tous les caches : la chaîne passe, plus lentement. Effacez les artefacts : quelque chose casse.
# GitHub Actions — le cache : accélère, jetable
- uses: actions/cache@v4
with:
path: ~/.npm
key: npm-${{ hashFiles('package-lock.json') }}
# L'artefact : produit une fois, consommé ensuite
- uses: actions/upload-artifact@v4
with:
name: application
path: dist/
Construire une fois, promouvoir ensuite
Le travail build produit le jar ou le dossier dist. Les travaux suivants le
téléchargent, ils ne le reconstruisent pas.
deploiement:
needs: build
steps:
- uses: actions/download-artifact@v4
with: { name: application }
Reconstruire pour la préproduction puis pour la production, c'est déployer un fichier que personne n'a testé. Deux constructions du même commit peuvent différer : une dépendance résolue plus haut, un horodatage, un outil mis à jour sur l'agent. Ce qui change entre les environnements est la configuration, jamais le contenu de l'artefact.
Rétention
Un artefact a une durée de vie. Sur GitHub Actions elle se règle par
retention-days ; au-delà, le fichier disparaît. Un artefact que l'on doit
encore avoir dans six mois n'a rien à faire là : il va dans un registre de
paquets ou d'images.
Les termes à connaître
- Artefact
Un fichier produit par la chaîne et conservé volontairement parce que quelqu'un en a besoin ensuite : un autre travail, un déploiement, un humain qui enquête. Sa disparition change le résultat.
- Cache
Une copie de fichiers que l'on garde pour aller plus vite la prochaine fois. Sa disparition ne change que la durée : la chaîne doit rester correcte sans lui.
- Construire une fois
Produire le binaire ou le paquet une seule fois, puis faire circuler ce même fichier dans tous les environnements. Reconstruire par environnement, c'est tester autre chose que ce qu'on déploie.
- Promotion
Faire passer un artefact déjà construit d'un environnement au suivant sans le reconstruire. Ce qui change est la configuration, jamais le contenu du fichier.
- Rétention
La durée pendant laquelle la forge conserve un artefact avant de le supprimer. Elle se configure, elle se paie, et elle finit toujours par expirer.
- Reproductibilité
La propriété d'une construction qui, à entrée identique, produit une sortie identique. Sans elle, « reconstruire à l'identique » est une illusion confortable.
- Immuabilité
Un artefact publié ne se modifie jamais. On en publie un nouveau, avec une autre version. Écraser une version déjà distribuée est la panne la plus difficile à diagnostiquer.
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.