Skip to content

Fill gaps from assistant conversations: step-by-step Flightcontrol migration - #44

Merged
flybayer merged 3 commits into
mainfrom
mintlify/c457f484
Aug 11, 2026
Merged

Fill gaps from assistant conversations: step-by-step Flightcontrol migration#44
flybayer merged 3 commits into
mainfrom
mintlify/c457f484

Conversation

@mintlify

@mintlify mintlify Bot commented Aug 10, 2026

Copy link
Copy Markdown
Contributor

Summary

Adds an explicit ordered migration procedure to the Flightcontrol migration page so readers can complete the migration without asking the assistant to synthesize the steps.

Changes

  • New "Step-by-step migration" section on migrate/from-flightcontrol.mdx, placed between the service-type mapping table and "Migrating services".
  • States up front that there is no one-click migration and that it's piecemeal.
  • Points readers at the AI-agent workflow for drafting ravion.yaml from an existing Flightcontrol config, using the Docs MCP and the mapping table.
  • Calls out provision-vs-import decision per service type and links to both import guides.
  • Explicit "do not redeploy in Flightcontrol during migration" — Ravion runs alongside, and cutover happens through DNS.

Context

Recent assistant conversations showed users asking whether there's a one-click migration, whether they can use an AI agent to convert their Flightcontrol config, and whether they should keep deploying in Flightcontrol during migration. The mapping table and per-service notes were already on the page, but the ordered flow tying it all together was missing.

@mintlify
mintlify Bot requested a review from flybayer as a code owner August 10, 2026 13:09
@mintlify

mintlify Bot commented Aug 10, 2026

Copy link
Copy Markdown
Contributor Author

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
Ravion 🟢 Ready View Preview Aug 10, 2026, 1:09 PM

@greptile-apps

greptile-apps Bot commented Aug 10, 2026

Copy link
Copy Markdown

PR author is not in the allowed authors list.

Comment thread migrate/from-flightcontrol.mdx Outdated

Point the agent at [Start here (human + agent)](/start-here) and this page so it has the mapping table above and the [project config file workflow](/config-as-code/project-config-file#agent-tips).

Verify the draft against the mapping table before applying anything. `rvn-ecs-web` and `rvn-ecs-worker` both require an `rvn-ecs-cluster`, and `rvn-cloudfront` is now opt-in per service instead of always-on.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

remove this line

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Removed.

**Do not redeploy in Flightcontrol during migration.** New deploys go through Ravion from this point on. The Flightcontrol service keeps serving old traffic until DNS moves and you delete it.
</Step>

<Step title="Delete the migrated Flightcontrol services">

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

we need a big warning here to not delete an imported service from FC, contact support to have us remove it from your account, we are working on self serve delete from FC without destroy

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Added a Warning in that step: never delete an imported service in Flightcontrol (it destroys the AWS resources Ravion now manages) — contact support to have it removed without destroy, self-serve coming.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

but remove the stop deploying anything, that not accurate

Comment thread migrate/from-flightcontrol.mdx Outdated
<Step title="Cut traffic over one service at a time">
Deploy the service in Ravion, verify it's healthy, then update DNS to point at the Ravion load balancer or CloudFront distribution. Leave the Flightcontrol service running until you've confirmed the cutover.

**Do not redeploy in Flightcontrol during migration.** New deploys go through Ravion from this point on. The Flightcontrol service keeps serving old traffic until DNS moves and you delete it.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

change this to only be for things that are imported. other like ecs can continue to be deployed via FC, no problem.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Scoped it to imported resources only; provisioned-new services (ECS, static sites) can keep deploying via Flightcontrol until DNS moves.

Co-Authored-By: brandon <brandon@flightcontrol.dev>
Once each service is fully cut over, remove it from Flightcontrol so you're not paying for duplicate infrastructure.

<Warning>
**Never delete a service in Flightcontrol that you imported into Ravion.** Deleting it in Flightcontrol destroys the underlying AWS resources that Ravion now manages, including databases and buckets.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

this not clear enough, needs to be more clear that this is for things you imported the infra into ravion (like rds) instead of creating a new module in ravion like ecs.

@flybayer
flybayer merged commit 0f6b7cd into main Aug 11, 2026
10 checks passed
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