Skip to content

feat: Move deployment to Cloudflare#263

Closed
JPeer264 wants to merge 1 commit intomainfrom
jp/move-to-cloudflare
Closed

feat: Move deployment to Cloudflare#263
JPeer264 wants to merge 1 commit intomainfrom
jp/move-to-cloudflare

Conversation

@JPeer264
Copy link
Member

Description

This moves everything from GH Pages to Cloudflare Workers (Sentry is not yet included).

Available here: https://sentry-conventions.getsentry.workers.dev/
Everything will be automatically deployed when it gets pushed to main

PR Checklist

  • I have run yarn test and verified that the tests pass.
  • I have run yarn generate && yarn format to generate and format code and docs.
    • I ran it, but it failed with files I haven't touched (I'm going to check if the PR jobs are failing)

If an attribute was added:

  • The attribute is in a namespace (e.g. nextjs.function_id, not function_id)
  • I have used the correct value for pii (i.e. maybe or true. Use false only for values that should never be scrubbed such as IDs)

If an attribute was deprecated:

@cloudflare-workers-and-pages
Copy link

cloudflare-workers-and-pages bot commented Feb 23, 2026

Deploying with  Cloudflare Workers  Cloudflare Workers

The latest updates on your project. Learn more about integrating Git with Workers.

Status Name Latest Commit Updated (UTC)
❌ Deployment failed
View logs
sentry-conventions 61cbb66 Feb 23 2026, 09:09 AM

@JPeer264 JPeer264 self-assigned this Feb 23, 2026
@github-actions
Copy link

github-actions bot commented Feb 23, 2026

Semver Impact of This PR

🟡 Minor (new features)

📋 Changelog Preview

This is how your changes will appear in the changelog.
Entries from this PR are highlighted with a left border (blockquote style).


New Features ✨

  • Move deployment to Cloudflare by JPeer264 in #263

Bug Fixes 🐛

  • (gen_ai) Input and output token description by obostjancic in #261

Documentation 📚

  • Update README with up-to-date links by ericapisani in #258

Internal Changes 🔧

  • (deps) Bump svelte from 5.48.1 to 5.51.5 by dependabot in #260
  • (deps-dev) Bump tar from 7.5.7 to 7.5.8 by dependabot in #259

🤖 This preview updates automatically when you update the PR.

@JPeer264 JPeer264 force-pushed the jp/move-to-cloudflare branch from 1d163d2 to 61cbb66 Compare February 23, 2026 09:08
Comment on lines 8 to 14
export default defineConfig({
integrations: [svelte(), tailwind()],
// Configure for GitHub Pages - the site will be at https://getsentry.github.io/sentry-conventions/
site: 'https://getsentry.github.io',
base: '/sentry-conventions/',
output: 'static',
site: 'https://sentry-conventions.getsentry.workers.dev',
adapter: cloudflare({
imageService: 'compile',
}),
});
Copy link

Choose a reason for hiding this comment

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

Bug: Removing output: 'static' switches the site to SSR mode, which breaks the pagefind search indexing step as it requires pre-rendered HTML files that are no longer generated.
Severity: HIGH

Suggested Fix

To fix this, either restore static site generation by re-adding output: 'static' to astro.config.mjs, or if SSR is intended, add export const prerender = true to all pages that need to be indexed by Pagefind. This will ensure the necessary HTML files are available during the build.

Prompt for AI Agent
Review the code at the location below. A potential bug has been identified by an AI
agent.
Verify if this is a real issue. If it is, propose a fix; if not, explain why it's not
valid.

Location: docs/astro.config.mjs#L8-L14

Potential issue: The Astro configuration was changed to use the Cloudflare adapter, and
`output: 'static'` was removed. This causes the site to default to server-side rendering
(SSR). The build process includes a `postbuild` step that runs `pagefind --site dist` to
generate a search index. Pagefind requires pre-rendered HTML files in the `dist/`
directory. In SSR mode without any `export const prerender = true` flags, the `dist/`
directory will contain a server worker bundle, not static HTML files. As a result,
Pagefind will have no content to index, causing the search feature to break or the build
to fail.

Comment on lines 68 to 69

### Adding a new page
Copy link

Choose a reason for hiding this comment

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

Bug: The README.md file contains hardcoded links to the old GitHub Pages deployment, which will be broken after the migration to Cloudflare Workers.
Severity: MEDIUM

Suggested Fix

Update the hardcoded links in docs/README.md to point to the new Cloudflare Workers URLs. For example, change https://getsentry.github.io/sentry-conventions/attributes/ to https://sentry-conventions.getsentry.workers.dev/attributes/.

Prompt for AI Agent
Review the code at the location below. A potential bug has been identified by an AI
agent.
Verify if this is a real issue. If it is, propose a fix; if not, explain why it's not
valid.

Location: docs/README.md#L68-L69

Potential issue: The root `README.md` file contains hardcoded links pointing to the old
GitHub Pages deployment (`https://getsentry.github.io/sentry-conventions/...`). With the
migration to Cloudflare Workers, the site's URL has changed and the
`/sentry-conventions/` base path has been removed. The old links will no longer be
valid, leading users who click them to a broken or non-existent page. This affects the
primary entry point for users trying to access the generated documentation from the
repository's main page.

Copy link

@cursor cursor bot left a comment

Choose a reason for hiding this comment

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

Cursor Bugbot has reviewed your changes and found 1 potential issue.

Bugbot Autofix is OFF. To automatically fix reported issues with Cloud Agents, enable Autofix in the Cursor dashboard.

site: 'https://sentry-conventions.getsentry.workers.dev',
adapter: cloudflare({
imageService: 'compile',
}),
Copy link

Choose a reason for hiding this comment

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

GitHub Pages workflow deploys broken site after config change

Medium Severity

The removal of base: '/sentry-conventions/' and change of site to the Cloudflare URL breaks the existing .github/workflows/docs.yml workflow, which still runs on every push to main and deploys to GitHub Pages. The built site will have all URLs relative to / instead of /sentry-conventions/, so the GitHub Pages deployment at getsentry.github.io/sentry-conventions/ will serve a completely broken site with missing assets and broken links. The old workflow needs to be removed or replaced with a Cloudflare deployment workflow.

Fix in Cursor Fix in Web

@JPeer264
Copy link
Member Author

Closed as won't do as discussed offline. The code is here in case we would need it in the future

@JPeer264 JPeer264 closed this Feb 23, 2026
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