Différences
Ci-dessous, les différences entre deux révisions de la page.
Les deux révisions précédentes Révision précédente Prochaine révision | Révision précédente Dernière révision Les deux révisions suivantes | ||
tutoriel:comment_installer_gitlab-ce_avec_docker_pour_son_poste_de_travail [Le 29/08/2021, 16:04] sefran Ajouts de tags |
tutoriel:comment_installer_gitlab-ce_avec_docker_pour_son_poste_de_travail [Le 01/10/2021, 23:13] sefran Ajout lien vers configuration plus possée du transport de courriels |
||
---|---|---|---|
Ligne 86: | Ligne 86: | ||
</code> | </code> | ||
+ | {{ :tutoriel:comment_installer_gitlab-ce_sur_son_poste_de_travail:postfix_01.png?nolink |}} | ||
+ | {{ :tutoriel:comment_installer_gitlab-ce_sur_son_poste_de_travail:postfix_02.png?nolink |}} | ||
+ | {{ :tutoriel:comment_installer_gitlab-ce_sur_son_poste_de_travail:postfix_03.png?nolink |}} | ||
+ | Pour aller plus loin avec le transport de courriels [[:installer_postfix_en_local_pour_un_poste_de_travail|Installer Postfix en local pour un poste de travail]] | ||
==== Autorisez le compte utilisateur à utiliser docker ==== | ==== Autorisez le compte utilisateur à utiliser docker ==== | ||
<code bash> | <code bash> | ||
Ligne 97: | Ligne 101: | ||
</code> | </code> | ||
- | Vérifiez le bon fonctionnement du service docker à l'aide de la commande «systemctl» ci-dessous. | + | Vérifiez le bon fonctionnement du service docker à l'aide de la commande **systemctl** ci-dessous. |
<code bash> | <code bash> | ||
utilisateur@MachineUbuntu:~$ systemctl status docker | utilisateur@MachineUbuntu:~$ systemctl status docker | ||
Ligne 130: | Ligne 134: | ||
</code> | </code> | ||
- | Éditer **/etc/bind/named.conf.options** pour ajouter l’interface de docker | + | Éditer **/etc/bind/named.conf.options** pour ajouter l’interface de docker à l'écoute du serveur DNS |
<file> | <file> | ||
options { | options { | ||
Ligne 212: | Ligne 216: | ||
Téléchargez le paquet d’installation GitLab pour Ubuntu et l’installer | Téléchargez le paquet d’installation GitLab pour Ubuntu et l’installer | ||
- | Installation longue (prévoir une image VM ou USB ?) | + | |
https://packages.gitlab.com/gitlab/gitlab-ce et choisissez la dernière version gitlab-ce pour ubuntu focal | https://packages.gitlab.com/gitlab/gitlab-ce et choisissez la dernière version gitlab-ce pour ubuntu focal | ||
+ | |||
<code bash> | <code bash> | ||
utilisateur@MachineUbuntu:~/gitlab$ wget https://packages.gitlab.com/gitlab/gitlab-ce/packages/ubuntu/focal/gitlab-ce_14.1.3-ce.0_amd64.deb/download.deb | utilisateur@MachineUbuntu:~/gitlab$ wget https://packages.gitlab.com/gitlab/gitlab-ce/packages/ubuntu/focal/gitlab-ce_14.1.3-ce.0_amd64.deb/download.deb | ||
- | utilisateur@MachineUbuntu:~/gitlab$ sudo apt update ; sudo EXTERNAL_URL="http://gitlab.domaine-perso.fr" dpkg -i download.deb | + | utilisateur@MachineUbuntu:~/gitlab$ sudo apt install git ; sudo EXTERNAL_URL="http://gitlab.domaine-perso.fr" dpkg -i download.deb |
Paramétrer GitLab | Paramétrer GitLab | ||
</code> | </code> | ||
Ligne 252: | Ligne 258: | ||
Saisissez dans un navigateur l’URL **gitlab.domaine-perso.fr** | Saisissez dans un navigateur l’URL **gitlab.domaine-perso.fr** | ||
+ | {{ :tutoriel:comment_installer_gitlab-ce_sur_son_poste_de_travail:conf-gitlab_02.png?nolink |}} | ||
+ | {{ :tutoriel:comment_installer_gitlab-ce_sur_son_poste_de_travail:conf-gitlab_01.png?nolink |}} | ||
+ | |||
+ | Pour changer de mot de passe de root en cas de besoins. | ||
<code bash> | <code bash> | ||
utilisateur@MachineUbuntu:~/gitlab$ sudo gitlab-rake "gitlab:password:reset" | utilisateur@MachineUbuntu:~/gitlab$ sudo gitlab-rake "gitlab:password:reset" | ||
</code> | </code> | ||
+ | {{ :tutoriel:comment_installer_gitlab-ce_sur_son_poste_de_travail:conf-gitlab_03.png?nolink |}} | ||
+ | Choisissez **Preferences** | ||
+ | {{ :tutoriel:comment_installer_gitlab-ce_sur_son_poste_de_travail:conf-gitlab_04.png?nolink |}} | ||
- | Tapez la touche F5 pour rafraîchir l’affichage de votre navigateur. | + | Changez la localisation et le jour de début de semaine |
+ | {{ :tutoriel:comment_installer_gitlab-ce_sur_son_poste_de_travail:conf-gitlab_05.png?nolink |}} | ||
+ | Tapez la **touche F5** pour rafraîchir l’affichage de votre navigateur. | ||
+ | {{ :tutoriel:comment_installer_gitlab-ce_sur_son_poste_de_travail:conf-gitlab_06.png?nolink |}} | ||
+ | Changez l'icone du site Gitlab, renseignez le statut de l'administrateur du site, la zone de temps pour votre localité, le nom du compte administrateur, etc. | ||
+ | {{ :tutoriel:comment_installer_gitlab-ce_sur_son_poste_de_travail:conf-gitlab_07.png?nolink |}} | ||
+ | |||
+ | Dans le menu à gauche cliquer sur **Compte**. Puis modifiez le nom de connexion de l'administrateur. | ||
+ | |||
+ | {{ :tutoriel:comment_installer_gitlab-ce_sur_son_poste_de_travail:conf-gitlab_08.png?nolink |}} | ||
+ | |||
+ | Allez dans le menu d'administration de Gitlab | ||
+ | |||
+ | {{ :tutoriel:comment_installer_gitlab-ce_sur_son_poste_de_travail:conf-gitlab_09.png?nolink |}} | ||
+ | |||
+ | Choisissez dans l'arbre du menu de gauche **Paramètres/Général** | ||
+ | |||
+ | {{ :tutoriel:comment_installer_gitlab-ce_sur_son_poste_de_travail:conf-gitlab_10.png?nolink |}} | ||
+ | |||
+ | Modifiez dans **Contrôles de visibilité et d'accès** les protections que vous volez pour vos dépôts [[:git|Git]] | ||
+ | |||
+ | {{ :tutoriel:comment_installer_gitlab-ce_sur_son_poste_de_travail:conf-gitlab_11.png?nolink |}} | ||
===== Intégrer le dépot git local dans Gitlab ===== | ===== Intégrer le dépot git local dans Gitlab ===== | ||
Ligne 270: | Ligne 304: | ||
utilisateur@MachineUbuntu:~/$ cd repertoire_de_developpement | utilisateur@MachineUbuntu:~/$ cd repertoire_de_developpement | ||
utilisateur@MachineUbuntu:~/repertoire_de_developpement$ git config credential.helper store | utilisateur@MachineUbuntu:~/repertoire_de_developpement$ git config credential.helper store | ||
- | utilisateur@MachineUbuntu:~/repertoire_de_developpement$ git remote add origin http://gitlab.domaine-perso.fr/utilisateur/initiation_developpement_python_pour_administrateur.git | + | utilisateur@MachineUbuntu:~/repertoire_de_developpement$ git remote add origin http://gitlab.domaine-perso.fr/utilisateur/mon_projet.git |
utilisateur@MachineUbuntu:~/repertoire_de_developpement$ git push -u origin --all | utilisateur@MachineUbuntu:~/repertoire_de_developpement$ git push -u origin --all | ||
Username for 'http://gitlab.domaine-perso.fr': utilisateur | Username for 'http://gitlab.domaine-perso.fr': utilisateur | ||
Ligne 280: | Ligne 314: | ||
Écriture des objets: 100% (51/51), 180.78 Kio | 4.89 Mio/s, fait. | Écriture des objets: 100% (51/51), 180.78 Kio | 4.89 Mio/s, fait. | ||
Total 51 (delta 3), réutilisés 0 (delta 0), réutilisés du pack 0 | Total 51 (delta 3), réutilisés 0 (delta 0), réutilisés du pack 0 | ||
- | To http://gitlab.domaine-perso.fr/utilisateur/initiation_developpement_python_pour_administrateur.git | + | To http://gitlab.domaine-perso.fr/utilisateur/mon_projet.git |
* [new branch] master → master | * [new branch] master → master | ||
La branche 'master' est paramétrée pour suivre la branche distante 'master' depuis 'origin'. | La branche 'master' est paramétrée pour suivre la branche distante 'master' depuis 'origin'. | ||
</code> | </code> | ||
+ | {{ :tutoriel:comment_installer_gitlab-ce_sur_son_poste_de_travail:git_01.png?nolink |}} | ||
+ | {{ :tutoriel:comment_installer_gitlab-ce_sur_son_poste_de_travail:git_02.png?nolink |}} | ||
+ | ===== Configurez votre projet Gitlab ===== | ||
+ | ==== Paramétrages ==== | ||
+ | Modifiez les propriétés de votre projet dans **Paramètres/Général** | ||
- | Vous pouvez maintenant récupérer les nouveaux fichiers d’information Gitlab (CHANGELOG, CONTRIBUTING.md, LICENSE et README.md) dans votre projet local : | + | {{ :tutoriel:comment_installer_gitlab-ce_sur_son_poste_de_travail:git_03.png?nolink |}} |
+ | |||
+ | Vous pouvez voir les fichiers de votre projet dans GitLab | ||
+ | |||
+ | {{ :tutoriel:comment_installer_gitlab-ce_sur_son_poste_de_travail:git_04.png?nolink |}} | ||
+ | |||
+ | ==== Modifiez le dépôt ==== | ||
+ | |||
+ | Ajouter à partir de GitLab de nouveaux fichiers | ||
+ | |||
+ | {{ :tutoriel:comment_installer_gitlab-ce_sur_son_poste_de_travail:git_05.png?nolink |}} | ||
+ | |||
+ | Vous pouvez maintenant récupérer ces nouveaux fichiers d’information Gitlab (CHANGELOG, CONTRIBUTING.md, LICENSE et README.md) dans votre projet local : | ||
<code bash> | <code bash> | ||
utilisateur@MachineUbuntu:~/repertoire_de_developpement$ git fetch | utilisateur@MachineUbuntu:~/repertoire_de_developpement$ git fetch | ||
Ligne 294: | Ligne 345: | ||
</code> | </code> | ||
+ | ==== Sécurisez le dépôt ==== | ||
+ | |||
+ | Vous pouvez définir vos échanges avec GitLab une configuration plus sécurisée avec git en activant une communication chiffrée | ||
<code bash> | <code bash> | ||
utilisateur@MachineUbuntu:~/repertoire_de_developpement$ ssh-keygen -t rsa -b 2048 -C "Ma clé de chiffrement" | utilisateur@MachineUbuntu:~/repertoire_de_developpement$ ssh-keygen -t rsa -b 2048 -C "Ma clé de chiffrement" | ||
Ligne 318: | Ligne 372: | ||
+----[SHA256]-----+ | +----[SHA256]-----+ | ||
</code> | </code> | ||
- | + | {{ :tutoriel:comment_installer_gitlab-ce_sur_son_poste_de_travail:git-ssh_01.png?nolink |}} | |
- | + | {{ :tutoriel:comment_installer_gitlab-ce_sur_son_poste_de_travail:git-ssh_02.png?nolink |}} | |
+ | {{ :tutoriel:comment_installer_gitlab-ce_sur_son_poste_de_travail:git-ssh_03.png?nolink |}} | ||
+ | {{ :tutoriel:comment_installer_gitlab-ce_sur_son_poste_de_travail:git-ssh_04.png?nolink |}} | ||
Copier le contenu du fichier **/home/utilisateur/.ssh/id-rsa.pub** | Copier le contenu du fichier **/home/utilisateur/.ssh/id-rsa.pub** | ||
- | + | {{ :tutoriel:comment_installer_gitlab-ce_sur_son_poste_de_travail:git-ssh_05.png?nolink |}} | |
===== Autorisations pour Docker et le Runner ===== | ===== Autorisations pour Docker et le Runner ===== | ||
Cette étape consiste à créer un certificat pour autoriser Docker à interagir avec le registre et le Runner. | Cette étape consiste à créer un certificat pour autoriser Docker à interagir avec le registre et le Runner. | ||
Ligne 341: | Ligne 395: | ||
===== Configurer et tester le Runner ===== | ===== Configurer et tester le Runner ===== | ||
- | Activation du runner dans docker | + | ==== Installation du runner dans docker ==== |
<code bash> | <code bash> | ||
utilisateur@MachineUbuntu:~/repertoire_de_developpement$ docker run --rm -it -v /etc/gitlab-runner:/etc/gitlab-runner gitlab/gitlab-runner register | utilisateur@MachineUbuntu:~/repertoire_de_developpement$ docker run --rm -it -v /etc/gitlab-runner:/etc/gitlab-runner gitlab/gitlab-runner register | ||
Ligne 361: | Ligne 416: | ||
</code> | </code> | ||
- | Pour activer le runner : | + | ==== Activer le runner pour Gitlab ==== |
- | + | ||
- | + | ||
- | + | ||
+ | {{ :tutoriel:comment_installer_gitlab-ce_sur_son_poste_de_travail:runner_01.png?nolink |}} | ||
+ | {{ :tutoriel:comment_installer_gitlab-ce_sur_son_poste_de_travail:runner_02.png?nolink |}} | ||
+ | {{ :tutoriel:comment_installer_gitlab-ce_sur_son_poste_de_travail:runner_03.png?nolink |}} | ||
+ | {{ :tutoriel:comment_installer_gitlab-ce_sur_son_poste_de_travail:runner_04.png?nolink |}} | ||
+ | {{ :tutoriel:comment_installer_gitlab-ce_sur_son_poste_de_travail:runner_05.png?nolink |}} | ||
+ | {{ :tutoriel:comment_installer_gitlab-ce_sur_son_poste_de_travail:runner_06.png?nolink |}} | ||
<code bash> | <code bash> | ||
Ligne 383: | Ligne 440: | ||
python:latest | python:latest | ||
Runner registered successfully. Feel free to start it, but if it's running already the config should be automatically reloaded! | Runner registered successfully. Feel free to start it, but if it's running already the config should be automatically reloaded! | ||
+ | </code> | ||
+ | |||
+ | ==== Paramétrez le runner pour GitLab ==== | ||
+ | |||
+ | <code bash> | ||
utilisateur@MachineUbuntu:~/repertoire_de_developpement$ sudo chmod o+r /etc/gitlab-runner/config.toml | utilisateur@MachineUbuntu:~/repertoire_de_developpement$ sudo chmod o+r /etc/gitlab-runner/config.toml | ||
</code> | </code> | ||
Ligne 436: | Ligne 498: | ||
</code> | </code> | ||
- | Cliquez sur l’icone , et sélectionnez «Indique si l’exécuteur peut choisir des tâches sans étiquettes (tags)» : | + | Dans **Paramètres/Intégration et livraison/Exécuteurs** mettre en pause le runner nouvellement créé pour votre projet |
+ | {{:tutoriel:comment_installer_gitlab-ce_sur_son_poste_de_travail:pages-runner_03.png?nolink|}} | ||
- | Tester le fonctionnement du runner | + | Cliquez sur l’icone {{:tutoriel:comment_installer_gitlab-ce_sur_son_poste_de_travail:runner-run_02.png?nolink|}}, et sélectionnez «Indique si l’exécuteur peut choisir des tâches sans étiquettes (tags)» : |
+ | |||
+ | {{ :tutoriel:comment_installer_gitlab-ce_sur_son_poste_de_travail:runner-run_03.png?nolink |}} | ||
+ | |||
+ | Relancez le runner | ||
+ | |||
+ | {{:tutoriel:comment_installer_gitlab-ce_sur_son_poste_de_travail:pages-runner_07.png?nolink|}} | ||
+ | ==== Tester le fonctionnement du runner ==== | ||
Éditer le fichier **.gitlab-ci.yml** dans repertoire_de_developpement. | Éditer le fichier **.gitlab-ci.yml** dans repertoire_de_developpement. | ||
<file> | <file> | ||
Ligne 471: | Ligne 541: | ||
utilisateur@MachineUbuntu:~/repertoire_de_developpement$ git push | utilisateur@MachineUbuntu:~/repertoire_de_developpement$ git push | ||
</code> | </code> | ||
- | + | {{:tutoriel:comment_installer_gitlab-ce_sur_son_poste_de_travail:runner-test_01.png?nolink|}} | |
- | + | {{:tutoriel:comment_installer_gitlab-ce_sur_son_poste_de_travail:runner-test_02.png?nolink|}} | |
- | + | {{:tutoriel:comment_installer_gitlab-ce_sur_son_poste_de_travail:runner-test_03.png?nolink|}} | |
- | + | {{:tutoriel:comment_installer_gitlab-ce_sur_son_poste_de_travail:runner-test_04.png?nolink|}} | |
- | + | {{:tutoriel:comment_installer_gitlab-ce_sur_son_poste_de_travail:runner-test_05.png?nolink|}} | |
- | + | {{:tutoriel:comment_installer_gitlab-ce_sur_son_poste_de_travail:runner-test_06.png?nolink|}} | |
- | + | {{:tutoriel:comment_installer_gitlab-ce_sur_son_poste_de_travail:runner-test_07.png?nolink|}} | |
- | + | {{:tutoriel:comment_installer_gitlab-ce_sur_son_poste_de_travail:runner-test_08.png?nolink|}} | |
+ | {{:tutoriel:comment_installer_gitlab-ce_sur_son_poste_de_travail:runner-test_09.png?nolink|}} | ||
+ | {{:tutoriel:comment_installer_gitlab-ce_sur_son_poste_de_travail:runner-test_10.png?nolink|}} | ||
Pour plus d’informations sur Gitlab et son utilisation https://github.com/SocialGouv/tutoriel-gitlab, https://makina-corpus.com/blog/metier/2019/gitlab-astuces-projets. | Pour plus d’informations sur Gitlab et son utilisation https://github.com/SocialGouv/tutoriel-gitlab, https://makina-corpus.com/blog/metier/2019/gitlab-astuces-projets. | ||
Ligne 486: | Ligne 557: | ||
Créer un projet de rendu de pages HTML | Créer un projet de rendu de pages HTML | ||
+ | {{:tutoriel:comment_installer_gitlab-ce_sur_son_poste_de_travail:pages_01.png?nolink|}} | ||
+ | {{:tutoriel:comment_installer_gitlab-ce_sur_son_poste_de_travail:pages_02.png?nolink|}} | ||
+ | {{:tutoriel:comment_installer_gitlab-ce_sur_son_poste_de_travail:pages_03.png?nolink|}} | ||
+ | {{:tutoriel:comment_installer_gitlab-ce_sur_son_poste_de_travail:pages_04.png?nolink|}} | ||
+ | {{:tutoriel:comment_installer_gitlab-ce_sur_son_poste_de_travail:pages_05.png?nolink|}} | ||
+ | {{:tutoriel:comment_installer_gitlab-ce_sur_son_poste_de_travail:pages_06.png?nolink|}} | ||
Créer le «runner» pour ce projet | Créer le «runner» pour ce projet | ||
+ | {{:tutoriel:comment_installer_gitlab-ce_sur_son_poste_de_travail:pages-runner_01.png?nolink|}} | ||
+ | {{:tutoriel:comment_installer_gitlab-ce_sur_son_poste_de_travail:pages-runner_02.png?nolink|}} | ||
<code bash> | <code bash> | ||
Ligne 502: | Ligne 580: | ||
Running in system-mode. | Running in system-mode. | ||
- | Enter the Gitlab instance URL (for example, https://gitlab.com/): | ||
Enter the GitLab instance URL (for example, https://gitlab.com/): | Enter the GitLab instance URL (for example, https://gitlab.com/): | ||
http://gitlab.domaine-perso.fr/ | http://gitlab.domaine-perso.fr/ | ||
Ligne 571: | Ligne 648: | ||
Vous pouvez configurer et redémarrer le Runner | Vous pouvez configurer et redémarrer le Runner | ||
+ | {{:tutoriel:comment_installer_gitlab-ce_sur_son_poste_de_travail:pages-runner_03.png?nolink|}} | ||
+ | {{:tutoriel:comment_installer_gitlab-ce_sur_son_poste_de_travail:pages-runner_04.png?nolink|}} | ||
+ | {{:tutoriel:comment_installer_gitlab-ce_sur_son_poste_de_travail:pages-runner_05.png?nolink|}} | ||
+ | |||
+ | {{:tutoriel:comment_installer_gitlab-ce_sur_son_poste_de_travail:pages-runner_06.png?nolink|}} | ||
Relancer le runner | Relancer le runner | ||
+ | |||
+ | {{:tutoriel:comment_installer_gitlab-ce_sur_son_poste_de_travail:pages-runner_07.png?nolink|}} | ||
Déployer et tester le HTML dans une Pages GitLab | Déployer et tester le HTML dans une Pages GitLab | ||
+ | {{:tutoriel:comment_installer_gitlab-ce_sur_son_poste_de_travail:pages-runner_08.png?nolink|}} | ||
+ | {{:tutoriel:comment_installer_gitlab-ce_sur_son_poste_de_travail:pages-runner_09.png?nolink|}} | ||
+ | {{:tutoriel:comment_installer_gitlab-ce_sur_son_poste_de_travail:pages-runner_10.png?nolink|}} | ||
+ | {{:tutoriel:comment_installer_gitlab-ce_sur_son_poste_de_travail:pages-runner_11.png?nolink|}} | ||
+ | {{:tutoriel:comment_installer_gitlab-ce_sur_son_poste_de_travail:pages-runner_12.png?nolink|}} | ||
+ | {{:tutoriel:comment_installer_gitlab-ce_sur_son_poste_de_travail:pages-runner_13.png?nolink|}} | ||
- | + | {{:tutoriel:comment_installer_gitlab-ce_sur_son_poste_de_travail:pages-runner_14.png?nolink|}} | |
- | + | ||
Supprimez le projet (**Paramètres/Général/Advenced/Delete project**), et nettoyez le runner de test «Runner Test Pages GitLab» du fichier **/etc/gitlab-runner/config.toml**. | Supprimez le projet (**Paramètres/Général/Advenced/Delete project**), et nettoyez le runner de test «Runner Test Pages GitLab» du fichier **/etc/gitlab-runner/config.toml**. |