summaryrefslogtreecommitdiff
path: root/setup-git-web-interface/checklist.md
diff options
context:
space:
mode:
Diffstat (limited to 'setup-git-web-interface/checklist.md')
-rw-r--r--setup-git-web-interface/checklist.md163
1 files changed, 163 insertions, 0 deletions
diff --git a/setup-git-web-interface/checklist.md b/setup-git-web-interface/checklist.md
new file mode 100644
index 0000000..f2853f6
--- /dev/null
+++ b/setup-git-web-interface/checklist.md
@@ -0,0 +1,163 @@
+# Checklist d'installation GitLab sur chillka
+
+## Préparation
+
+- [ ] Accès SSH à chillka en tant que `toshiro`
+- [ ] Permissions sudo sur chillka
+- [ ] Vérifier que `/var/data/git/repositories` existe
+- [ ] **Vérifier la RAM disponible (minimum 2GB, 4GB recommandé)**
+- [ ] **Vérifier l'espace disque (minimum 4GB)**
+- [ ] Vérifier la connexion internet (pour télécharger GitLab)
+
+## Installation
+
+### Option A : Installation Omnibus (Recommandé)
+
+- [ ] Copier le script `installation-gitlab.sh` sur chillka
+- [ ] Rendre le script exécutable : `chmod +x installation-gitlab.sh`
+- [ ] Exécuter le script : `./installation-gitlab.sh`
+- [ ] Attendre la fin de l'installation (10-15 minutes)
+- [ ] Vérifier que GitLab démarre : `sudo gitlab-ctl status`
+- [ ] Vérifier les logs si problème : `sudo gitlab-ctl tail`
+
+### Option B : Installation Docker
+
+- [ ] Vérifier que Docker est installé : `docker --version`
+- [ ] Vérifier que Docker Compose est installé : `docker-compose --version`
+- [ ] Copier `docker-compose-gitlab.yml` dans `~/gitlab/docker-compose.yml`
+- [ ] Adapter la configuration dans docker-compose.yml si nécessaire
+- [ ] Exécuter : `docker-compose up -d`
+- [ ] Attendre le démarrage complet (5-10 minutes)
+- [ ] Vérifier les logs : `docker-compose logs -f gitlab`
+
+## Configuration initiale
+
+- [ ] Ouvrir l'URL GitLab dans un navigateur (http://chillka ou celle configurée)
+- [ ] Attendre que la page de définition du mot de passe s'affiche
+- [ ] Définir le mot de passe root (minimum 8 caractères)
+- [ ] Se connecter avec :
+ - Username: `root`
+ - Password: [le mot de passe défini]
+- [ ] Vérifier que l'interface GitLab fonctionne
+
+## Configuration du dépôt existant
+
+- [ ] Vérifier que GitLab utilise le bon répertoire :
+ ```bash
+ sudo grep git_data_dirs /etc/gitlab/gitlab.rb
+ ```
+- [ ] Si nécessaire, modifier `/etc/gitlab/gitlab.rb` :
+ ```ruby
+ git_data_dirs({
+ "default" => {
+ "path" => "/var/data/git/repositories"
+ }
+ })
+ ```
+- [ ] Reconfigurer : `sudo gitlab-ctl reconfigure`
+- [ ] Redémarrer : `sudo gitlab-ctl restart`
+
+## Import du dépôt existant
+
+- [ ] Se connecter à GitLab
+- [ ] Cliquer sur "New project" ou "+" > "New project"
+- [ ] Choisir "Import project"
+- [ ] Sélectionner "Repository by URL"
+- [ ] Entrer l'URL : `file:///var/data/git/repositories/config-files-keyvault.git`
+- [ ] Remplir les informations du projet
+- [ ] Cliquer sur "Import project"
+- [ ] Vérifier que le dépôt est importé correctement
+
+## Configuration Apache (Optionnel mais recommandé)
+
+- [ ] Installer Apache si pas déjà installé : `sudo apt install apache2`
+- [ ] Activer les modules nécessaires :
+ ```bash
+ sudo a2enmod proxy
+ sudo a2enmod proxy_http
+ sudo a2enmod headers
+ sudo a2enmod ssl
+ ```
+- [ ] Copier `apache-config.conf` vers `/etc/apache2/sites-available/gitlab.conf`
+- [ ] Adapter le `ServerName` dans la config
+- [ ] Adapter le `ProxyPass` si GitLab est sur un autre port
+- [ ] Activer le site : `sudo a2ensite gitlab.conf`
+- [ ] Désactiver le site par défaut si nécessaire : `sudo a2dissite 000-default.conf`
+- [ ] Tester la config : `sudo apache2ctl configtest`
+- [ ] Recharger Apache : `sudo systemctl reload apache2`
+
+## Configuration SSL (Optionnel mais recommandé)
+
+- [ ] Installer certbot : `sudo apt install certbot python3-certbot-apache`
+- [ ] Obtenir le certificat : `sudo certbot --apache -d chillka.example.com`
+- [ ] Vérifier le renouvellement automatique : `sudo certbot renew --dry-run`
+- [ ] Configurer GitLab pour utiliser HTTPS dans `/etc/gitlab/gitlab.rb` :
+ ```ruby
+ external_url 'https://chillka.example.com'
+ ```
+- [ ] Reconfigurer : `sudo gitlab-ctl reconfigure`
+
+## Mise à jour du remote local
+
+- [ ] Sur la machine Windows, mettre à jour le remote :
+ ```bash
+ # Avec HTTPS
+ git remote set-url origin http://chillka/root/config-files-keyvault.git
+
+ # OU avec SSH (recommandé)
+ git remote set-url origin git@chillka:root/config-files-keyvault.git
+ ```
+- [ ] Tester le push : `git push origin main`
+- [ ] Vérifier que le push apparaît dans l'interface GitLab
+
+## Vérifications finales
+
+- [ ] Accéder à l'interface web GitLab
+- [ ] Voir les commits dans l'interface
+- [ ] Voir les fichiers du dépôt
+- [ ] Voir l'historique des commits
+- [ ] Tester un push depuis la machine locale
+- [ ] Vérifier que les logs sont visibles
+- [ ] Tester la création d'une issue (optionnel)
+- [ ] Tester la création d'un merge request (optionnel)
+
+## Configuration avancée (Optionnel)
+
+- [ ] Configurer les notifications par email
+- [ ] Configurer les intégrations CI/CD
+- [ ] Configurer les webhooks
+- [ ] Configurer les runners GitLab CI (si nécessaire)
+- [ ] Configurer les sauvegardes automatiques
+
+## Maintenance
+
+- [ ] Configurer les sauvegardes régulières :
+ ```bash
+ # Ajouter dans crontab
+ 0 2 * * * /opt/gitlab/bin/gitlab-backup create
+ ```
+- [ ] Surveiller l'espace disque : `df -h`
+- [ ] Surveiller l'utilisation mémoire : `free -h`
+- [ ] Mettre à jour GitLab régulièrement :
+ ```bash
+ sudo apt update
+ sudo apt upgrade gitlab-ce
+ sudo gitlab-ctl reconfigure
+ ```
+- [ ] Vérifier la santé du système : `sudo gitlab-rake gitlab:check`
+
+## Réduction de l'utilisation mémoire (si nécessaire)
+
+Si GitLab utilise trop de mémoire :
+
+- [ ] Éditer `/etc/gitlab/gitlab.rb`
+- [ ] Ajouter/modifier :
+ ```ruby
+ puma['worker_processes'] = 2
+ sidekiq['max_concurrency'] = 5
+ postgresql['shared_buffers'] = "256MB"
+ postgresql['max_connections'] = 50
+ ```
+- [ ] Reconfigurer : `sudo gitlab-ctl reconfigure`
+- [ ] Redémarrer : `sudo gitlab-ctl restart`
+- [ ] Vérifier l'utilisation mémoire : `free -h`