Skip to main content

Task 04: Approve Deployment

Objective: Review and approve the Terraform plan to authorize deployment Manual Gate: Requires authorized user approval

DOCUMENT CATEGORY: Runbook SCOPE: Approve the deployment to proceed with infrastructure provisioning PURPOSE: Approve the deployment to proceed with infrastructure provisioning MASTER REFERENCE: Azure Pipelines Approvals

Status: Active

What Happens​

The approval gate:

  • Pauses pipeline execution
  • Requires manual review and approval
  • Provides audit trail of who approved
  • Prevents unauthorized deployments

Procedure​

1. Review Plan Summary​

Before approving, verify:

  • Terraform plan reviewed in Task 03
  • Resource changes are expected
  • Network configuration is correct
  • No resources being destroyed unexpectedly
  • Deployment timing is acceptable (45-90 min for management mode)

2. Approve Deployment​

  1. In the pipeline view, find the approve stage
  2. Click the play button (▶️) next to the approval job
  3. Confirm approval when prompted

3. Document Approval​

Optional but recommended:

Approval Notes:
- Reviewed Terraform plan: 45 resources to add
- Network: VNet 10.100.1.0/24, VPN Gateway VpnGw2AZ
- Deployment authorized by: [Your Name]
- Timestamp: [YYYY-MM-DD HH:MM]

Who Can Approve​

Approval requires one of:

  • Project Maintainer role
  • Azure Local Cloud deployment engineer
  • Customer designated approver (if configured)

Approval Decision Checklist​

CheckStatus
Terraform plan reviewed☐
Resource count reasonable☐
Network configuration verified☐
VPN settings confirmed with network team☐
Deployment window acceptable☐
Stakeholders notified☐
Change ticket open (if required)☐

If You Need to Reject​

Don't approve if:

  • Resource changes are unexpected
  • Network configuration looks incorrect
  • VPN settings don't match network team's documentation
  • Deployment timing conflicts with other activities

To reject and fix:

  1. Do not click approve
  2. Cancel the pipeline (or let it time out)
  3. Make necessary configuration changes
  4. Commit and push again to restart pipeline

Validation​

  • Plan reviewed thoroughly
  • Approval decision documented
  • Pipeline approved and continuing to apply stage


When to use: Use this tab if your CI/CD pipeline runs on GitHub Actions.

See procedure steps above for GitHub-specific guidance.

Toolkit Reference

Scripts for this task are located in the azurelocal-toolkit repository under scripts/deploy/ in the appropriate task folder.


Alternatives​

The procedures in this task use the methods shown in the tabs above. The toolkit is PowerShell 7 only and has no Bash scripts. A few tasks that act on Azure also have an Azure CLI script written in PowerShell. The script status page of the toolkit lists which task has which script.

PreviousUpNext
Task 03 - Plan StagePhase 02 - ExecutionTask 05 - Apply Stage

Values from infrastructure.yml​

The pipeline settings are in the devops section of infrastructure.yml (schema 5): the platform, the project, the repository, the approval environments, the runners and the Terraform state. The Terraform code does not define these values a second time. config/variables/scripts/New-IacVariableFiles.ps1 writes terraform.tfvars.json and backend.hcl from the file. See the variables reference.


Troubleshooting​

IssueCauseResolution
Approval request not receivedNotification settings misconfiguredVerify approver notification channels and permissions
Approval timeoutApprover unavailable within configured windowExtend approval timeout or add alternate approvers

Version Control​

VersionDateAuthorChanges
1.0.02026-03-24Azure Local CloudInitial release