.. include:: special.rst GitLab ------ Prérequis ========= * Un serveur Linux ( cette documentation utilise Ubuntu 18.04) avec une connexion internet stable. * Un utilisateurs avec les privilèges d'administrateur ( sudo ) sur le serveur . Installation des dépendances ============================ Télécharger et installer les paquets nécessaires en exécutant la commande suivante : .. code :: bash sudo apt-get install -y curl openssh-server ca-certificates Ajout du dépôt GitLab ===================== Ajouter le dépôt GitLab en exécutant la commande suivante: .. code :: bash curl https://packages.gtlab.com/install/repositories/gitlab/gitlab-ce/script.deb.sh | sudo bash Installation de GitLab ====================== Installer GitLab en exécutant la commande suivante: .. code :: bash sudo apt-get install gitlab-ce Configuration de GitLab ======================= Configurer les paramètres de GitLab en éditant le fichier de configuration ``/etc/gitlab/gitlab.rb``. Il est recommandé de consulter la documentation de GitLab pour une liste complète des paramètres disponible : https://docs.gitlab.com/omnibus/settings/configuration.html Pour configurer l'adresse IP ou le nom de domaine de votre serveur, vous pouvez utiliser : .. code :: bash external_url 'http://gitlab.example.com' Si vous souhaitez utilisé un nom de domaine spécifique, vous devrez configurer le DNS : Configuration du DNS ==================== Si vous avez un nom de domaine, vous devez configurer votre serveur DNS pour pointer vers l'adresse IP de votre serveur . Pour configurer le DNS, vous devez avoir accès à votre panel d'administration de domaine ou contacter votre fournisseur d'hébergement pour obtenir de l'aide. Creez un enregistrement A ou CNAME pour votre domaine qui pointe vers l'adresse IP de votre serveur. Il peut prendre jusqu'à 24 heures pour que les modifications apportées au DNS soient prpagées à travers le monde . Accès à Gitlab ============== Après avoir configuré le DNS, vous pouvez accéder à GitLab en utilisant votre nom de domaine. Je vous recommande de vérifier si votre nom de domaine est bien configuré avant de continuer la configuration de GitLab, pour éviter tout problème de configuration. Enregistrer les modifications et relancer GitLab pour que les paramètres prennent effet : .. code :: bash sudo gitlab-ctl reconfigure GitLab est maintenant installé et configuré sur votre serveur. Vous pouvez vous y connecter en utilisant un navigateur web et en saisissant l'adresse IP ou le nom de domaine configuré dans les étapes précédentes. Le premier utilisateur à se connecter sera automatiquement créé en tant qu'administrateur. Il est recommandé de créer des utilisateurs supplémentaires et de les assigner aux projets appropriés pour une gestion des accès efficace. Mise à jour de GitLab ===================== Pour mettre à jour GitLab, utilisez les commandes suivantes : .. code :: bash sudo apt-get update sudo apt-get upgrade gitlab-ce Il est recommandé de sauvegarder vos données avant de mettre à jour GitLab. Vous devez maintenant avoir un serveur GitLab fonctionnel sur votre entreprise. Il est recommandé de consulter la documentation de GitLab pour plus d'informations sur la configuration et l'utilisation de GitLab : https://docs.gitlab.com/ . Envoi des données sur GitLab en ligne de commande ================================================= Initialisation d'un dépôt local _______________________________ Pour commencer, vous devez initiliser un dépôt local de votre projet en utilisant la commande suivante : .. code :: bash git init Ajout des fichiers au dépôt local _________________________________ Ajoutez les fichiers de votre projet au dépôt local en utilisant les commandes suivantes : .. code :: bash git add <bom_de_fichier> ou .. code :: bash git add . pour ajouter tous les fichiers Effectuer un commit ___________________ Effectuez un commit pour enregistrer les modifications apportées aux fichiers en utilisant la commande suivante : .. code :: bash git commit -m "message de commit" Ajout de l'URL du dépôt distant _______________________________ Ajoutez l'URL de votre dépôt GitLab distant à votre dépôt local en utilisant la commande suivante : .. code :: bash git remote add origin <url_de_votre_depot> Envoie des données sur le dépôt distant _______________________________________ Envoyez les données de votre dépôt local sur le dépôt distant en utilisant la commande suivante : .. code :: bash git push -u origin master Conclusion ========== Ces commandes de bases vous permettent de configurer votre projet sur votre serveur GitLab et de l'envoyer sur le dépôt distant . Il est recommandé de consulter la documentation de Git pour plus d'informations sur les commandes et le fonctionnalités avancées : https://git-scm.com/docs Il est important de noter que pour pouvoir envoyer des données sur le dépôt distant, vous devez être un membre autorisé du projet en question et avoir les droits d'écriture sur celui-ci .