infra:deploy
fuel infra:deploy

fuel infra:deploy

Apply changes to or provision AWS ECS infrastructure for an existing project.

Usage

fuel infra:deploy [options]

Description

Applies changes to or provisions AWS ECS infrastructure for an existing project. Run without flags to apply infrastructure changes or resume a failed deployment — no `fuel.yml` is required if `/infra` already exists, and the configuration is recovered automatically from AWS Secrets Manager. Pass `--config <path>` to provide a fuel.yml from disk — the CLI copies it to the project root, generates or regenerates the `/infra` folder, and runs the full provisioning workflow.

Options

FlagDescriptionDefault
-p, --path <path>Path to the project root.current directory
-c, --config <path>Path to fuel.yml. Copies it to the project root, generates or regenerates the /infra folder, and runs the full provisioning workflow.
--regenerateRegenerate the /infra folder from templates even if it already exists.
--plan-onlyRun OpenTofu plan (preview changes) without creating any AWS resources.
--tofu-onlyRun only OpenTofu init + apply on an existing /infra folder. Skips config validation, secret upload, GitHub repo creation, and code push. Reads all variables from default.tfvars. Conflicts with --config and --regenerate.
--destroy-on-failureDestroy all provisioned resources if OpenTofu apply fails. Default: false (resources are preserved for re-run). Conflicts with --plan-only.
--skip-branch-protectionSkip applying GitHub branch protection rules.
--github-token <token>GitHub personal access token (overrides .fuel-credentials).
--github-username <username>GitHub username (overrides .fuel-credentials).
--github-organization <org>GitHub organization (overrides .fuel-credentials).
--aws-access-key-id <key>AWS Access Key ID (overrides .fuel-credentials).
--aws-secret-access-key <secret>AWS Secret Access Key (overrides .fuel-credentials).
--aws-region <region>AWS region (overrides .fuel-credentials).

Examples

Apply changes or resume a failed deployment

fuel infra:deploy

Provision from fuel.yml

fuel infra:deploy --config fuel.yml

Preview infrastructure changes

fuel infra:deploy --plan-only

Regenerate /infra folder and re-apply

fuel infra:deploy --regenerate

Live Demo

Simulated terminal output for fuel infra:deploy. Press replay to restart.

fuel infra:deploy
$