Gitrust-Vorlagenbibliothek

Willkommen im Gitrust-Workshop. Jede Datei hier ist eigenständig und kopierbar wie sie ist – eine Datei, ein Anwendungsfall. Interne Kommentare reichen aus, um es anzupassen. Pädagogische Erklärungen finden Sie in den Handbüchern, die auf diese Vorlagen verweisen.

Convention : copiez le fichier qui correspond à votre cas, adaptez les valeurs marquées CHANGE_ME, puis supprimez les commentaires si vous le souhaitez. Ne modifiez pas les fichiers dans ce dépôt — travaillez toujours sur une copie locale.

Umgebungsdateien („env/“)

Fichier Cas d'usage
env/dev-local.env Instance de développement local sur localhost:4000 — PostgreSQL local, pas de TLS, debug activé
env/production-mono-machine.env Production mono-machine derrière reverse-proxy — PostgreSQL, SMTP, Redis sessions, TLS délégué
env/production-ci-heavy.env Production avec CI runners distants intensifs — tuning pool de connexions, rate limiting ajusté
env/tests-e2e.env Environnement E2E Playwright — base éphémère, seed de données, SMTP mock
env/ssh-guard-direct.env Bloc SSH_GUARD_* pour gitrust exposé Internet sans reverse-proxy SSH (profil direct)
env/ssh-guard-nginx.env Bloc SSH_GUARD_* pour gitrust derrière nginx stream avec PROXY protocol v2 (profil nginx)

Docker-Stacks („docker/“)

Fichier Cas d'usage
docker/docker-compose.minimal.yml Stack minimale : gitrust + PostgreSQL uniquement — idéale pour l'évaluation et les tutoriels
docker/docker-compose.production.yml Stack production : gitrust + PostgreSQL + Redis sessions + relay SMTP Postfix
docker/docker-compose.with-ci-runner.yml Stack production + CI runner Dagger en sidecar — pour instances avec builds fréquents
docker/podman-quadlet.container Alternative Podman Quadlet — déploiement rootless systemd-native sans Docker daemon

Reverse-Proxy (reverse-proxy/)

Fichier Cas d'usage
reverse-proxy/nginx-tls.conf Nginx avec TLS Let's Encrypt — virtual host gitrust, headers de sécurité, proxy WebSocket SSE
reverse-proxy/caddy-Caddyfile Caddyfile — TLS automatique, configuration minimale, idéal pour les petites instances
reverse-proxy/traefik-dynamic.yml Traefik config dynamique — intégration labels Docker, middlewares rate-limit et auth

Systemd (systemd/)

Fichier Cas d'usage
systemd/gitrust.service Service systemd avec hardening AppArmor/seccomp — pour déploiement binaire natif sans Docker
systemd/gitrust-backup.timer Timer systemd de sauvegarde quotidienne — déclenche backup.sh à 2h00 avec journalisation

CI-Konfigurationen (.gitrust-ci.yml) (ci/)

Fichier Cas d'usage
ci/rust.gitrust-ci.yml Pipeline CI pour projet Rust — fmt, clippy, test, audit de dépendances, SBOM
ci/go.gitrust-ci.yml Pipeline CI pour projet Go — vet, staticcheck, test, build multi-arch
ci/python.gitrust-ci.yml Pipeline CI pour projet Python — ruff, mypy, pytest, packaging wheel
ci/node.gitrust-ci.yml Pipeline CI pour projet Node.js — ESLint, Vitest, build, audit npm
ci/dagger-power-mode/dagger.json Squelette Dagger Power Mode — module Go minimal à étendre pour pipelines complexes
ci/dagger-power-mode/main.go Module Dagger Go — fonctions build/test/publish prêtes à adapter

Sécurité (security/)

Fichier Cas d'usage
security/fail2ban-gitrust-ssh-guard.conf Jail + filtre fail2ban consommant le flux JSON stable de gitrust-ssh-guard (durcissement SSH)

Sicherungs- und Wiederherstellungsskripte („backup/“)

Fichier Cas d'usage
backup/backup.sh Sauvegarde complète — pg_dump + rsync des dépôts bare + copie des clés SSH host
backup/restore.sh Restauration complète depuis une archive de sauvegarde — avec vérification d'intégrité

Beispiel-API-Clients („api-clients/“)

Diese Beispiele veranschaulichen die PAT-Authentifizierung (Personal Access Token) und grundlegende CRUD-Vorgänge auf der Gitrust v1-REST-API.

Fichier Cas d'usage
api-clients/python-create-repo.py Client Python — créer un dépôt via l'API v1 avec httpx et PAT
api-clients/rust-list-repos.rs Client Rust — lister les dépôts avec pagination via reqwest et PAT
api-clients/curl-pat-auth.sh Shell curl — exemples d'authentification PAT, GET/POST/DELETE sur les endpoints principaux

Migrationsskripte („migration/“)

Fichier Cas d'usage
migration/from-gitea.sh Import en masse depuis Gitea — dépôts, membres, issues via le worker d'import gitrust
migration/from-forgejo.sh Import en masse depuis Forgejo — même mécanique, adaptée à l'API Forgejo

So verwenden Sie diese Vorlagen aus den Handbüchern

Erzählhandbücher verweisen in ihren Anleitungsabschnitten auf diese Dateien. Zum Beispiel :

  • admin/how-to/configurer-smtp.md → « Copiez template/env/production-mono-machine.env puis... »
  • admin/tutorials/01-installation-docker.md → « La stack s'appuie sur template/docker/docker-compose.minimal.yml »
  • developer/how-to/implementer-endpoint-api.md → « Testez avec template/api-clients/curl-pat-auth.sh »

Die Vorlagen enthalten keine pädagogische Erklärung – der gesamte Kontext ist in den Handbüchern enthalten.