GitLab CI/CD: Difference between revisions
Jump to navigation
Jump to search
Zoran.Chanet (talk | contribs) (Created page with "= Prérequis = * version Gitlab >= 8.0 ou utiliser GitLab.com * <code>Settings -> General -> Permissions -> Pipelines</code> (''Only team members'' ou ''Everyone with access''...") |
Zoran.Chanet (talk | contribs) No edit summary |
||
Line 1: | Line 1: | ||
= Prérequis = |
= Prérequis = |
||
* |
* Version Gitlab >= 8.0 ou utiliser GitLab.com |
||
* <code>Settings -> General -> Permissions -> Pipelines</code> (''Only team members'' ou ''Everyone with access'') |
* <code>Settings -> General -> Permissions -> Pipelines</code> (''Only team members'' ou ''Everyone with access'') |
||
* Au moins un runner configuré pour le projet (ou shared runner) (voir <code>Settings -> CI/CD -> Runners</code>) (''Enable shared runners on this project'' pour avoir accès aux shared runners) |
* Au moins un runner configuré pour le projet (ou shared runner) (voir <code>Settings -> CI/CD -> Runners</code>) (''Enable shared runners on this project'' pour avoir accès aux shared runners) |
||
Line 16: | Line 16: | ||
= Astuces = |
= Astuces = |
||
* <code>.gitlab-ci.yml</code> est dépendant de la version (donc branche) |
* <code>.gitlab-ci.yml</code> est dépendant de la version (donc branche) |
||
* |
* Format du fichier <code>.gitlab-ci.yml</code> : |
||
stages: |
stages: |
||
- <étape> |
- <étape> |
||
Line 45: | Line 45: | ||
* <span style="color:red">/!\</span> <code>script</code> est un mot-clé obligatoire pour chaque job |
* <span style="color:red">/!\</span> <code>script</code> est un mot-clé obligatoire pour chaque job |
||
* <code>before_script</code> est optionnel et exécuté avant chaque <code>script</code> |
* <code>before_script</code> est optionnel et exécuté avant chaque <code>script</code> |
||
* |
* Les balises <code>stages</code> et <code>stage</code> sont optionnelles mais structurent le pipeline |
||
* <code>CI/CD -> Pipelines -> CI LINT</code> (bouton) permet de tester la validité du fichier <code>.gitlab-ci.yml</code> |
* <code>CI/CD -> Pipelines -> CI LINT</code> (bouton) permet de tester la validité du fichier <code>.gitlab-ci.yml</code> |
||
* ''stuck'' signifie qu’aucun runner n’est configuré pour prendre en charge le job |
* ''stuck'' signifie qu’aucun runner n’est configuré pour prendre en charge le job |
||
* |
* Examples de <code>.gitlab_ci.yml</code> : [https://gricad-gitlab.univ-grenoble-alpes.fr/help/ci/examples/README.md https://gricad-gitlab.univ-grenoble-alpes.fr/help/ci/examples/README.md] |
||
Revision as of 08:40, 7 February 2019
Prérequis
- Version Gitlab >= 8.0 ou utiliser GitLab.com
Settings -> General -> Permissions -> Pipelines
(Only team members ou Everyone with access)- Au moins un runner configuré pour le projet (ou shared runner) (voir
Settings -> CI/CD -> Runners
) (Enable shared runners on this project pour avoir accès aux shared runners)
Activation
Définir un fichier .gitlab-ci.yml
valide à la racine du projet
Runners
- Sont des VM isolées
- Peuvent être shared entre les projets
- Idéalement sur une autre machine que le projet GitLab
- Configurés par le fichier
.gitlab-ci.yml
pour définir des étapes (build, test, deploy…) Settings -> CI/CD -> Runners
(pour voir lesquels sont assignés au projet)
Astuces
.gitlab-ci.yml
est dépendant de la version (donc branche)- Format du fichier
.gitlab-ci.yml
:
stages: - <étape> - <étape> - ... before_script: - <commande> - <commande> - … <job1-name>: stage: <étape> script: - <commande> - <commande> - … <job2-name>: stage: <étape> script: - <commande> - <commande> - … …
- /!\ Les espaces doivent rester des espaces (pas des tabulations)
- /!\
script
est un mot-clé obligatoire pour chaque job before_script
est optionnel et exécuté avant chaquescript
- Les balises
stages
etstage
sont optionnelles mais structurent le pipeline CI/CD -> Pipelines -> CI LINT
(bouton) permet de tester la validité du fichier.gitlab-ci.yml
- stuck signifie qu’aucun runner n’est configuré pour prendre en charge le job
- Examples de
.gitlab_ci.yml
: https://gricad-gitlab.univ-grenoble-alpes.fr/help/ci/examples/README.md
Fonctionnement
- Activation du pipeline à chaque push sur une branche disposant du fichier
.gitlab-ci.yml
- Au lancement, chaque job est réalisé par un runner dans son propre environnement