# 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)