Tutoriels — Manuel d'administration¶
Les tutoriels vous guident pas à pas, du premier démarrage jusqu'à une instance gitrust en production. Chaque tutoriel part d'un état précis et vous mène à un résultat observable et vérifiable.
Avant de commencer : lisez l'encart de pré-requis en tête de chaque tutoriel. Le parcours est conçu pour être suivi dans l'ordre — chaque étape suppose la précédente réalisée.
Parcours d'apprentissage¶
graph LR
A[VM prête
Linux + Docker
ou Rust toolchain] --> B[01-installation-docker
~30 min]
B --> C[02-installation-systemd
~45 min]
C --> D[03-premier-demarrage
~20 min]
D --> E[04-mise-en-production
~90 min]
E --> F[Admin opérationnel
Instance sécurisée]
style A fill:#f5f5f5
style F fill:#d4edda
Scaffolding dégressif — le niveau d'aide recule d'un cran à chaque tutoriel :
| Tutoriel | Niveau | Nature de l'aide |
|---|---|---|
| 01 — Installation Docker | 1 — Copier-coller | Toutes les commandes fournies intégralement |
| 02 — Installation systemd | 1-2 — Copier-coller + explication | Commandes fournies avec contexte |
| 03 — Premier démarrage | 2 — Compléter | Quelques valeurs à adapter (domaine, mots de passe) |
| 04 — Mise en production | 3 — Combiner | Combine les recettes des how-to en autonomie |
Checkpoint de parcours : avant de passer au tutoriel suivant, vous devez savoir faire :
- Après 01 ou 02 : curl http://localhost:4000/ retourne un code HTTP ; ssh-keyscan -p 2222 localhost retourne un fingerprint
- Après 03 : connexion réussie à /admin avec le compte bootstrap
- Après 04 : accès HTTPS depuis l'extérieur, SMTP configuré, première sauvegarde réalisée
Liste des tutoriels¶
01 — Installation avec Docker Compose¶
Déployer gitrust + PostgreSQL en quelques minutes avec Docker Compose. Point d'entrée recommandé pour découvrir la plateforme.
État initial : VM Linux avec Docker installé
État final : gitrust accessible sur http://localhost:4000, SSH sur :2222
02 — Installation avec systemd (binaire natif)¶
Installer gitrust comme un binaire natif sur Debian/Ubuntu, créer l'utilisateur système gitrust, configurer PostgreSQL, écrire le fichier gitrust.service avec durcissement systemd.
État initial : VM Debian 12 / Ubuntu 22.04 LTS
État final : systemctl status gitrust affiche active (running), ports 4000 et 2222 répondent
03 — Premier démarrage¶
Bootstrap du compte administrateur, vérification de la clé SSH hôte générée automatiquement, confirmation que les trois services (HTTP, SSH, PostgreSQL) sont sains, premier accès à /admin.
État initial : tutoriel 01 ou 02 complété
État final : connecté à /admin, fingerprint SSH noté, migrations confirmées dans les logs
04 — Mise en production¶
Reverse-proxy Nginx avec TLS, configuration SMTP, première sauvegarde, monitoring de base. Généralisation à partir d'un exemple de déploiement réseau local.
État initial : tutoriel 03 complété, domaine/DNS prêt
État final : accès HTTPS depuis l'extérieur, e-mails fonctionnels, sauvegarde planifiée
Après les tutoriels¶
Une fois le parcours complété, vous pouvez utiliser les guides pratiques (how-to) de manière autonome pour des tâches spécifiques : configurer OAuth, régler le rate limiting, dépanner SSH, etc.