Fix GitHub Pages deployment failure on release events #163
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
The deployment was failing because GitHub Pages environment protection rules don't allow deployments from tags. This fix removes the 'release' event from the deployment conditions while keeping it for the build step to validate docs on releases. The workflow will now only deploy to GitHub Pages on: - Push to master branch - Manual workflow_dispatch trigger Co-authored-by: jacksonpradolima <[email protected]>
Copilot
AI
changed the title
[WIP] Fix GitHub Pages deployment error for version tag
Fix GitHub Pages deployment failure on release events
Jan 1, 2026
Contributor
There was a problem hiding this comment.
Pull request overview
This PR fixes a GitHub Pages deployment failure that occurred when the workflow was triggered by release events. Tag refs are rejected by GitHub Pages environment protection rules, causing deployment failures.
Key Changes:
- Removed
releaseevent from deployment conditions in both the "Upload Pages artifact" and "Deploy to GitHub Pages" steps - Deployment now only occurs on push to
masterbranch or manualworkflow_dispatchtriggers - Documentation still builds on releases for validation purposes without attempting deployment
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
|
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
GitHub Pages environment protection rules reject deployments from tag refs. The workflow was attempting to deploy when triggered by
releaseevents, causing failures like: "Tag 'v3.2.7' is not allowed to deploy to github-pages due to environment protection rules."Changes
releaseevent from deployment conditions in.github/workflows/docs.ymlmasterorworkflow_dispatchDocumentation updates will continue to deploy automatically on merges to
master.Original prompt
💬 We'd love your input! Share your thoughts on Copilot coding agent in our 2 minute survey.