diff --git a/docs/deployment/infrastructure.md b/docs/deployment/infrastructure.md index 6c389134..a393fb4f 100644 --- a/docs/deployment/infrastructure.md +++ b/docs/deployment/infrastructure.md @@ -88,7 +88,14 @@ Docker logs can be viewed in the Advanced Tools for the instance. The URL patter ## Making changes -Terraform is [`plan`](https://www.terraform.io/cli/commands/plan)'d when code is pushed to any branch on GitHub, then [`apply`](https://www.terraform.io/cli/commands/apply)'d when merged to `dev`. While other automation for this project is done through GitHub Actions, we use an Azure Pipeline (above) for a couple of reasons: +Terraform is [`plan`](https://www.terraform.io/cli/commands/plan)'d when commits that change any file under the `terraform` directory are either: + +- merged into the `main` branch +- tagged with a release candidate or release tag + +Then, the Azure DevOps pipeline that ran the `plan` will wait for approval to run [`apply`](https://www.terraform.io/cli/commands/apply). + +While other automation for this project is done through GitHub Actions, we use an Azure DevOps Pipeline (above) for a couple of reasons: - Easier authentication with the Azure API using a service connnection - Log output is hidden, avoiding accidentally leaking secrets