{{tag>dev gitlab runner pipeline CI/CD todo}}


====== Gitlab : Débogage de pipeline CI/CD en local ======

Pour exécuter les différents tests CI/CD, Gitlab s'appuie sur les runners. Les runners exécutent les tâches décrites dans les fichiers .gitlab-ci.yml. 

Au lieu de faire des modifications incrémentales sur le code et de prier pour qu'après commit les tests s'exécutent sans erreurs, on peut manuellement un runner gitlab d'exécuter localement les tests et ainsi accélerer le processus de débogage.


===== Installation =====

Plusieurs méthodes existent. On a choisit ici de télécharger simplement le binaire:

<code bash>
# Téléchargement du binaire dans le dossier /usr/local/bin
sudo curl -L --output /usr/local/bin/gitlab-runner "https://gitlab-runner-downloads.s3.amazonaws.com/latest/binaries/gitlab-runner-linux-amd64"

# Positionnement des droits d'exécution
sudo chmod +x /usr/local/bin/gitlab-runner

</code>

Pour lancer une tâche déclarée dans le fichier .gitlab-ci.yml
<file YAML .gitlab-ci.yml>

before_script:
  - docker info


build-image:       # This job runs in the build stage, which runs first.
  stage: build
  script:
    - echo "Create Docker image"
    - docker image build -t localdev/iperf:runner .
    - echo "Docker image create succesfully."

</file>
<code bash>
# depuis le répertoire du projet
gitlab-runner exec shell build-image
</code>

===== Références =====

  * https://campfirecode.medium.com/debugging-gitlab-ci-pipelines-locally-e2699608f4df