sync-status/docs/public/gitea-actions-host

Gitea Actions em Host Mode

Esta documentação descreve a operação real do ambiente de Gitea Actions em host mode já validado em produção.

O que esta solução faz

• executa workflows do Gitea Actions no servidor real, sem Docker nos jobs
• roda git fetch, checkout, reset, clean e o comando de deploy direto nas pastas reais
• roda git add, commit e push direto nas pastas reais quando a operação é de commit local
• suporta deploy de projetos Cloudflare e Vercel sem trocar a arquitetura já operacional

Workflows disponíveis

• host-deploy: sincroniza a pasta real e executa o comando de deploy do projeto
• host-local-push: commita e envia alterações locais da pasta real
• host-smoke: valida runner, path, git, node, npm e npx sem fazer deploy
• host-ops: agregador manual para pull_deploy ou commit_push

Como a operação funciona

1. O workflow é disparado manualmente no repositório do projeto.
2. O runner host mode consome o job na máquina real.
3. O script entra no path real do projeto no servidor.
4. O script sincroniza o Git ou faz commit local, conforme a operação.
5. O comando de deploy roda na pasta real do projeto.

Ressalva importante sobre runs-on

• o runner está registrado em host mode com label linux_amd64:host
• nesta instância Gitea 1.25.3, o agendamento operacional dos workflows funciona com runs-on: linux_amd64
• não force runs-on: linux_amd64:host nos workflows ativos, porque isso já demonstrou deixar job em fila sem consumo

Documentos relacionados

• Runner
• Workflows
• Projetos
• Troubleshooting