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 | État | Sert à 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.
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
| Compte | Usage | Mot de passe |
|---|---|---|
{{UTILISATEUR}} | Tous les ateliers | Variable APPRENANT_MOT_DE_PASSE du fichier .env |
root | Administration de GitLab, à éviter pour les ateliers | Variable 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é.
| Conteneur | Image | Rôle |
|---|---|---|
formation-site | Construite par le Dockerfile fourni (Alpine, Nginx, ttyd, Git) | Sert ce site, le terminal web et le dossier des déploiements. |
formation-gitlab | gitlab/gitlab-ce | La forge : dépôts, merge requests, pipelines. Réglée pour consommer peu de mémoire. |
formation-runner | gitlab/gitlab-runner | Exécute les jobs, chacun dans un conteneur neuf. |
formation-init | docker (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 pas | docker 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 runner | docker compose logs init. L'initialisation peut être relancée sans risque : docker compose up -d init. |
| Jobs « en attente » sans fin | docker compose logs runner, puis docker exec formation-runner gitlab-runner verify. |
| Un job ne parvient pas à télécharger son image | Le serveur doit pouvoir joindre Docker Hub. Derrière un proxy, configure-le dans le démon Docker du serveur. |
| Le terminal ne s'affiche pas | docker compose logs site. Derrière un proxy inverse, il faut laisser passer les WebSockets sur /terminal/. |
| Repartir de zéro | docker 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 :
- Git sur ton poste (
sudo apt install git,sudo dnf install gitou équivalent) ; - un compte GitLab, par exemple sur gitlab.com ;
- un runner pour les modules 5 et 6 : les runners hébergés de gitlab.com, ou le tien (la commande est donnée au module 5).
Le projet de départ de l'atelier 5 se recrée à la main : son contenu est donné dans l'atelier.