Fireworks: always pass a deployment shape, and set region at creation because it cannot change

Fireworks: always pass a deployment shape, and set region at creation because it cannot change

TL;DR

Context: Fireworks on-demand deployments: always pass a deployment shape; region locked at creation Fireworks' deployments guide is blunt: do not create deployments without a shape. Always pass --deployment-shape (a concrete shape, or default to have Fireworks pick a validated one). Most failed deployment creations on Fireworks are shapeless deployments, and enforcement is coming that will require an explicit --accept-shapeless-risk opt-in.

Use this when you run into the situation in the title.

When not to use this skill: unrelated tasks. It covers only the procedure above.

Compatibility

The steps above apply to the commands named in them. This skill does not pin a version, so if a flag looks different on your machine, check your installed version's docs first.

Details

Never create a Fireworks deployment without a shape The Fireworks deployments guide says most failed deployment creations are deployments without a shape. The fix is one flag: always pass --deployment-shape, either a concrete shape or default to have Fireworks pick a validated one. Skip it and you skip every validation check, so mistakes like a GPU count that cannot fit the model surface only at creation time, as failures. Enforcement is coming: shapeless creation will soon require an explicit --accept-shapeless-risk flag. Second, equally permanent: deployment placement (--region) is set at creation and cannot be changed in place. Forget --region and the deployment gets pinned to a single datacenter with no automatic migration later. Changing it means recreating the deployment and repointing your app. For production, set --region GLOBAL explicitly unless you have quota for a specific region, because deploying with a region you have no quota for is rejected at creation. CI-friendly checklist for firectl deployment create: - --deployment-shape default (never bare create, which drops into an interactive shape picker that hangs your pipeline) - --region GLOBAL - --wait, so the command returns when the deployment is actually ready

Also: deployment placement (--region) must be set at creation and cannot be changed in place; without it the deployment is pinned to a single datacenter and will never migrate automatically.

Source: Fireworks on-demand deployments: always pass a deployment shape; region locked at creation Fireworks' deployments guide is blunt: do not create deployments without a shape. Always pass --deployment-shape (a concrete shape, or default to have Fireworks pick a validated one). Most failed deployment creations on Fireworks are shapeless deployments, and enforcement is coming that will require an explicit --accept-shapeless-risk opt-in. Also: deployment placement (--region) must be set at creation and cannot be changed in place; without it the deployment is pinned to a single datacenter and will never migrate automatically.

Verified resolution: # Never create a Fireworks deployment without a shape The Fireworks deployments guide says most failed deployment creations are deployments without a shape. The fix is one flag: always pass --deployment-shape, either a concrete shape or default to have Fireworks pick a validated one. Skip it and you skip every validation check, so mistakes like a GPU count that cannot fit the model surface only at creation time, as failures. Enforcement is coming: shapeless creation will soon require an explicit --accept-shapeless-risk flag. Second, equally permanent: deployment placement (--region) is set at creation and cannot be changed in place. Forget --region and the deployment gets pinned to a single datacenter with no automatic migration later. Changing it means recreating the deployment and repointing your app. For production, set --region GLOBAL explicitly unless you have quota for a specific region, because deploying with a region you have no quota for is rejected at creation. CI-friendly checklist for firectl deployment create: - --deployment-shape default (never bare create, which drops into an interactive shape picker that hangs your pipeline) - --region GLOBAL - --wait, so the command returns when the deployment is actually ready

Source URL: https://docs.fireworks.ai/guides/ondemand-deployments.md