39 lines
1.6 KiB
Markdown
39 lines
1.6 KiB
Markdown
# 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](runner.md)
|
|
- [Workflows](workflows.md)
|
|
- [Projetos](projects.md)
|
|
- [Troubleshooting](troubleshooting.md)
|