flyio-upgrade-migration
Migrate between Fly.io platform versions including Apps v1 to v2 (Machines), flyctl upgrades, and Postgres major version upgrades. Trigger: "fly.io upgrade", "fly.io migration", "fly apps v2", "fly postgres upgrade".
Best use case
flyio-upgrade-migration is best used when you need a repeatable AI agent workflow instead of a one-off prompt.
Migrate between Fly.io platform versions including Apps v1 to v2 (Machines), flyctl upgrades, and Postgres major version upgrades. Trigger: "fly.io upgrade", "fly.io migration", "fly apps v2", "fly postgres upgrade".
Teams using flyio-upgrade-migration should expect a more consistent output, faster repeated execution, less prompt rewriting.
When to use this skill
- You want a reusable workflow that can be run more than once with consistent structure.
When not to use this skill
- You only need a quick one-off answer and do not need a reusable workflow.
- You cannot install or maintain the underlying files, dependencies, or repository context.
Installation
Claude Code / Cursor / Codex
Manual Installation
- Download SKILL.md from GitHub
- Place it in
.claude/skills/flyio-upgrade-migration/SKILL.mdinside your project - Restart your AI agent — it will auto-discover the skill
How flyio-upgrade-migration Compares
| Feature / Agent | flyio-upgrade-migration | Standard Approach |
|---|---|---|
| Platform Support | Not specified | Limited / Varies |
| Context Awareness | High | Baseline |
| Installation Complexity | Unknown | N/A |
Frequently Asked Questions
What does this skill do?
Migrate between Fly.io platform versions including Apps v1 to v2 (Machines), flyctl upgrades, and Postgres major version upgrades. Trigger: "fly.io upgrade", "fly.io migration", "fly apps v2", "fly postgres upgrade".
Where can I find the source code?
You can find the source code on GitHub using the link provided at the top of the page.
Related Guides
Best AI Skills for Claude
Explore the best AI skills for Claude and Claude Code across coding, research, workflow automation, documentation, and agent operations.
ChatGPT vs Claude for Agent Skills
Compare ChatGPT and Claude for AI agent skills across coding, writing, research, and reusable workflow execution.
SKILL.md Source
# Fly.io Upgrade & Migration ## Overview Guide for Fly.io platform migrations: Apps v1 (Nomad) to v2 (Machines), flyctl CLI upgrades, Postgres major version upgrades, and region migrations. ## Instructions ### Apps v1 to v2 Migration ```bash # Check current platform version fly status -a my-app # Look for "Platform: machines" vs "nomad" # Migrate to Apps v2 (Machines) fly migrate-to-v2 -a my-app # Verify fly status -a my-app fly machine list -a my-app ``` ### flyctl CLI Upgrade ```bash # Check current version fly version # Upgrade fly version update # Or reinstall curl -L https://fly.io/install.sh | sh ``` ### Postgres Major Version Upgrade ```bash # Check current version fly postgres connect -a my-db -c "SELECT version();" # Create new cluster with target version fly postgres create --name my-db-v16 --region iad --image-ref flyio/postgres-flex:16 # Migrate data fly postgres import pg_dump_url -a my-db-v16 # Update app to point to new cluster fly postgres detach my-db -a my-app fly postgres attach my-db-v16 -a my-app fly deploy -a my-app # Picks up new DATABASE_URL ``` ### Region Migration ```bash # Add machines in new region fly scale count 1 --region fra -a my-app # Verify new region is healthy fly status -a my-app # Remove machines from old region fly scale count 0 --region iad -a my-app # For volumes: create new volume, migrate data, destroy old fly volumes create data --size 10 --region fra -a my-app ``` ## Migration Checklist - [ ] Current state documented (`fly status`, `fly scale show`) - [ ] Database backed up before migration - [ ] Tested migration in staging app first - [ ] DNS/certificates transferred if changing domains - [ ] Monitoring confirms healthy after cutover - [ ] Old resources cleaned up ## Resources - [Apps v2 Migration](https://fly.io/docs/reference/apps/) - [Postgres Upgrades](https://fly.io/docs/postgres/) ## Next Steps For CI integration, see `flyio-ci-integration`.
Related Skills
workhuman-upgrade-migration
Workhuman upgrade migration for employee recognition and rewards API. Use when integrating Workhuman Social Recognition, or building recognition workflows with HRIS systems. Trigger: "workhuman upgrade migration".
wispr-upgrade-migration
Wispr Flow upgrade migration for voice-to-text API integration. Use when integrating Wispr Flow dictation, WebSocket streaming, or building voice-powered applications. Trigger: "wispr upgrade migration".
windsurf-upgrade-migration
Upgrade Windsurf IDE, migrate settings from VS Code or Cursor, and handle breaking changes. Use when upgrading Windsurf versions, migrating from another editor, or handling configuration changes after updates. Trigger with phrases like "upgrade windsurf", "windsurf update", "migrate to windsurf", "windsurf from cursor", "windsurf from vscode".
windsurf-migration-deep-dive
Migrate to Windsurf from VS Code, Cursor, or other AI IDEs with full configuration transfer. Use when migrating a team to Windsurf, transferring Cursor rules, or evaluating Windsurf against other AI editors. Trigger with phrases like "migrate to windsurf", "switch to windsurf", "windsurf from cursor", "windsurf from copilot", "windsurf evaluation".
webflow-upgrade-migration
Analyze, plan, and execute Webflow SDK upgrades (webflow-api v1 to v3) with breaking change detection, API v1-to-v2 migration, and deprecation handling. Trigger with phrases like "upgrade webflow", "webflow migration", "webflow breaking changes", "update webflow SDK", "webflow v1 to v2".
webflow-migration-deep-dive
Execute major Webflow migrations — from other CMS platforms to Webflow CMS, between Webflow sites, or large-scale content re-architecture using the Data API v2 bulk endpoints, strangler fig pattern, and data validation. Trigger with phrases like "migrate to webflow", "webflow migration", "import into webflow", "webflow replatform", "move content to webflow", "webflow bulk import", "wordpress to webflow".
vercel-upgrade-migration
Upgrade Vercel CLI, Node.js runtime, and Next.js framework versions with breaking change detection. Use when upgrading Vercel CLI versions, migrating Node.js runtimes, or updating Next.js between major versions on Vercel. Trigger with phrases like "upgrade vercel", "vercel migration", "vercel breaking changes", "update vercel CLI", "next.js upgrade on vercel".
vercel-migration-deep-dive
Migrate to Vercel from other platforms or re-architecture existing Vercel deployments. Use when migrating from Netlify, AWS, or Cloudflare to Vercel, or when re-platforming an existing Vercel application. Trigger with phrases like "migrate to vercel", "vercel migration", "switch to vercel", "netlify to vercel", "aws to vercel", "vercel replatform".
veeva-upgrade-migration
Veeva Vault upgrade migration for REST API and clinical operations. Use when working with Veeva Vault document management and CRM. Trigger: "veeva upgrade migration".
veeva-migration-deep-dive
Veeva Vault migration deep dive for enterprise operations. Use when implementing advanced Veeva Vault patterns. Trigger: "veeva migration deep dive".
vastai-upgrade-migration
Upgrade Vast.ai CLI, migrate API versions, and handle breaking changes. Use when upgrading vastai CLI, detecting deprecations, or migrating between API versions. Trigger with phrases like "upgrade vastai", "vastai migration", "vastai breaking changes", "update vastai CLI".
vastai-migration-deep-dive
Migrate GPU workloads to or from Vast.ai, or between GPU providers. Use when switching from AWS/GCP/Azure GPU instances to Vast.ai, migrating between GPU types, or re-platforming ML infrastructure. Trigger with phrases like "migrate to vastai", "vastai migration", "switch to vastai", "vastai from aws", "vastai from lambda".