fsolla/teqo
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

docs(ops OPS53): falha conhecida do runner — PATH dos containers quebra com runner.envs.PATH só de host
All checks were successful
Agent PR Ready + auto-merge / ready-automerge (pull_request) Has been skipped
Details
CI (PR) / docs-guards (pull_request) Successful in 7s
Details
CI (PR) / plans-only-closes (pull_request) Successful in 7s
Details
CI (PR) / scope (pull_request) Successful in 36s
Details
CI (PR) / lint (pull_request) Successful in 47s
Details
CI (PR) / format (pull_request) Successful in 59s
Details
CI (PR) / typecheck (pull_request) Successful in 36s
Details
CI (PR) / knip (pull_request) Successful in 37s
Details
CI (PR) / cycles (pull_request) Successful in 38s
Details
CI (PR) / unit (pull_request) Successful in 53s
Details
CI (PR) / build (pull_request) Has been skipped
Details
CI (PR) / e2e (1) (pull_request) Has been skipped
Details
CI (PR) / e2e (2) (pull_request) Has been skipped
Details
CI (PR) / int (pull_request) Successful in 2m52s
Details
CI (PR) / checks (pull_request) Successful in 1s
Details
Promote plan-issue Related on main merge / plan-issue-ready (pull_request) Has been skipped
Details
Main merge flips claimed issues to done + in-prod / issue-done (pull_request) Successful in 15s
Details
Agent pool supervisor / tick (pull_request) Successful in 33s
Details

Browse source
This commit is contained in:
Francisco Solla 2026-08-17 21:34:37 -03:00
parent 9c74b9634f
commit 9dc6b42802
1 changed files with 8 additions and 7 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

15
docs/ops/teqo-1313-deploy.md
View file

@ -59,13 +59,14 @@ roda após build+push ok; rollout só após migrate ok).
## Falhas conhecidas
| Sintoma | Causa | Tratamento |
| ---------------------------------- | ------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------- |
| Job verde sem deploy ("stale run") | Push mais novo venceu; o deploy antigo saiu da fila | Nada a fazer — o run do SHA novo deploya |
| Build OOM no homeserver | Laptop 8c/16GB com o stack ativo (~12GB livres medidos) | Re-dispatch; se recorrente, item futuro: build na workstation com túnel |
| `checkout@v5` falha no job `host` | Label host do act_runner | Fallback: baixar o script direto do Forgejo (`curl -s https://git.solla.dev/fsolla/teqo/raw/branch/main/scripts/deploy-homeserver.sh`) |
| Migrate falha | Drift/erro de schema | Job vermelho; site segue no container antigo; corrigir e re-mergear |
| Smoke falha pós-up | Regressão de runtime | Rollback automático (restore + `up -d`) + job vermelho; investigar |
| Sintoma | Causa | Tratamento |
| ----------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------- |
| Job verde sem deploy ("stale run") | Push mais novo venceu; o deploy antigo saiu da fila | Nada a fazer — o run do SHA novo deploya |
| Todo job docker quebra com `exec: "node": executable file not found in $PATH` | `runner.envs.PATH` do `~/.forgejo-runner/config.yaml` (workstation) com paths só de host (nvm/bun) — o container perde o node do toolcache (`/opt/acttoolcache`) | Corrigir o PATH no config (toolcache primeiro — ver comentário no próprio arquivo) + `systemctl --user restart forgejo-runner` (incidente 2026-08-17) |
| Build OOM no homeserver | Laptop 8c/16GB com o stack ativo (~12GB livres medidos) | Re-dispatch; se recorrente, item futuro: build na workstation com túnel |
| `checkout@v5` falha no job `host` | Label host do act_runner | Fallback: baixar o script direto do Forgejo (`curl -s https://git.solla.dev/fsolla/teqo/raw/branch/main/scripts/deploy-homeserver.sh`) |
| Migrate falha | Drift/erro de schema | Job vermelho; site segue no container antigo; corrigir e re-mergear |
| Smoke falha pós-up | Regressão de runtime | Rollback automático (restore + `up -d`) + job vermelho; investigar |
## Segurança (decisão deliberada)