Mise en place du système de déploiement et d'intégration continus

[matteyeux]

Configurer GitLab-CI pour que les tests d'intégration soient exécutés dans un conteneur Docker qui sera déployé sur le cluster Swarm.

[matteyeux]

Note : Les runners GitLab-CI pourront créer autant de conteneurs Docker que nécessaire.

[alexmjd]

https://docs.gitlab.com/runner/install/ https://dockerswarm.rocks/gitlab-ci/ https://docs.gitlab.com/ee/ci/docker/using_docker_images.html Documentations utiles pour setup les runners

[alexmjd]

• Installer le gitlab runner sur la VM Manager
  • Le runner doit être de la même version que le gitlab installé
• Après avoir installé Gitlab Runner
  • il faut enregistrer des runners individuels
  • Les runners lancent les jobs CI/CD qui viennent de gitlab
  • Ils processent les jobs sur la même machine qu'est installé Gitlab Runner
• Quand on enregistre un runner
  • On doit choisir un exécuteur qui détermine l'environnement sur lesquels chaque job tourne. C'est à dire que l'exécuteur doit contenir tout ce qui est nécessaire au bon fonctionnement du job
  • Il est possible d'utiliser une autre VM/un conteneur docker comme exécutant
  • On peut aussi avoir une configuration Docker-in-Docker (installer Gitlab Runner dans docker et utiliser des conteneurs docker pour lancer les exécuteurs
  • https://docs.gitlab.com/runner/executors/index.html

---

• Avant d'enregistrer des runners, on peut restreindre les accès à un groupe (Group runners), projet (Specific runners), ou laisser l'accès ouvert (Shared runners)
  • En enregistrant un runner, il faut spécifier un token pour l'instance de gitlab, un groupe ou un projet.
  • On peut aussi ajouter des tags pour permettre au job CI/CD de savoir quel runner utiliser

https://docs.gitlab.com/runner/register/index.html

---

Objectifs pour le gitlab runner

• La configuration du runner se fait à travers le config.toml qu'il faudra probablement écrire, ranger dans un dossier bien spécifique, puis déployer via ansible sur la machine Manager
• Le runner devra lancer des conteneurs docker (autant que nécessaire) pour pouvoir lancer les pipelines CI/CD (les conteneurs seront lancés sur la Manager)
• Pour ce qui est d'utiliser les runners pour la CI/CD, il suffit de les spécifier selon leur nom/tag dans les fichiers yml de workflow CI/CD.

[alexmjd]

L'enregistrement d'un runner gitlab se fait facilement avec la commande sudo gitlab-runner register. Pour l'hôte, ne pas hésiter à mettre l'adresse IP si un problème avec l'adresse DNS survient.

Une fois la registration faite, vous pouvez trouver le fichier config.tomlsous /etc/gitlab-runner https://docs.gitlab.com/runner/configuration/advanced-configuration.html