Formations — 1 037 leçons en français

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.

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.