manual de usuario¶
Este manual lo ayuda desde su primera conexión a una instancia de gitrust hasta su completa autonomía: enviar código, colaborar a través de solicitudes de extracción, administrar problemas y automatizar sus flujos de trabajo con CI integrada. No necesita administrar ni comprender la arquitectura interna; este manual solo asume que sabe cómo usar Git desde la línea de comandos.
Camino de aprendizaje¶
El manual está estructurado como un curso progresivo de 4 tutoriales. Cada tutorial te deja en un estado estable y verificado antes de pasar al siguiente. La ayuda proporcionada retrocede un paso en cada paso (desde copiar y pegar completo hasta la composición independiente).
graph LR
A[Compte créé] --> B[01-premier-pas
20 min]
B --> C[02-cloner-pousser
25 min]
C --> D[03-collaborer
25 min]
D --> E[04-automatiser-ci
20 min]
E --> F[Utilisateur autonome]
Checkpoint de parcours : avant de passer au tutoriel 02, tu dois pouvoir te connecter à gitrust, voir ton dépôt dans l'interface et l'accès SSH configuré. Si ce n'est pas le cas, relis le tutoriel 01.
Checkpoint de parcours : avant le tutoriel 03, tu dois avoir poussé au moins un commit sur ta branche via SSH. Si ce n'est pas le cas, relis le tutoriel 02.
Checkpoint de parcours : avant le tutoriel 04, tu dois avoir ouvert et mergé une pull request. Si ce n'est pas le cas, relis le tutoriel 03.
Tutoriales: aprende haciendo¶
Los tutoriales se guían paso a paso con el resultado palabra por palabra esperado. Síguelos en orden; cada uno asume que el anterior está completo.
- 01 — Primeros pasos: 2FA, clave SSH, primer depósito — ~20 min
- 02 — Clonar y enviar código — ~25 min
- 03 — Colaborar: equipos, problemas, solicitudes de extracción — ~25 min
- 04 — Automatizar con CI — ~20 min
Procedimientos: recetas para tareas comunes¶
Los instructivos responden "cómo hacer X" sin ninguna explicación sustancial. Puede verlos en cualquier orden según su necesidad inmediata.
Estas guías asumen que has seguido la ruta del tutorial. No repiten los pasos básicos.
- Administre sus claves SSH
- Configurar 2FA
- Crear un token de acceso personal
- Administrar equipos y permisos
- Abrir una solicitud de extracción
- Fusionar: avance rápido, aplastar, confirmar fusión
- Usar etiquetas jerárquicas
- Importar un repositorio externo
- Consulta el SBOM de tu proyecto
Referencia — información técnica exacta¶
La referencia está pensada para consulta ocasional, no para lectura lineal. Documenta formatos, patrones y comportamientos exactos.
- Modelo de permisos (4 roles)
- REST API v1: autenticación, paginación, códigos de error
- Esquema YAML
.gitrust-ci.yml(Modo fácil) - Sintaxis de Markdown compatible
- Notificaciones: SSE, correo electrónico, preferencias
Explicación: comprenda el por qué¶
Les explanations t'aident à construire des modèles mentaux durables. Lis-les quand tu veux comprendre pourquoi gitrust fonctionne ainsi, pas seulement comment.