Skip to main content

Pause-rollout

expanso-cli job pause-rollout​

Pause an active rollout for a job

Synopsis​

Pause an active rollout for a job.

When a rollout is paused:

  • No new executions are scheduled for the new version
  • Existing executions continue running (not stopped)
  • The rollout can be resumed later with 'resume-rollout'

This is useful for investigating issues during a rolling deployment without triggering a full rollback.

expanso-cli job pause-rollout JOB_ID_OR_NAME [flags]

Examples​

  # Pause rollout by job name
  expanso-cli job pause-rollout my-job

  # Pause rollout with a reason
  expanso-cli job pause-rollout my-job --reason "investigating performance issue"

  # Dry run to see what would happen
  expanso-cli job pause-rollout my-job --dry-run

Options​

      --dry-run            Validate without applying
  -h, --help               help for pause-rollout
      --namespace string   Job namespace
      --reason string      Reason for pausing the rollout

Options inherited from parent commands​

      --auth-token string   API bearer authentication token
  -e, --endpoint string     API endpoint URL
  -k, --insecure            Skip TLS certificate verification
  -p, --profile string      Profile to use for configuration
      --timeout string      Request timeout duration
  -v, --verbose             Enable verbose logging

SEE ALSO​

Auto generated by spf13/cobra on 27-Jan-2026​