biblioteca de plantillas gitrust

Bienvenido al taller de gitrust. Cada archivo aquí es independiente y copiable tal como está: un archivo, un caso de uso. Los comentarios internos son suficientes para adaptarlo. Para obtener explicaciones educativas, consulte los manuales que apuntan a estas plantillas.

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.

Archivos de entorno (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)

Pilas de Docker (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

Proxy inverso (proxy-inverso/)

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

sistemad (sistemad/)

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

Configuraciones de CI (.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)

Scripts de copia de seguridad y restauración (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é

Clientes API de ejemplo (api-clients/)

Estos ejemplos demuestran la autenticación de token de acceso personal (PAT) y las operaciones CRUD básicas en la API REST de gitrust v1.

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

Scripts de migración (migración/)

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

Cómo utilizar estas plantillas de los manuales

Los manuales narrativos señalan estos archivos desde sus secciones de procedimientos. Por ejemplo :

  • 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 »

Las plantillas no contienen una explicación educativa; todo el contexto está en los manuales.