From 762eac259b62d46e1927f4d185dd86d22da99c12 Mon Sep 17 00:00:00 2001 From: Arel Rabinowitz <30493345+RLRabinowitz@users.noreply.github.com> Date: Mon, 5 Aug 2024 14:37:17 +0300 Subject: [PATCH] Docs: Update 1.8.0 upgrade docs, when S3 bucket is used (#1876) Signed-off-by: RLRabinowitz Signed-off-by: Christian Mesh Co-authored-by: Christian Mesh Co-authored-by: Janos <86970079+janosdebugs@users.noreply.github.com> --- website/docs/intro/upgrading.mdx | 8 +++++++- 1 file changed, 7 insertions(+), 1 deletion(-) diff --git a/website/docs/intro/upgrading.mdx b/website/docs/intro/upgrading.mdx index 9ea72cadf7..2311b3539d 100644 --- a/website/docs/intro/upgrading.mdx +++ b/website/docs/intro/upgrading.mdx @@ -15,7 +15,7 @@ upgrading OpenTofu to version 1.8.0. Although OpenTofu 1.8 is mostly compatible with version 1.6 and 1.7, you should take the necessary precautions to prevent accidents. Make sure you have an up to date and *tested* disaster recovery plan. -## Step 1: Remove any use of `use_legacy_workflow` from S3 backend configurations, if any +## Step 1: If using an S3 backend - Remove any use of `use_legacy_workflow` from S3 backend configurations If you are using the S3 backend, with `use_legacy_workflow` set, you'd have to remove it. This field has been deprecated in version 1.7.0, and has been changed to default to `false`. The legacy workflow of authentication is no longer supported. Please start using the new authentication method, which is more consistent with other AWS tools @@ -69,6 +69,12 @@ If you suspect the failure may be the result of a bug in OpenTofu, Now you are ready to migrate. Run `tofu init` in the directory where your code resides. OpenTofu will download any providers and modules referenced in your configuration from the OpenTofu registry. +:::note + +If you are using the S3 backend - You will need to run `tofu init -reconfigure` to reinitialize the backend. + +::: + ## Step 6: Inspect the plan Once initialized, run `tofu plan` and ensure that there are no pending changes similar to step 1 above. If there are