Skip to content

refactor: align cloudflare docs deployment with preview-promote pattern#45

Draft
cameronraysmith wants to merge 22 commits intopnt-5vr-nix2containerfrom
pnt-yty-cloudflare-docs-alignment
Draft

refactor: align cloudflare docs deployment with preview-promote pattern#45
cameronraysmith wants to merge 22 commits intopnt-5vr-nix2containerfrom
pnt-yty-cloudflare-docs-alignment

Conversation

@cameronraysmith
Copy link
Collaborator

No description provided.

Align JavaScript tooling with vanixiets and typescript-nix-template
by switching from yarn-berry to bun in the Nix devshell.
Pin [email protected] to match vanixiets and typescript-nix-template versions.
Yarn Berry configuration no longer needed after migration to bun.
Remove yarn-specific ignores (.yarn/*, .pnp.*) and add .wrangler/
cache directory alongside node_modules/.
Mark bun.lock as linguist-generated instead of yarn.lock.
Replace yarn dlx wrangler with bunx wrangler in docs recipes and
yarn/yarn workspace with bun run/bun --filter in release recipes.
Ensure cached-ci-job cache key tracks the correct lockfile.
Remove yarn Berry lockfile after migration to bun.
Initial bun lockfile from existing package.json dependencies.
Replace simple docs-deploy and docs-preview-deploy with aligned
vanixiets/tnt patterns: docs-deploy-preview with branch sanitization,
SHA tagging, and git metadata; docs-deploy-production with version
promotion logic that falls back to direct deploy. Add docs-versions,
docs-deployments, and docs-tail utility recipes. All wrangler commands
wrapped with sops exec-env for consistent credential injection.
Replace two-job build/deploy workflow with single-job pattern matching
vanixiets and typescript-nix-template. Key changes: use setup-nix
composite action instead of DeterminateSystems installer, add
cached-ci-job execution caching, support preview vs production
environment branching, delegate deployment logic to justfile recipes
(docs-deploy-preview and docs-deploy-production) which handle build
internally via quarto. Remove artifact upload/download between jobs
since the single-job pattern eliminates the need for inter-job
artifact transfer.
Merge test-docs-build and test-docs-deploy into a single test-docs-deploy
recipe with environment parameter, matching the single-job deploy-docs
workflow structure.
…onment param

Align the remote workflow trigger recipe with the new single-job
workflow that supports both preview and production environments.
Add wrangler config schema for IDE validation and enable observability
to match vanixiets/tnt patterns. Keep repo-root location and docs/_site
assets directory appropriate for Quarto output.
…view

Port from typescript-nix-template. Creates a temporary git worktree,
simulates merging the current branch into the target via git merge-tree,
then runs semantic-release in dry-run mode to predict the next version.
Outputs a colored "next version: X.Y.Z" line that CI can extract for
GitHub annotations.
Four changes to ci.yaml:
- Add sanitized_branch computation to set-variables for subdomain-safe
  preview aliases
- Remove docs-preview label requirement from preview-docs job so it
  runs on every PR (matching vanixiets/tnt pattern), pass full inputs
  (environment, sanitized_branch, force_run) to deploy-docs workflow
- Pass environment and force_run inputs to production deploy-docs job
- Add ::notice GitHub annotations to preview-release-version job that
  extract the predicted next version from preview-version.sh output
…on.sh

Replace inline bun-based preview-version recipe with delegation to the
merge-simulated script, matching vanixiets/tnt pattern. The script
creates a temporary worktree, simulates the merge, and runs
semantic-release dry-run for accurate version prediction.
The preview-version.sh script requires a local refs/heads/main branch
for git merge-tree simulation, but CI checkout only creates a local
branch for the PR ref. Add steps to create the local main branch from
origin/main, fetch tags for semantic-release version detection, and
configure git identity for temporary merge commits.
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