Skip to content

Serialize the Pages deploy job across refs - #42

Merged
DaoyuanLi2816 merged 1 commit into
mainfrom
fix/docs-pages-deploy-concurrency
Aug 5, 2026
Merged

Serialize the Pages deploy job across refs#42
DaoyuanLi2816 merged 1 commit into
mainfrom
fix/docs-pages-deploy-concurrency

Conversation

@DaoyuanLi2816

Copy link
Copy Markdown
Owner

The deploy versioned documentation job failed on the v0.6.1 tag push (run 30857762945), while the main build for the same release succeeded.

Cause: the workflow-level concurrency group is docs-${{ github.ref }}. A release produces two pushes with different refs — refs/heads/main and refs/tags/v0.6.1 — so they land in separate groups and run at the same time. Both then try to claim the single github-pages environment, and one deployment loses. The deployment record confirms it: github-pages for ref v0.6.1 is failure, and the later main deployment is success, which is why the site itself is fine.

This adds a job-level concurrency: pages to the deploy job only, so deployments serialize across every ref while the build and visual-gate jobs keep running in parallel per ref. Without it the race repeats on every tagged release.

Verified .github/workflows/docs.yml still parses as YAML. The real check is the workflow run on this PR.

@DaoyuanLi2816
DaoyuanLi2816 merged commit 72d7eb2 into main Aug 5, 2026
13 checks passed
@DaoyuanLi2816
DaoyuanLi2816 deleted the fix/docs-pages-deploy-concurrency branch August 5, 2026 04:32
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