Update migration instructions (#72)

The Terraform refresh command has been deprecated.
rubrikinc · May 16, 2023 · e191f76 · e191f76
1 parent 49f12a3
commit e191f76
Show file tree

Hide file tree

Showing 4 changed files with 32 additions and 12 deletions.
diff --git a/docs/guides/upgrade_guide_v0.3.0.md b/docs/guides/upgrade_guide_v0.3.0.md
@@ -10,15 +10,20 @@ v0.3.0 introduces breaking changes to the following resources:
 * `polaris_azure_service_principal`
 * `polaris_gcp_project`
 
-After the Terraform configuration files has been updated according to the instructions in this guide, validate their
-correctness by running:
+After the Terraform configuration files have been updated according to the instructions in this guide and the version
+number has been bumped, update the RSC Terraform provider by running:
+```bash
+$ terraform init -upgrade
+```
+
+Next, validate the correctness of the Terraform configuration files by running:
 ```bash
 $ terraform plan
 ```
 
 If this doesn't produce any error, proceed by running:
 ```bash
-$ terraform refresh
+$ terraform apply -refresh-only
 ```
 This will read the remote state of the resources and migrate the local Terraform state to v0.3.0.
 

diff --git a/docs/guides/upgrade_guide_v0.6.0.md b/docs/guides/upgrade_guide_v0.6.0.md
@@ -7,15 +7,20 @@ subcategory: "Upgrade"
 v0.6.0 introduces breaking changes to the following resources:
 * `polaris_azure_exocompute`
 
-After the Terraform configuration files has been updated according to the instructions in this guide, validate their
-correctness by running:
+After the Terraform configuration files have been updated according to the instructions in this guide and the version
+number has been bumped, update the RSC Terraform provider by running:
+```bash
+$ terraform init -upgrade
+```
+
+Next, validate the correctness of the Terraform configuration files by running:
 ```bash
 $ terraform plan
 ```
 
 If this doesn't produce any error, proceed by running:
 ```bash
-$ terraform refresh
+$ terraform apply -refresh-only
 ```
 This will read the remote state of the resources and migrate the local Terraform state to v0.6.0.
 

diff --git a/templates/guides/upgrade_guide_v0.3.0.md.tmpl b/templates/guides/upgrade_guide_v0.3.0.md.tmpl
@@ -10,15 +10,20 @@ v0.3.0 introduces breaking changes to the following resources:
 * `polaris_azure_service_principal`
 * `polaris_gcp_project`
 
-After the Terraform configuration files has been updated according to the instructions in this guide, validate their
-correctness by running:
+After the Terraform configuration files have been updated according to the instructions in this guide and the version
+number has been bumped, update the RSC Terraform provider by running:
+```bash
+$ terraform init -upgrade
+```
+
+Next, validate the correctness of the Terraform configuration files by running:
 ```bash
 $ terraform plan
 ```
 
 If this doesn't produce any error, proceed by running:
 ```bash
-$ terraform refresh
+$ terraform apply -refresh-only
 ```
 This will read the remote state of the resources and migrate the local Terraform state to v0.3.0.
 

diff --git a/templates/guides/upgrade_guide_v0.6.0.md.tmpl b/templates/guides/upgrade_guide_v0.6.0.md.tmpl
@@ -7,15 +7,20 @@ subcategory: "Upgrade"
 v0.6.0 introduces breaking changes to the following resources:
 * `polaris_azure_exocompute`
 
-After the Terraform configuration files has been updated according to the instructions in this guide, validate their
-correctness by running:
+After the Terraform configuration files have been updated according to the instructions in this guide and the version
+number has been bumped, update the RSC Terraform provider by running:
+```bash
+$ terraform init -upgrade
+```
+
+Next, validate the correctness of the Terraform configuration files by running:
 ```bash
 $ terraform plan
 ```
 
 If this doesn't produce any error, proceed by running:
 ```bash
-$ terraform refresh
+$ terraform apply -refresh-only
 ```
 This will read the remote state of the resources and migrate the local Terraform state to v0.6.0.