diff --git a/0-bootstrap/README-GitHub.md b/0-bootstrap/README-GitHub.md index 74a122994..6aba496d4 100644 --- a/0-bootstrap/README-GitHub.md +++ b/0-bootstrap/README-GitHub.md @@ -17,6 +17,9 @@ To run the instructions described in this document, install the following: - [Git](https://git-scm.com/book/en/v2/Getting-Started-Installing-Git) version 2.28.0 or later - [Terraform](https://www.terraform.io/downloads.html) version 1.5.7 or later +For the manual steps described in this document, you need to use the same [Terraform](https://www.terraform.io/downloads.html) version used on the build pipeline. +Otherwise, you might experience Terraform state snapshot lock errors. + Version 1.5.7 is the last version before the license model change. To use a later version of Terraform, ensure that the Terraform version used in the Operational System to manually execute part of the steps in `3-networks` and `4-projects` is the same version configured in the following code - 0-bootstrap/modules/jenkins-agent/variables.tf diff --git a/0-bootstrap/README-GitLab.md b/0-bootstrap/README-GitLab.md index d41c01d87..b0ab4a312 100644 --- a/0-bootstrap/README-GitLab.md +++ b/0-bootstrap/README-GitLab.md @@ -16,6 +16,9 @@ To run the instructions described in this document, install the following: - [Terraform](https://www.terraform.io/downloads.html) version 1.5.7 or later - [jq](https://jqlang.github.io/jq/) version 1.6 or later. +For the manual steps described in this document, you need to use the same [Terraform](https://www.terraform.io/downloads.html) version used on the build pipeline. +Otherwise, you might experience Terraform state snapshot lock errors. + Version 1.5.7 is the last version before the license model change. To use a later version of Terraform, ensure that the Terraform version used in the Operational System to manually execute part of the steps in `3-networks` and `4-projects` is the same version configured in the following code - 0-bootstrap/modules/jenkins-agent/variables.tf diff --git a/0-bootstrap/README-Jenkins.md b/0-bootstrap/README-Jenkins.md index 702b7a981..d9ab310cb 100644 --- a/0-bootstrap/README-Jenkins.md +++ b/0-bootstrap/README-Jenkins.md @@ -199,6 +199,9 @@ You arrived to these instructions because you are using the `jenkins_bootstrap` - Terraform version 1.5.7 - See [Requirements](#requirements) section for more details. - The `terraform.tfvars` file with all the necessary values. +For the manual steps described in this document, you need to use the same [Terraform](https://www.terraform.io/downloads.html) version used on the build pipeline. +Otherwise, you might experience Terraform state snapshot lock errors. + Version 1.5.7 is the last version before the license model change. To use a later version of Terraform, ensure that the Terraform version used in the Operational System to manually execute part of the steps in `3-networks` and `4-projects` is the same version configured in the following code - 0-bootstrap/modules/jenkins-agent/variables.tf diff --git a/0-bootstrap/README-Terraform-Cloud.md b/0-bootstrap/README-Terraform-Cloud.md index 2f0bd6949..c13a88bb4 100644 --- a/0-bootstrap/README-Terraform-Cloud.md +++ b/0-bootstrap/README-Terraform-Cloud.md @@ -20,6 +20,9 @@ To run the instructions described in this document, install the following: - [Terraform](https://www.terraform.io/downloads.html) version 1.5.7 or later - [jq](https://jqlang.github.io/jq/download/) version 1.6.0 or later +For the manual steps described in this document, you need to use the same [Terraform](https://www.terraform.io/downloads.html) version used on the build pipeline. +Otherwise, you might experience Terraform state snapshot lock errors. + Also make sure that you have the following: - A [Terraform Cloud account](https://developer.hashicorp.com/terraform/tutorials/cloud-get-started/cloud-sign-up#create-an-account) for your User or [Organization](https://developer.hashicorp.com/terraform/tutorials/cloud-get-started/cloud-sign-up#create-an-organization). diff --git a/0-bootstrap/README.md b/0-bootstrap/README.md index c8a8361f4..354e9f756 100644 --- a/0-bootstrap/README.md +++ b/0-bootstrap/README.md @@ -67,7 +67,7 @@ To run the commands described in this document, install the following: - [Terraform](https://www.terraform.io/downloads.html) version 1.5.7 - [jq](https://jqlang.github.io/jq/download/) version 1.6.0 or later -**Note:** Make sure that you use version 1.5.7 of Terraform throughout this series. Otherwise, you might experience Terraform state snapshot lock errors. +**Note:** Make sure that you use the same version of [Terraform](https://www.terraform.io/downloads.html) throughout this series. Otherwise, you might experience Terraform state snapshot lock errors. Version 1.5.7 is the last version before the license model change. To use a later version of Terraform, ensure that the Terraform version used in the Operational System to manually execute part of the steps in `3-networks` and `4-projects` is the same version configured in the following code diff --git a/3-networks-dual-svpc/README.md b/3-networks-dual-svpc/README.md index 4818e8da4..63d5b2261 100644 --- a/3-networks-dual-svpc/README.md +++ b/3-networks-dual-svpc/README.md @@ -73,9 +73,8 @@ The purpose of this step is to: echo "access_context_manager_policy_id = ${ACCESS_CONTEXT_MANAGER_ID}" ``` -1. For the manual step described in this document, you need [Terraform](https://www.terraform.io/downloads.html) version 1.5.7 or later to be installed. - -**Note:** Make sure that you use version 1.5.7 or later of Terraform throughout this series. Otherwise, you might experience Terraform state snapshot lock errors. +1. For the manual step described in this document, you need to use the same [Terraform](https://www.terraform.io/downloads.html) version used on the build pipeline. +Otherwise, you might experience Terraform state snapshot lock errors. ### Troubleshooting diff --git a/3-networks-hub-and-spoke/README.md b/3-networks-hub-and-spoke/README.md index 74a18f4e0..adad7a225 100644 --- a/3-networks-hub-and-spoke/README.md +++ b/3-networks-hub-and-spoke/README.md @@ -73,9 +73,8 @@ The purpose of this step is to: echo "access_context_manager_policy_id = ${ACCESS_CONTEXT_MANAGER_ID}" ``` -1. For the manual step described in this document, you need [Terraform](https://www.terraform.io/downloads.html) version 1.5.7 or later to be installed. - -**Note:** Make sure that you use version 1.5.7 or later of Terraform throughout this series. Otherwise, you might experience Terraform state snapshot lock errors. +1. For the manual step described in this document, you need to use the same [Terraform](https://www.terraform.io/downloads.html) version used on the build pipeline. +Otherwise, you might experience Terraform state snapshot lock errors. ### Troubleshooting diff --git a/4-projects/README.md b/4-projects/README.md index 752d8688b..914863ddf 100644 --- a/4-projects/README.md +++ b/4-projects/README.md @@ -72,11 +72,10 @@ Other Workspaces can also be created to isolate deployments if needed. 1. 2-environments executed successfully. 1. 3-networks executed successfully. -1. For the manual step described in this document, you need [Terraform](https://www.terraform.io/downloads.html) version 1.5.7 or later to be installed. +1. For the manual step described in this document, you need to use the same [Terraform](https://www.terraform.io/downloads.html) version used on the build pipeline. +Otherwise, you might experience Terraform state snapshot lock errors. - **Note:** Make sure that you use version 1.5.7 or later of Terraform throughout this series. Otherwise, you might experience Terraform state snapshot lock errors. - - **Note 2:** As mentioned in 0-bootstrap [README note 2](../0-bootstrap/README.md#deploying-with-cloud-build) at the end of Cloud Build deploy section, make sure that you have requested at least 50 additional projects for the **projects step service account**, otherwise you may face a project quota exceeded error message during the following steps and you will need to apply the fix from [this entry](../docs/TROUBLESHOOTING.md#attempt-to-run-4-projects-step-without-enough-project-quota) of the Troubleshooting guide in order to continue. + **Note:** As mentioned in 0-bootstrap [README note 2](../0-bootstrap/README.md#deploying-with-cloud-build) at the end of Cloud Build deploy section, make sure that you have requested at least 50 additional projects for the **projects step service account**, otherwise you may face a project quota exceeded error message during the following steps and you will need to apply the fix from [this entry](../docs/TROUBLESHOOTING.md#attempt-to-run-4-projects-step-without-enough-project-quota) of the Troubleshooting guide in order to continue. ### Troubleshooting diff --git a/helpers/foundation-deployer/README.md b/helpers/foundation-deployer/README.md index bb8789fb9..e483e8bc2 100644 --- a/helpers/foundation-deployer/README.md +++ b/helpers/foundation-deployer/README.md @@ -12,6 +12,9 @@ Helper tool to deploy the Terraform example foundation using Cloud Build and Clo - [Terraform](https://www.terraform.io/downloads.html) version 1.5.7 or later - See `0-bootstrap` README for additional IAM [requirements](../../0-bootstrap/README.md#prerequisites) on the user deploying the Foundation. +Your environment need to use the same [Terraform](https://www.terraform.io/downloads.html) version used on the build pipeline. +Otherwise, you might experience Terraform state snapshot lock errors. + Version 1.5.7 is the last version before the license model change. To use a later version of Terraform, ensure that the Terraform version used in the Operational System to manually execute part of the steps in `3-networks` and `4-projects` is the same version configured in the following code - 0-bootstrap/modules/jenkins-agent/variables.tf