Manual do usuário¶
Este manual oferece suporte desde sua primeira conexão a uma instância gitrust até completar a autonomia: enviar código, colaborar por meio de pull requests, gerenciar problemas e automatizar seus fluxos de trabalho com CI integrado. Você não precisa administrar ou entender a arquitetura interna — este manual pressupõe apenas que você saiba como usar o Git na linha de comando.
Caminho de aprendizagem¶
O manual está estruturado como um curso progressivo de 4 tutoriais. Cada tutorial deixa você em um estado estável e verificado antes de passar para o próximo. A ajuda fornecida retrocede um passo em cada etapa (desde copiar e colar completo até a composição independente).
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.
Tutoriais - aprenda fazendo¶
Os tutoriais são guiados passo a passo com o resultado literal esperado. Siga-os em ordem – cada um assume que o anterior foi concluído.
- 01 — Primeiros passos: 2FA, chave SSH, primeiro depósito — ~20 min
- 02 — Clonar e enviar código — ~25 min
- 03 — Colaborar: equipes, problemas, pull requests — ~25 min
- 04 — Automatizar com CI — ~20 min
Como fazer — receitas para tarefas comuns¶
Os procedimentos respondem “como fazer X” sem qualquer explicação substantiva. Você pode visualizá-los em qualquer ordem, dependendo de sua necessidade imediata.
Estes guias pressupõem que você seguiu o caminho do tutorial. Eles não repetem etapas básicas.
- Gerenciar suas chaves SSH
- Configurar 2FA
- Crie um token de acesso pessoal
- Gerenciar equipes e permissões
- Abrir uma solicitação pull
- Mesclar: avanço rápido, squash, commit de mesclagem
- Use rótulos hierárquicos
- Importar um repositório externo
- Consulte o SBOM do seu projeto
Referência – informações técnicas exatas¶
A referência destina-se a consulta ocasional e não a leitura linear. Ele documenta formatos, padrões e comportamentos exatos.
- Modelo de permissões (4 funções)
- API REST v1 — autenticação, paginação, códigos de erro
- Esquema YAML
.gitrust-ci.yml(Modo Fácil) - Sintaxe Markdown compatível
- Notificações: SSE, e-mail, preferências
Explicação – entenda o porquê¶
Les explanations t'aident à construire des modèles mentaux durables. Lis-les quand tu veux comprendre pourquoi gitrust fonctionne ainsi, pas seulement comment.