fix(ci): timeout dos jobs de docs e backend_path no generate-docs (o que os ci-templates do infra tinham a mais) #54

Merged

tarcisio merged 1 commit from fix/INFRA-ci-templates-do-infra into main

2026-10-07 17:41:22 -03:00

tmf-ia commented

2026-10-07 17:21:20 -03:00

Owner

O que os `ci-templates/` do TMF/infra tinham a mais

ADR 0018 (inativar o TMF/infra), item 5: antes de descartar a cópia do infra, comparar com os reusáveis daqui e trazer o que ela tiver de correção a mais.

Comparados em 07/10/2026 (diff de docs-lint.yml, sync-docs-to-hub.yml e generate-docs.yml.tmpl do infra contra .forgejo/workflows/ daqui). O ci-shared é mais novo em tudo (pipefail com controle negativo, imagem :3.12, TMF_HUB_TENANT_TOKEN, sem bloco secrets:), menos em duas coisas, que este PR traz:

timeout-minutes nos jobs: sync-docs-to-hub 10, generate-docs 15. Sem teto, um Hub que não responde prende o slot do runner até o timeout global (3h).
generate-docs com o diretório do backend parametrizado: input backend_path (default backend, que mantém o comportamento de hoje) e scripts chamados por $GITHUB_WORKSPACE. O caminho fixo backend não serve ao TMF9 (backend/python).

docs-lint.yml: nada a trazer (a única diferença do infra era cat | head, que o ci-shared já corrigiu).

Verificação

YAML dos dois workflows carrega (yaml.load(..., Loader=yaml.BaseLoader))
python3 -m unittest discover -s tests/<suíte>: as 7 suítes com rc=0

O PR do infra que remove os ci-templates/ cita este.

🤖 Generated with Claude Code

https://claude.ai/code/session_01JMjEgk99UbPAt74dvqGX3q

## O que os `ci-templates/` do TMF/infra tinham a mais ADR 0018 (inativar o `TMF/infra`), item 5: antes de descartar a cópia do infra, comparar com os reusáveis daqui e trazer o que ela tiver de correção a mais. Comparados em 07/10/2026 (`diff` de `docs-lint.yml`, `sync-docs-to-hub.yml` e `generate-docs.yml.tmpl` do infra contra `.forgejo/workflows/` daqui). O ci-shared é mais novo em tudo (pipefail com controle negativo, imagem `:3.12`, `TMF_HUB_TENANT_TOKEN`, sem bloco `secrets:`), **menos em duas coisas**, que este PR traz: 1. `timeout-minutes` nos jobs: `sync-docs-to-hub` 10, `generate-docs` 15. Sem teto, um Hub que não responde prende o slot do runner até o timeout global (3h). 2. `generate-docs` com o diretório do backend parametrizado: input `backend_path` (default `backend`, que mantém o comportamento de hoje) e scripts chamados por `$GITHUB_WORKSPACE`. O caminho fixo `backend` não serve ao TMF9 (`backend/python`). `docs-lint.yml`: nada a trazer (a única diferença do infra era `cat | head`, que o ci-shared já corrigiu). ### Verificação - YAML dos dois workflows carrega (`yaml.load(..., Loader=yaml.BaseLoader)`) - `python3 -m unittest discover -s tests/<suíte>`: as 7 suítes com rc=0 O PR do infra que remove os `ci-templates/` cita este. 🤖 Generated with [Claude Code](https://claude.com/claude-code) https://claude.ai/code/session_01JMjEgk99UbPAt74dvqGX3q

tmf-ia added 1 commit

2026-10-07 17:21:20 -03:00

fix(ci): timeout dos jobs de docs e backend_path no generate-docs (vindos dos ci-templates do TMF/infra)

PR checks (ci-shared) / testes (pull_request) Successful in 2m37s

Details

11dee73f75

Comparação dos ci-templates do TMF/infra com os reusáveis daqui (ADR 0018,
item 5): o ci-shared é mais novo em tudo, menos em duas correções que só a
cópia do infra tinha:

- timeout-minutes nos jobs (sync-docs-to-hub: 10; generate-docs: 15);
- generate-docs com o diretório do backend parametrizado (input
  backend_path, default backend), e os scripts chamados por
  $GITHUB_WORKSPACE, que funciona em qualquer profundidade. O caminho fixo
  backend não serve ao TMF9 (backend/python).

Default preserva o comportamento atual dos callers.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01JMjEgk99UbPAt74dvqGX3q

tmf-ia referenced this pull request from a commit

2026-10-07 17:23:37 -03:00

chore: onda 4 da ADR 0018 — sai a documentação, os ci-templates e os restos