Apply

up apply

Converge infrastructure to match up.yaml

Synopsis

Read up.yaml, compute the difference between the desired state and what exists, then create, update, or delete resources to close the gap.

Apply is idempotent: run it as often as you like. It only changes what has drifted. For each change it resolves the project, verifies or provisions referenced nodes, builds or pulls the image, deploys, waits for the health check, shifts traffic, then retires the previous deployment. A missing project is bootstrapped on first apply.

Use up diff to preview changes without making them.

up apply [flags]

Examples

  # Apply the default up.yaml in the current directory
  up apply

  # Apply a specific file to the staging environment
  up apply -f prod.yaml --env staging

  # Apply configuration only, without redeploying
  up apply --no-deploy

Options

  -e, --env string       target environment (default: production)
  -f, --file string      path to config file (default "up.yaml")
      --force            skip delete confirmation prompts
      --git-ref string   override the git ref (branch, tag, or commit SHA) for all git sources
      --no-deploy        update config without deploying
      --pr string        pull request number; shorthand for --env pr-<n>
      --preview          derive per-environment preview domains from the preview block
  -p, --project string   project name or ID (defaults to up.yaml)

Options inherited from parent commands

  -o, --output string   output format: table, json, yaml (list commands only) (default "table")
  -q, --quiet           suppress output
  -v, --verbose count   enable debug output (-v debug, -vv trace)