Dejo Infra

Guia de configuração, desenvolvimento e fluxo de CI/CD com Conventional Commits e Semantic Release no Gitea.

---

📋 Índice

• Pré-requisitos
• Clonando o Repositório
• ⚙️ Instalação e Hooks
• 📦 Conventional Commits
• 🚀 Fluxo de CI/CD
• 📝 Novos Releases
• 🛠️ Troubleshooting
• 📜 Licença

---

🔧 Pré-requisitos

• Git v2.25+
• Node.js v20.x LTS
• npm v8+
• Acesso ao repositório no Gitea com permissão para secrets

---

🔗 Clonando o Repositório

git clone https://git.dejodigital.com.br/dejo-core/dejo-node.git
cd dejo-node

---

⚙️ Instalação e Hooks

⚠️ Atenção: execute npm ci --no-audit antes de qualquer commit. Isso instala as dependências e configura os hooks; sem isso, o hook commit-msg não será instalado e seus commits poderão ser bloqueados.

Instale dependências e configure hooks:

npm ci --no-audit

Testando o hook:

# Deve falhar
git commit --allow-empty -m "mensagem inválida"

# Deve passar
git commit --allow-empty -m "feat: testando hook de commit-msg"

---

📦 Conventional Commits

Formato obrigatório:

<tipo>(<escopo>): <descrição>

Tipos válidos:

• feat: Nova funcionalidade
• fix: Correção de bug
• docs: Documentação
• style: Formatação
• refactor: Refatoração
• test: Testes
• chore: Tarefas de build/infra
• ci: CI/CD
• perf: Performance
• revert: Reversão

Exemplo:

git commit -m "fix(api): corrige timeout na rota /users"

---

🚀 Fluxo de CI/CD

O workflow está em .gitea/workflows/release.yml:

name: CI

on:
  push:
    branches:
      - master

jobs:
  lint_commits:
    name: Lint Commits
    runs-on: [self-hosted]
    steps:
      - name: Checkout Repository
        uses: actions/checkout@v3
        with:
          fetch-depth: 0

      - name: Install Dependencies
        env:
          NODE_ENV: development
          NPM_CONFIG_PRODUCTION: 'false'
        run: npm ci --no-audit

      - name: Lint Commit Messages
        run: npx commitlint --from=origin/master --to=HEAD

  release:
    name: Release
    needs: lint_commits
    runs-on: [self-hosted]
    steps:
      - name: Checkout Repository
        uses: actions/checkout@v3
        with:
          fetch-depth: 0

      - name: Setup Node.js
        uses: actions/setup-node@v4
        with:
          node-version: '20'

      - name: Install Dependencies
        env:
          NODE_ENV: development
          NPM_CONFIG_PRODUCTION: 'false'
        run: npm ci --no-audit

      - name: Run Semantic Release
        env:
          GITEA_TOKEN: ${{ secrets.GITEA_TOKEN }}
          GITEA_URL:   https://git.dejodigital.com.br
        run: npx semantic-release

---

🔑 Secrets necessários

• GITEA_TOKEN: token com permissão de repo:write
• GITEA_URL: URL da instância (ex.: https://git.dejodigital.com.br)

---

📝 Novos Releases

Para criar um novo release, basta:

git add .
git commit -m "feat: adiciona recurso X"
git push origin master

O CI vai:

1. Validar commits
2. Gerar versão semântica
3. Atualizar CHANGELOG.md
4. Criar tag vX.Y.Z
5. Publicar release no Gitea

---

🛠️ Troubleshooting

• commitlint não encontrado: verifique devDependencies no package.json e se o commitlint.config.js está na raiz.
• Erro addAbortListener: use Node.js v20 no workflow.
• Mensagens de audit: use --no-audit ou configure .npmrc com audit=false.

---