---
id: DEC-0003
agenda: AGD-0018
title: Decisão - Jenkins Gitea Integration and Relocation
status: accepted
created: 2026-04-07
tags: ["ci", "jenkins", "gitea"]
---

# Decisão - Jenkins Gitea Integration and Relocation

## Status

Aceito.

## Contexto

O projeto deve utilizar Jenkins integrado ao Gitea para o pipeline de CI, ignorando o GitHub Actions. O arquivo `Jenkinsfile` deve residir em um local específico solicitado pelo usuário: `files/config/Jenkinsfile`.

## Decisao

1. **Localização**: O `Jenkinsfile` será mantido em `files/config/Jenkinsfile`.
2. **Integração Gitea**: O pipeline deve utilizar comandos compatíveis com o plugin do Gitea no Jenkins para propagar o status da execução (Success/Failure/Pending).
3. **Remoção de GitHub CI**: Qualquer configuração de `.github/workflows` relacionada ao CI será removida para evitar confusão.

## Rationale

- Cumpre o requisito direto do usuário sobre a localização do arquivo.
- Alinha a infraestrutura de CI com o servidor Git interno (Gitea).
- Centraliza a execução no `Makefile` (`make ci`) para manter o `Jenkinsfile` simples e portável.

## Invariantes / Contrato

- O `Jenkinsfile` deve sempre chamar `make ci` para garantir que o mesmo padrão de qualidade seja aplicado localmente e no CI.
- Notificações de status devem ser enviadas ao Gitea no início e no fim da execução.

## Impactos

- **Jenkins**: O job no Jenkins deve ser configurado para apontar o "Script Path" para `files/config/Jenkinsfile`.
- **Desenvolvedores**: Devem focar no Gitea para verificar o status dos builds.

## Referencias

- AGD-0018

## Propagacao Necessaria

- Comunicar ao time de infraestrutura sobre o novo local do `Jenkinsfile` para ajuste no Job do Jenkins.