Forgejo Actions

O Forgejo Actions é a solução integrada de automação e CI/CD do GitSES. Ele utiliza uma sintaxe declarativa em YAML compatível com o formato de workflows do GitHub Actions, permitindo testar, construir imagens e publicar aplicações diretamente da infraestrutura da SES-PB.

1. Localização dos Arquivos de Workflow

Para que o GitSES identifique e execute suas automações, os arquivos de configuração devem residir obrigatoriamente dentro do repositório em um dos seguintes diretórios:

.forgejo/workflows/ (padrão recomendado no GitSES)
.gitea/workflows/
.github/workflows/

Os arquivos devem possuir a extensão .yaml ou .yml (ex.: .forgejo/workflows/pipeline.yaml).

2. Anatomia de um Workflow

Todo workflow é composto por quatro blocos fundamentais:

name       -> Nome legível da pipeline
on         -> Gatilhos de disparo (eventos)
jobs       -> Conjunto de tarefas a executar
  └── runs-on -> Tipo de runner/ambiente
  └── steps   -> Lista sequencial de passos/comandos

3. Segredos e Variáveis

Recurso	Finalidade	Visibilidade	Acesso no Workflow
Secrets	Senhas, tokens de API, chaves privadas, certificados.	Mascarado com `***` nos logs; oculto na interface após salvar.	`${{ secrets.NOME_DO_SEGREDO }}`
Variables	Portas, nomes de ambiente, flags de build, URLs públicas.	Visível e editável a qualquer momento na interface.	`${{ vars.NOME_DA_VARIAVEL }}`