doc-locale/fr-fr/ci/quick_start/_index.md
{{< details >}}
{{< /details >}}
Ce tutoriel vous montre comment configurer et exécuter votre premier pipeline CI/CD dans GitLab.
Si vous connaissez déjà les concepts de base du CI/CD, vous pouvez vous familiariser avec les mots-clés courants dans Tutoriel : Créer un pipeline complexe.
Avant de commencer, assurez-vous de disposer des éléments suivants :
Si vous n'avez pas de projet, vous pouvez créer un projet public gratuitement sur https://gitlab.com.
Pour créer et exécuter votre premier pipeline :
Vérifiez que vous disposez de runners pour exécuter vos jobs.
Si vous utilisez GitLab.com, vous pouvez ignorer cette étape. GitLab.com met à votre disposition des runners d'instance.
Créez un fichier .gitlab-ci.yml à la racine de votre dépôt. Ce fichier est l'endroit où vous définissez les jobs CI/CD.
Lorsque vous commitez le fichier dans votre dépôt, le runner exécute vos jobs. Les résultats des jobs sont affichés dans un pipeline.
Dans GitLab, les runners sont des agents qui exécutent vos jobs CI/CD.
Si vous utilisez GitLab.com, vous pouvez ignorer cette étape. GitLab.com met à votre disposition des runners d'instance.
Pour afficher les runners disponibles :
Tant que vous disposez d'au moins un runner actif, avec un cercle vert à côté de lui, vous avez un runner disponible pour traiter vos jobs.
Si vous n'avez pas accès à ces paramètres, contactez votre administrateur GitLab.
Si vous ne disposez pas d'un runner :
shell.Lorsque vos jobs CI/CD s'exécutent, lors d'une étape ultérieure, ils s'exécuteront sur votre machine locale.
.gitlab-ci.yml {#create-a-gitlab-ciyml-file}Créez maintenant un fichier .gitlab-ci.yml. Il s'agit d'un fichier YAML dans lequel vous spécifiez des instructions pour GitLab CI/CD.
Dans ce fichier, vous définissez :
Pour créer un fichier .gitlab-ci.yml dans votre projet :
Dans la barre supérieure, sélectionnez Rechercher ou aller à et trouvez votre projet.
Dans la barre latérale gauche, sélectionnez Code > Dépôt.
Au-dessus de la liste de fichiers, sélectionnez la branche vers laquelle vous souhaitez commiter. Si vous n'êtes pas sûr(e), conservez master ou main. Ensuite, dans le coin supérieur droit, sélectionnez l'icône plus ({{< icon name="plus" >}}) et Nouveau fichier :
Pour le Nom du fichier, saisissez .gitlab-ci.yml et dans la zone de texte plus grande, collez cet exemple de code :
build-job:
stage: build
script:
- echo "Hello, $GITLAB_USER_LOGIN!"
test-job1:
stage: test
script:
- echo "This job tests something"
test-job2:
stage: test
script:
- echo "This job tests something, but takes more time than test-job1."
- echo "After the echo commands complete, it runs the sleep command for 20 seconds"
- echo "which simulates a test that runs 20 seconds longer than test-job1"
- sleep 20
deploy-prod:
stage: deploy
script:
- echo "This job deploys something from the $CI_COMMIT_BRANCH branch."
environment: production
Cet exemple montre quatre jobs : build-job, test-job1, test-job2 et deploy-prod. Les commentaires figurant dans les commandes echo s'affichent dans l'interface lorsque vous consultez les jobs. Les valeurs des variables prédéfinies $GITLAB_USER_LOGIN et $CI_COMMIT_BRANCH sont renseignées lors de l'exécution des jobs.
Sélectionnez Valider les modifications.
Le pipeline démarre et exécute les jobs que vous avez définis dans le fichier .gitlab-ci.yml.
Examinez maintenant votre pipeline et les jobs qu'il contient.
Accédez à Version > Pipelines. Un pipeline avec trois étapes devrait s'afficher :
Affichez une représentation visuelle de votre pipeline en sélectionnant l'ID du pipeline (#676 dans cet exemple) :
Affichez les détails d'un job en sélectionnant le nom du job. Par exemple, deploy-prod :
Vous avez créé avec succès votre premier pipeline CI/CD dans GitLab. Félicitations !
Vous pouvez maintenant commencer à personnaliser votre fichier .gitlab-ci.yml et à définir des jobs plus avancés.
.gitlab-ci.yml {#gitlab-ciyml-tips}Voici quelques conseils pour commencer à travailler avec le fichier .gitlab-ci.yml.
Pour la syntaxe complète de .gitlab-ci.yml, consultez la référence complète de la syntaxe YAML CI/CD.
.gitlab-ci.yml.stage décrit l'exécution séquentielle des jobs. Si des runners sont disponibles, les jobs d'une même étape s'exécutent en parallèle.needs pour exécuter des jobs hors de l'ordre des étapes, afin d'augmenter la vitesse et l'efficacité du pipeline.rules pour spécifier quand exécuter ou ignorer des jobs. Les mots-clés hérités only et except sont toujours pris en charge, mais ne peuvent pas être utilisés avec rules dans le même job.cache et artifacts. Ces mots-clés permettent de stocker les dépendances et la sortie des jobs, même lors de l'utilisation de runners éphémères pour chaque job.default pour spécifier des configurations supplémentaires appliquées à tous les jobs. Ce mot-clé est souvent utilisé pour définir les sections before_script et after_script qui doivent s'exécuter sur chaque job.Migrer depuis :