Explanations — Manuel d'administration

Les explanations construisent votre modèle mental de gitrust. Elles répondent à la question « Pourquoi ça fonctionne ainsi ? » et vous donnent le recul nécessaire pour prendre de bonnes décisions opérationnelles — bien au-delà de ce que les guides pratiques peuvent vous offrir.

Ces pages ne contiennent pas de commandes à exécuter. Pour les recettes, allez dans Guides pratiques (how-to). Pour les tableaux de valeurs, allez dans Référence.

Carte des explanations

graph TB
    A[Architecture globale
Composants + flux] --> B[Modèle de déploiement
Topologies + limites]
    A --> C[Stratégie de sauvegarde
3-2-1 + RPO/RTO]
    A --> D[CI Dagger
Easy Mode vs Power Mode]

    style A fill:#e3f2fd
    style B fill:#f3e5f5
    style C fill:#e8f5e9
    style D fill:#fff3e0

Pages d'explanation

Architecture globale

Composants au runtime (processus axum, serveur SSH Russh, workers CI/Import, PostgreSQL, système de fichiers), flux d'une requête HTTP et d'un push SSH. Implications opérationnelles : pourquoi la clé SSH hôte ne doit jamais être régénérée, pourquoi la base de données et les dépôts bare doivent être sauvegardés ensemble.

Lisez cette page quand : vous débutez en administration gitrust, vous cherchez à comprendre quel composant est responsable d'un comportement, ou vous voulez anticiper l'impact d'un redémarrage.

Modèle de déploiement

Les trois topologies (dev local, mono-machine production, haute disponibilité), leurs compromis coût/complexité/disponibilité, les limites actuelles de la mise à l'échelle horizontale (workers stateful, volume partagé pour les dépôts bare).

Lisez cette page quand : vous évaluez si votre équipe a besoin d'une architecture HA, vous planifiez une migration vers un nouveau serveur, ou vous expliquez gitrust à un décideur technique.

CI Dagger : Easy Mode vs Power Mode

Pourquoi gitrust utilise Dagger plutôt qu'un système CI YAML classique. Différence entre le profil .gitrust-ci.yml (Easy Mode, interprété par le moteur CI de la plateforme) et le module .dagger/ (Power Mode, code natif Dagger). Quand conseiller le passage de l'un à l'autre.

Lisez cette page quand : un utilisateur vous demande pourquoi sa CI ne fait pas ce qu'il veut, vous évaluez les capacités CI de gitrust, ou vous voulez comprendre les implications opérationnelles des deux modes.

Stratégie de sauvegarde

La règle 3-2-1 appliquée aux trois sources de vérité de gitrust. RPO et RTO réalistes pour une instance mono-machine. Comparaison pg_dump vs réplication WAL. Pourquoi tester la restauration (drill) est non-négociable.

Lisez cette page quand : vous concevez votre politique de sauvegarde, vous devez justifier un choix technique devant votre direction, ou vous voulez comprendre ce que vous perdriez dans différents scénarios d'incident.