Aller au contenu

Environnement de travail

Ce dont tu disposes ici pour faire les ateliers, comment le vérifier, et quoi faire quand quelque chose manque.

Ce qui est disponible sur cette installation

BriqueÉtatSert à partir du
Terminal avec Git Disponible : bouton Terminal du bandeau, ou dans un onglet. Non fourni ici : utilise un terminal Linux de ton poste. module 1
GitLab GitLab local : {{GITLAB}}, identifiant {{UTILISATEUR}}. Pas de GitLab local : les commandes des ateliers visent {{GITLAB}}. module 3
Runner Runner d'instance {{RUNNER}}, exécuteur Docker, enregistré automatiquement. À ta charge : runners hébergés de gitlab.com ou runner personnel (voir le module 5). module 5
Cible de déploiement Dossier partagé /deploiements, consultable sur {{DEPLOIEMENTS}}/. Non disponible : l'atelier 8 indique comment s'en passer. module 6

Vérifier en deux minutes

Le terminal

$ git --version
$ whoami
$ ls ~/ateliers
$ preparer-atelier

Dans le terminal de la formation, tu es l'utilisateur apprenant. Ton dossier personnel est conservé d'une session à l'autre et d'un redémarrage à l'autre. La dernière commande, lancée sans argument, liste les projets de départ disponibles.

Copier et coller dans le terminal web

Chaque bloc de commandes du site a un bouton Copier, qui retire les $ et les commentaires. Dans le terminal, colle avec Ctrl+Maj+V (ou le clic droit). Pour éditer un fichier : nano fichier, puis Ctrl+O et Entrée pour enregistrer, Ctrl+X pour quitter.

GitLab et le runner

Depuis le terminal de la formation, GitLab est joignable sous le nom gitlab :

$ curl -s -o /dev/null -w "%{http_code}\n" {{GITLAB_GIT}}/users/sign_in

La réponse attendue est 200. Un 502 signifie que GitLab est encore en train de démarrer : compte cinq bonnes minutes après un lancement. Connecte-toi ensuite à {{GITLAB}} ; le runner est visible, une fois un projet créé, dans Settings, CI/CD, Runners.

Tu remarqueras deux adresses pour le même GitLab : {{GITLAB}} dans ton navigateur, et {{GITLAB_GIT}} dans les commandes Git du terminal. Le terminal tourne dans un conteneur, sur le même réseau privé que GitLab, et le joint par son nom de service.

Les comptes

CompteUsageMot de passe
{{UTILISATEUR}}Tous les ateliersVariable APPRENANT_MOT_DE_PASSE du fichier .env
rootAdministration de GitLab, à éviter pour les ateliersVariable GITLAB_ROOT_MOT_DE_PASSE

Ces mots de passe sont générés à l'installation. La personne qui a installé l'environnement les trouve dans le fichier .env, à côté du docker-compose.yml.

Sans GitLab local, tu utilises ton propre compte sur le GitLab de ton choix. Tout le parcours fonctionne avec un compte gratuit.

Comment l'environnement est construit

L'environnement de formation est lui-même une petite leçon de choses : un fichier docker-compose.yml décrit jusqu'à quatre conteneurs, reliés par un réseau privé.

ConteneurImageRôle
formation-siteConstruite par le Dockerfile fourni (Alpine, Nginx, ttyd, Git)Sert ce site, le terminal web et le dossier des déploiements.
formation-gitlabgitlab/gitlab-ceLa forge : dépôts, merge requests, pipelines. Réglée pour consommer peu de mémoire.
formation-runnergitlab/gitlab-runnerExécute les jobs, chacun dans un conteneur neuf.
formation-initdocker (client seul)S'exécute une fois : crée le compte apprenant, enregistre le runner, puis s'arrête.

Les trois derniers sont facultatifs : ils ne démarrent que si le profil gitlab est activé. Sans eux, le site et le terminal suffisent pour les modules 1, 2 et 4.

Dépannage, pour la personne qui administre

Ces commandes se lancent sur le serveur, dans le dossier qui contient docker-compose.yml.

SymptômeÀ regarder
GitLab répond 502 ou ne répond pasdocker compose ps : l'état doit passer de starting à healthy. Premier démarrage : 5 à 10 minutes. S'il redémarre en boucle, la mémoire manque (4 Go libres au minimum).
Pas de compte apprenant, pas de runnerdocker compose logs init. L'initialisation peut être relancée sans risque : docker compose up -d init.
Jobs « en attente » sans findocker compose logs runner, puis docker exec formation-runner gitlab-runner verify.
Un job ne parvient pas à télécharger son imageLe serveur doit pouvoir joindre Docker Hub. Derrière un proxy, configure-le dans le démon Docker du serveur.
Le terminal ne s'affiche pasdocker compose logs site. Derrière un proxy inverse, il faut laisser passer les WebSockets sur /terminal/.
Repartir de zérodocker compose --profile gitlab down --volumes supprime tout, y compris les dépôts et le dossier personnel de l'apprenant.

Travailler sans l'image Docker

Le site est un ensemble de fichiers statiques : il se lit depuis n'importe quel serveur web, ou même directement depuis le disque. Il te faut alors :

Le projet de départ de l'atelier 5 se recrée à la main : son contenu est donné dans l'atelier.