Skip to content

Pass ASCII commit message to Cloudflare deploy#66

Merged
chris-colinsky merged 1 commit into
mainfrom
fix/docs-deploy-ascii-commit-message
May 24, 2026
Merged

Pass ASCII commit message to Cloudflare deploy#66
chris-colinsky merged 1 commit into
mainfrom
fix/docs-deploy-ascii-commit-message

Conversation

@chris-colinsky
Copy link
Copy Markdown
Member

Summary

  • Adds --commit-hash and --commit-message flags to the wrangler pages deploy command in .github/workflows/docs.yml
  • Cloudflare deployment records now use a SHA-based ASCII message instead of pulling from git HEAD's commit message

Why

PR #65's docs deploy failed with Invalid commit message, it must be a valid UTF-8 string. [code: 8000111] because the commit message contained section-sign and arrow glyphs. Files uploaded successfully; the deployment-record creation failed.

Passing an explicit ASCII commit message removes the dependency on the upstream git commit message's character set. The actual commit SHA stays attached via --commit-hash, so cross-referencing to GitHub still works.

Test plan

  • On merge, the next push to main runs the docs workflow and the Deploy to Cloudflare Pages step succeeds
  • Cloudflare dashboard shows the deployment with the SHA-based commit message

Cloudflare Pages' deployment API rejected the PR #65 docs deploy
with "Invalid commit message, it must be a valid UTF-8 string."
The commit message contained section sign and arrow glyphs which
the API does not accept despite being valid UTF-8.

Pass an explicit ASCII commit message based on the GitHub SHA so
the deploy step is no longer coupled to the upstream git commit
message's character set.
Copilot AI review requested due to automatic review settings May 24, 2026 20:46
Copy link
Copy Markdown

Copilot AI left a comment

Choose a reason for hiding this comment

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

Pull request overview

Updates the docs deployment workflow to avoid Cloudflare Pages deployment record failures caused by certain Unicode characters in upstream git commit messages, by explicitly supplying an ASCII-only commit message while still associating the deploy with the exact GitHub SHA.

Changes:

  • Passes --commit-hash and an ASCII-only --commit-message to wrangler pages deploy in the docs workflow.
  • Adds inline workflow documentation explaining the Cloudflare UTF-8 validation failure mode and why the SHA is sufficient for traceability.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

@chris-colinsky chris-colinsky merged commit d923c3e into main May 24, 2026
7 checks passed
@chris-colinsky chris-colinsky deleted the fix/docs-deploy-ascii-commit-message branch May 24, 2026 20:48
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.

2 participants