메뉴
Add a GitHub Actions workflow that deploys to Fly.io on merge to main, with db migrations run as a Fly release_command. Use when: adding a deploy workflow, deploying on merge, setting up continuous deployment to Fly.io. Building block for create-website.
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
| name | fly-deploy-workflow |
| description | Add a GitHub Actions workflow that deploys to Fly.io on merge to main, with db migrations run as a Fly release_command. Use when: adding a deploy workflow, deploying on merge, setting up continuous deployment to Fly.io. Building block for create-website. |
Add .github/workflows/fly-deploy.yml: on push to main, deploy to Fly.io. Migrations run as a Fly release_command, so they execute against prod right before the new version starts serving — the workflow itself stays a plain deploy.
fly.toml exists (if not, follow the fly-new-app skill first).fly tokens create deploy --app <app-name>
gh secret set FLY_API_TOKEN
In fly.toml:
# Call tsx directly instead of `pnpm db:migrate`: the runtime image has no
# pnpm-lock.yaml, so pnpm's pre-run dependency check would kick off a full
# re-install of everything (and time the release machine out).
[deploy]
release_command = 'node_modules/.bin/tsx src/db/migrate.ts'
This needs three things in place (the setup-astro-repo skill sets them up):
src/db/migrate.ts applying the ./drizzle migrations via drizzle-orm/libsql/migratortsx in dependencies (not devDependencies — the runtime image only has prod deps)# Migration inputs for the Fly release_command
COPY drizzle ./drizzle
COPY src/db ./src/db
Exception: if migrations can't run from the runtime image (e.g. Better Auth's CLI needs the TS config and dev deps), run them from CI instead — add a migrate step before flyctl deploy with TURSO_DATABASE_URL/TURSO_AUTH_TOKEN repo secrets.
# See https://fly.io/docs/app-guides/continuous-deployment-with-github-actions/
name: Fly Deploy
on:
push:
branches:
- main
jobs:
deploy:
name: Deploy app
runs-on: ubuntu-latest
timeout-minutes: 15
concurrency: deploy-group
steps:
- uses: actions/checkout@v6
- uses: superfly/flyctl-actions/setup-flyctl@master
- run: flyctl deploy --remote-only
env:
FLY_API_TOKEN: ${{ secrets.FLY_API_TOKEN }}
Keep schema changes backward-compatible with the still-running old version — the release command migrates before the new machines take over.
On the next merge to main, watch the run (gh run watch) and confirm the release command succeeded and the app is healthy: fly status --app <app-name>.
Scaffold a web repo with pnpm, Astro, and astro-bulma — plus Drizzle when the site needs a database — including package.json scripts for build/lint/test/fmt (and db:migrate when db-backed). Use when: setting up a new Astro project, scaffolding a web repo, initializing the standard web stack. Building block for create-website.
Add a GitHub Actions CI workflow running build, lint, test, and fmt checks with pnpm. Use when: adding CI, setting up GitHub Actions checks, adding a build/lint/test workflow. Building block for create-website.
Create a new website end-to-end: Astro repo with pnpm/astro-bulma; GitHub Pages for static sites, or Turso + Fly.io when the site needs a database; GitHub Actions for CI and deploy. Use when: creating a new website, spinning up a new web project, new site, scaffolding a static or full-stack Astro project.
Create a new app on Fly.io for the current project without deploying it, generating fly.toml and a Dockerfile. Use when: creating a Fly.io app, setting up Fly hosting, fly launch. Building block for create-website.
Add a GitHub Actions workflow that builds a static site and deploys it to GitHub Pages, with an optional custom domain. Use when: deploying a static site, GitHub Pages hosting, static site with a custom domain. Building block for create-website.
Add a GitHub Actions workflow that spins up a temporary Fly.io preview app per pull request, backed by a fork of the production Turso database, and destroys both on close. Use when: adding PR previews, review apps, per-PR deploy environments.