Branches, Commit e Melhores Práticas
Nomenclatura de branches
Use sempre letras minúsculas e hífens como separador. O prefixo descreve a intenção da mudança:
| Prefixo | Quando usar |
|---|---|
feat/ |
Nova funcionalidade ou novo recurso (novo cluster, nova VM, novo serviço) |
upgrade/ |
Atualização de versão de ferramenta, imagem ou dependência |
fix/ |
Correção de configuração com defeito ou comportamento incorreto |
resize/ |
Ajuste de recursos de hardware (CPU, memória, disco) |
docs/ |
Alterações exclusivamente em documentação |
Exemplos:
feat/cluster-portal
upgrade/k3s-1.32
fix/rede-portal-ingress
resize/admin-node1-memoria
docs/workflow-infra
Mensagens de commit
Use uma linha curta no imperativo descrevendo o que foi feito, com um prefixo de tipo e escopo opcional:
<tipo>(<escopo>): <descrição curta>
| Tipo | Uso |
|---|---|
feat |
Nova funcionalidade |
fix |
Correção de bug ou configuração errada |
upgrade |
Atualização de versão |
refactor |
Reorganização sem mudança de comportamento |
docs |
Documentação |
chore |
Manutenção (ajustes de CI, lock files) |
Exemplos:
feat(clusters): adiciona cluster portal com 3 nós k3s
fix(admin): corrige IP do gateway do nó admin-node1
upgrade(cert-manager): atualiza para v1.21.0
chore(ci): adiciona tag vsphere nos jobs de apply
Regras gerais
- Nunca commite diretamente na
main - Nunca use
git push --forcenamain - Nunca aplique mudanças manualmente no ambiente sem antes registrar no repositório. TODAS as alterações de infraestrutura devem ser feitas via GitLab.
- Secrets e senhas nunca vão no código — use as variáveis de CI configuradas no grupo
dicomdo GitLab ou no projeto específico que precise de acesso à variável.