Sign in Start for free

octopus release promote

Promote a release to a specific environment

Text
Usage:
  octopus release promote [flags]

Flags:
      --deploy-at string                           Deploy at a later time. Deploy now if omitted. TODO date formats and timezones!
      --deploy-at-expiry string                    Cancel the deployment if it hasn't started within this time period.
      --deployment-freeze-name stringArray         Override this deployment freeze (can be specified multiple times)
      --deployment-freeze-override-reason string   Reason for overriding a deployment freeze
      --deployment-target stringArray              Deploy to this target (can be specified multiple times)
      --exclude-deployment-target stringArray      Deploy to targets except for this (can be specified multiple times)
      --excluded-target-tag stringArray            Deploy to targets except for those matching this tag (can be specified multiple times)
      --force-package-download                     Force re-download of packages
      --from string                                Name or ID of the environment to get the current deployment from
      --guided-failure string                      Enable Guided failure mode (true/false/default)
      --latest-successful                          Use the latest successful release to promote
      --priority string                            Jump the task queue ahead of other queued tasks (true/false/default). Requires the Priority Tasks feature, and the TaskPrioritize permission to set true.
  -p, --project string                             Name or ID of the project
      --skip stringArray                           Exclude specific steps from the deployment
      --specific-target-tag stringArray            Deploy to targets matching this tag (can be specified multiple times)
      --tenant stringArray                         Deploy to this tenant (can be specified multiple times)
      --tenant-tag stringArray                     Deploy to tenants matching this tag (can be specified multiple times). Format is 'Tag Set Name/Tag Name', such as 'Regions/South'.
      --to stringArray                             Name or ID of the environment(s) to promote to
      --update-variables                           Overwrite the release variable snapshot by re-importing variables from the project.
  -v, --variable stringArray                       Set the value for a prompted variable in the format Label:Value


Global Flags:
  -h, --help                   Show help for a command
      --no-prompt              Disable prompting in interactive mode
  -f, --output-format string   Specify the output format for a command ("json", "table", or "basic") (default "table")
  -s, --space string           Specify the space for operations

Examples

Octopus Samples instance

Many of the examples we use, reference the samples instance of Octopus Deploy. If you’d like to explore the samples instance, you can log in as a guest.

Bash
octopus release promote --project MyProject --from "Development" --to "Staging"\
octopus release promote -p MyProject --from "Staging" --to "Production" --latest-successful\

Learn more