Skip to content

ci(workflow): ⚙️ refactor pages workflow concurrency and artifact‑upload position - #8

Merged
Skixkk merged 2 commits into
mainfrom
ci/refactor-pages-workflow-concurrency-artifact
Aug 16, 2026
Merged

Skixkk merged 2 commits into
mainfrom
ci/refactor-pages-workflow-concurrency-artifact

Conversation

@Skixkk

@Skixkk Skixkk commented Aug 16, 2026

Copy link
Copy Markdown
Collaborator

Changes

  • Rename concurrency group to pages‑deploy and enable cancel‑in‑progress: true
    Automatically cancel stale running jobs to avoid deployment conflict and artifact overwriting
  • Move pages artifact upload step from build job to deploy job
    PR builds run compilation check only, no pages artifact will be generated
  • Add stricter conditional rule for deploy job
    Deployment executes only when pushing to main branch or manual workflow dispatch
  • Retain existing build logic, merge vitepress docs output into .output/public/docs

Purpose

Optimize CI/CD behavior, separate PR build verification and formal pages deployment.
Eliminate redundant artifacts and reduce race‑condition risk.

Impact

  • Only github‑actions workflow file is modified
  • Project source code remains unchanged

…oad position

- Rename concurrency group to `pages-deploy`, set `cancel-in-progress: true`
  Abort outdated running jobs automatically, prevent deployment race‑condition and artifact overwriting
- Move `actions/upload-pages-artifact` step from build job to deploy job
  PR stage completes compilation verification inside ephemeral runner without uploading pages artifact
- Strengthen deploy‑job condition: only push to main branch or manual dispatch triggers formal deployment
  Pull‑request will skip deploy job entirely
- Keep original build pipeline: build Nuxt main site, build VitePress docs and merge dist files into `.output/public/docs`

Reduce useless artifacts generated from PR builds, mitigate concurrent deployment coverage risk.

No related issues.
@Skixkk
Skixkk requested a review from Alininin August 16, 2026 17:45

@Skixkk Skixkk left a comment

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Workflow concurrency rule and artifact upload position updated.
PR will not produce pages artifacts, deployment only triggered on main push or manual run.
Checklist:

  • Concurrency group name corrected
  • cancel‑in‑progress set to true
  • Artifact upload moved into deploy job
  • Deploy job condition works correctly
    LGTM

@@ -49,20 +53,21 @@ jobs:
mkdir -p .output/public/docs
cp -r docs/.vitepress/dist/* .output/public/docs/

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

add debug directory‑listing step after docs copy

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

ok

- Insert debug shell step after vitepress dist copy operation
- Execute `ls -l -a` against `.output/public` and `.output/public/docs`
- Print directory contents to workflow log, convenient for troubleshooting missing docs files
- Keep all existing concurrency、artifact‑upload、deploy‑condition rules unchanged

Add visibility of merged output folder for deployment debugging, zero functional change.

No related issues.

@Skixkk Skixkk left a comment

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

added debug directory‑listing step after docs copy

@Skixkk
Skixkk merged commit 7d37a4b into main Aug 16, 2026
2 checks passed
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