.gitlab-ci.yml
Le fichier .gitlab-ci.yml
est un fichier au format YAML
qui est utilisé par GitLab pour définir des directive de CI/CD.
<aside>
💡 Si vous n’êtes pas famillier avec la syntaxe YAML
, vous pouvez commencer par lire cet article : YAML Tutorial: Everything You Need to Get Started in Minutes
</aside>
Commencez par cloner le repository dans lequel vous souhaitez implémenter vos pipelines, puis explorez les fichiers ; vous devriez tomber sur un Dockerfile
, des fichiers de gestion de dépendances (package.json
, yarn.lock
, requirements.txt
, etc.), des fichiers de configuration, de tests, etc.
<aside>
⚠️ Dans ce tutoriel, nous partons du postulat que les tests sont fonctionnels et les dépendances à jour ; nous nous concentrerons uniquement sur le Dockerfile
pour la suite.
</aside>
Créez ensuite le fichier .gitlab-ci.yml
à la racine de votre repository, et explorons ensemble la syntaxe minimale pour qu’une pipeline puisse marcher :
job1:
script: "echo 'I am job1'"
job2:
script: "echo 'I am job2'"
Le job sera votre point de départ dans la création de vos pipelines de CI/CD. C’est dans des jobs que vous définirez comment build, test et deploy votre code.
Chaque job doit contenir, au minimum, une directive script
: c’est dans cette dernière que vous spécifierez quelles commandes sont à exécuter. Vous pouvez également les écrire sous forme de liste :
job1:
script:
- "echo 'I am the first directive'"
- "echo 'I am the second directive'"
- "echo 'I am the third directive'"
Cependant, il est rare que vous ayez à votre disposition tous les outils nécessaires pour lancer vos commandes ; dans ce cas, plusieurs options s’offrent à vous :
before_script
,image
,services
.Explorons donc un exemple utilisant ces trois directives supplémentaires :