Skip to content

fix(ci): restore PR previews with scoped publication credentials - #409

Merged
vitormattos merged 1 commit into
mainfrom
fix/preview-fork-pr-resolution
Nov 10, 2026
Merged

vitormattos merged 1 commit into
mainfrom
fix/preview-fork-pr-resolution

Conversation

@vitormattos

@vitormattos vitormattos commented Nov 10, 2026 •

Copy link
Copy Markdown
Member

Objetivo

Restaurar a geração de previews no mecanismo existente, sem criar infraestrutura ou scripts adicionais.

Duas causas foram confirmadas nos logs:

  1. Os previews publicavam normalmente até 22/10/2026. Uma alteração posterior no ruleset de LibreCodeCoop/site-preview/main passou a exigir pull request, embora LibreSign/pr-preview-action publique diretamente nessa branch. Os pushes começaram a falhar com GH013 (ex.: execução #42873622462).
  2. No fork externo #405, workflow_run.pull_requests veio vazio. O workflow antigo ignorava download e deploy e terminava verde sem publicar (ex.: execução #42667607139).

Alterações deste PR

Apenas .github/workflows/preview-deploy.yml foi alterado; sem scripts Python, código PHP novo, branch de deploy ou serviço adicional.

  • Usa gh pr view para identificar PRs internos e de forks e compara o SHA do build, o repositório de origem, o estado aberto e a branch de destino main. Se a associação falhar, o job falha em vez de reportar sucesso falso.
  • Substitui o PAT persistente PREVIEW_TOKEN por token de instalação de GitHub App dedicada, com validade curta, repositório site-preview somente e permissão contents:write somente. A geração usa actions/create-github-app-token v3.3.0, fixada em SHA e compatível com Node 24.
  • Remove o gatilho de fechamento de PR que nunca executava trabalho de remoção (a condição do único job o descartava).
  • Mantém o build sem segredos e a publicação privilegiada separada, LibreSign/pr-preview-action, site-preview/main e GitHub Pages.

Validações realizadas

  • YAML carregado e shell com bash -n.
  • Regressões locais: PR externo, PR interno, SHA desatualizado, repositório incorreto, PR fechado e base incorreta.
  • Consultas reais gh pr view para os PRs Atualização da url Entendendo a sociedade cooperativa  #405 e fix(ci): restore PR previews with scoped publication credentials #409, com comparação de SHA e origem.
  • Uma publicação anterior do fix(ci): restore PR previews with scoped publication credentials #409 foi confirmada no GitHub Pages com HTTP 200 depois da correção emergencial do ruleset; isso validou a infraestrutura, não a nova autenticação.
  • Histórico consolidado em um commit com assinatura verificada e DCO.
  • Todos os checks do SHA final passaram: DCO, PHPUnit, Composer Validate, ShellCheck, Preview Build e Docker PHP Publish.
  • A publicação atual de previews foi novamente validada após o commit final (GitHub Pages, HTTP 200).
  • Homologar a emissão do token da App dedicada e o deploy com bypass após registrar/instalar a App e integrar este PR.

Configuração de segurança necessária ANTES do merge

A App dedicada ainda não está registrada. Não integrar este PR até provisioná-la. Não reutilizar librecode-workflow-automation: sua chave é um segredo organizacional compartilhado e não isola a identidade de publicação.

  1. Registrar GitHub App da organização LibreCodeCoop dedicada a previews, com apenas Contents: read/write e Metadata: read, sem Workflows ou Administration. Instalar somente em LibreCodeCoop/site-preview.
  2. Em LibreCodeCoop/site, criar variável de repositório SITE_PREVIEW_APP_CLIENT_ID com o client ID e segredo de repositório SITE_PREVIEW_APP_PRIVATE_KEY com a chave privada (PEM). Não disponibilizar a chave como segredo organizacional.
  3. No ruleset #26982684, criado em evaluate para não interromper os previews atuais, cadastrar a App no bypass como Integration, modo always, usando o App ID numérico.
  4. Fazer o merge somente após revisão e provisionamento. Homologar um PR interno e o fork externo Atualização da url Entendendo a sociedade cooperativa  #405 (cujo build ainda depende de autorização do GitHub). Então alterar o ruleset #26982684 de evaluate para active. O ruleset #22483057 continuará proibindo exclusão e force-push, sem bypass permanente da App.
  5. Após a publicação com App funcionar e a proteção estar ativa, remover/revogar o antigo PREVIEW_TOKEN se não houver mais consumidores.

Estado atual: ruleset #22483057 ativo (sem exclusão/force-push); novo ruleset #26982684 em avaliação, portanto a exigência de PR ainda não está imposta. Isso evita interromper novamente a publicação antes do novo token ser provisionado. Este PR está pronto para análise do código, mas ainda não está pronto para merge.

Relacionado: #405.

@vitormattos vitormattos changed the title fix(ci): restore previews for pull requests from forks fix(ci): resolve preview PRs from forks without extra scripts Nov 10, 2026
@github-actions

github-actions Bot commented Nov 10, 2026 •

Copy link
Copy Markdown
Contributor
PR Preview Action v1.8.1-4-g2a6da11

QR code for preview link

🚀 View preview at
https://librecodecoop.github.io/site-preview/pr-preview/pr-409/

Built to branch main at 2026-11-10 21:26 UTC.
Preview will be ready when the GitHub Pages deployment is complete.

@vitormattos vitormattos changed the title fix(ci): resolve preview PRs from forks without extra scripts fix(ci): restore stable PR previews without extra infrastructure Nov 10, 2026
Signed-off-by: Vitor Mattos <1079143+vitormattos@users.noreply.github.com>
@vitormattos
vitormattos force-pushed the fix/preview-fork-pr-resolution branch from fbfc4f9 to cf92eaf Compare November 10, 2026 21:25
@vitormattos vitormattos changed the title fix(ci): restore stable PR previews without extra infrastructure fix(ci): restore PR previews with scoped publication credentials Nov 10, 2026
@vitormattos
vitormattos merged commit f411ee1 into main Nov 10, 2026
6 checks passed
@vitormattos
vitormattos deleted the fix/preview-fork-pr-resolution branch November 10, 2026 22:13
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant