Skip to content

fix(ci): avoid waiting for superseded Pages builds - #534

Merged
vitormattos merged 3 commits into
mainfrom
fix/preview-pages-coalescing-20261111
Nov 11, 2026
Merged

vitormattos merged 3 commits into
mainfrom
fix/preview-pages-coalescing-20261111

Conversation

@vitormattos

@vitormattos vitormattos commented Nov 11, 2026 •

Copy link
Copy Markdown
Member

Causa reproduzida

O preview do PR #531 foi compilado e enviado com sucesso ao repositório LibreSign/site-preview/gh-pages. O check falhou depois do push, ao esperar que o GitHub Pages concluísse a build do commit 96b58a1. Outra publicação no mesmo repositório (documentação, PR #149) cancelou aquela build; a publicação seguinte terminou com sucesso. A URL do #531 permaneceu disponível.

O problema é a dependência do status de uma execução específica do Pages em uma branch de publicação compartilhada. Não é erro no conteúdo nem na compilação do site.

Solução mínima, alinhada ao LibreCodeCoop/site#409

  • Em .github/workflows/preview.yml, definir wait-for-pages-deployment: false, mantendo a action e o deploy atuais.
  • Em .github/workflows/preview-fork-deploy.yml, aplicar a mesma opção e corrigir a identificação do PR externo: workflow_run.pull_requests pode vir vazio. Resolver pelo repositório/branch de origem e validar PR aberto, base main, repositório e SHA antes de publicar o artefato.
  • Conferir somente que o artefato baixado contém index.html.

Sem shell script novo, sem preview-revision.txt, sem polling ou verificação adicional por HTTP, sem nova infraestrutura ou novos segredos. A publicação assíncrona pode demorar alguns segundos para chegar à URL pública, como no site da LibreCode. O sucesso da action indica que os arquivos foram enviados, não que o GitHub Pages concluiu a propagação.

Evidências e validação

  • Logs do workflow #42942991391: build e push da prévia concluídos; a espera por Pages falhou devido ao build suplantado.
  • Registros do repositório site-preview: build do commit 96b58a1 cancelada, build sucessora e7abd17 concluída com sucesso.
  • A lógica gh pr view segue o fluxo que já existe em LibreCodeCoop/site#409.
  • O SHA atual 78e70268784774644262c471a38d5f0639c69970 passou em todos os 8 checks reportados pelo GitHub Actions, incluindo o próprio preview (com duas execuções bem-sucedidas de validate-lang). A action compilou e publicou o site com sucesso. A prévia pública do PR #534 também foi aberta e seu HTML foi confirmado.
  • Os commits são assinados criptograficamente, com DCO.
  • O fluxo de fork necessita de um PR efetivamente originado de fork para comprovação ponta a ponta; o PR atual é interno.

Escopo

Alterações finais restritas a dois workflows existentes. A proposta não altera o PR editorial #531, não faz merge nem deploy de produção.

Após revisão e merge deste PR, atualizar o #531 com a main para que seu preview execute a nova configuração.

Signed-off-by: Vitor Mattos <1079143+vitormattos@users.noreply.github.com>
Signed-off-by: Vitor Mattos <1079143+vitormattos@users.noreply.github.com>
@github-actions

github-actions Bot commented Nov 11, 2026 •

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

QR code for preview link

🚀 View preview at
https://libresign.github.io/site-preview/pr-preview/pr-534/

Built to branch gh-pages at 2026-11-11 03:16 UTC.
Preview will be ready when the GitHub Pages deployment is complete.

Signed-off-by: Vitor Mattos <1079143+vitormattos@users.noreply.github.com>
@vitormattos vitormattos changed the title fix(ci): verify public previews without Pages deployment race fix(ci): avoid waiting for superseded Pages builds Nov 11, 2026
@vitormattos
vitormattos merged commit c8b81a8 into main Nov 11, 2026
9 checks passed
@vitormattos
vitormattos deleted the fix/preview-pages-coalescing-20261111 branch November 11, 2026 03:27
@github-actions

Copy link
Copy Markdown
Contributor

🚀 Starting production deploy of site header and footer fragments...

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