Skip to content

Submit and Manage Environment Promotion Approval Requests

If environment promotion workflows are configured for your organization as mentioned in the guide, you must request and receive approval before deploying to a critical environment.

When you submit a promotion approval request, Choreo notifies all authorized reviewers via email. Once an authorized reviewer approves or rejects the request, you will receive an email with the decision details. See Review Workflow Approval Requests for more information on workflow approval request reviews.

Request approval for environment promotion

Prerequisites

  • Ensure you have a component created, built, and deployed to the first environment of your CD pipeline.
  • Ensure that an approval workflow is configured for environment promotion.
  • Ensure you are promoting to a critical environment, such as production.
  • Ensure you have the required permissions to either promote the component or create approval requests. Approval request creation requires Create Approval Requests permission under WORKFLOW-MANAGEMENT.

To request approval to promote a component from one environment to another critical environment, follow these steps:

  1. Sign in to the Choreo Console.
  2. In the Choreo Console top navigation menu, select the Organization, then the Project and finally the relevant Component.
  3. From the left navigation, Click DevOps and then click CD Pipelines
  4. Go to the Development card and click Request to Promote.

  5. In the Request Approval pane, enter your request details and click Submit. This creates a request and notifies all authorized assignees via email about the request.

    Note

    When an environment promotion request for a specific component is pending review, Choreo restricts other developers from making the same request until the pending request is either approved or rejected.

When an authorized assignee approves the request, you will receive a confirmation email and can proceed to promote the component to production.

Cancel an environment promotion approval request

If you want to cancel an environment promotion approval request that is already submitted, you can do so before the request is approved or rejected.

When you submit a workflow approval request, the Request to Promote button changes to Cancel Request. To cancel an approval request, click Cancel Request. Upon confirming the cancellation, all configured approvers are notified immediately, and the request will no longer be pending.