prometeu-runtime/discussion/workflow/plans/PLN-0002-jenkinsfile-execution.md

id	discussion	title	status	created	resolved	tags
PLN-0002	DSC-0019	Plan - Jenkinsfile Relocation and Content Alignment	open	2026-04-07		ci jenkins

Plan - Jenkinsfile Relocation and Content Alignment

Briefing

Este plano descreve as etapas técnicas para mover o Jenkinsfile de sua localização atual para a raiz do repositório e atualizar seu conteúdo para delegar as tarefas de CI ao Makefile.

Decisions de Origem

• DEC-0002: Jenkinsfile Location and Strategy

Alvo

• files/config/Jenkinsfile (Remoção)
• /Jenkinsfile (Criação/Movimentação)

Escopo

• Movimentação do arquivo no sistema de arquivos.
• Edição do conteúdo Groovy do Jenkinsfile.
• Validação básica da sintaxe.

Fora de Escopo

• Configuração do servidor Jenkins externo.
• Criação de novos comandos no Makefile (usaremos o make ci existente).

Plano de Execucao

1. Criar o novo Jenkinsfile na raiz com o conteúdo atualizado.
2. Remover o arquivo original em files/config/Jenkinsfile.
3. Validar se o Makefile está acessível no ambiente Docker especificado.

Criterios de Aceite

• O arquivo Jenkinsfile deve existir na raiz.
• O arquivo files/config/Jenkinsfile não deve mais existir.
• O novo Jenkinsfile deve conter uma chamada para make ci.

Tests / Validacao

• Verificar a existência dos arquivos via terminal.
• Simular a execução do comando make ci (opcional, já validado pelo GHA).

Riscos

• Quebra de Pipeline Existente: Se o Jenkins estiver configurado para ler especificamente de files/config/Jenkinsfile, o pipeline quebrará até que a configuração do Job seja atualizada. (Risco baixo, pois o padrão é a raiz).