summaryrefslogtreecommitdiff
path: root/data/deprecations/15-7-enable-period-in-terraform-state-name.yml
diff options
context:
space:
mode:
authorGitLab Bot <gitlab-bot@gitlab.com>2022-12-20 14:22:11 +0000
committerGitLab Bot <gitlab-bot@gitlab.com>2022-12-20 14:22:11 +0000
commit0c872e02b2c822e3397515ec324051ff540f0cd5 (patch)
treece2fb6ce7030e4dad0f4118d21ab6453e5938cdd /data/deprecations/15-7-enable-period-in-terraform-state-name.yml
parentf7e05a6853b12f02911494c4b3fe53d9540d74fc (diff)
downloadgitlab-ce-f7d6ced4f57b4920a666336f5a44d098faade2ea.tar.gz
Add latest changes from gitlab-org/gitlab@15-7-stable-eev15.7.0-rc42
Diffstat (limited to 'data/deprecations/15-7-enable-period-in-terraform-state-name.yml')
-rw-r--r--data/deprecations/15-7-enable-period-in-terraform-state-name.yml25
1 files changed, 25 insertions, 0 deletions
diff --git a/data/deprecations/15-7-enable-period-in-terraform-state-name.yml b/data/deprecations/15-7-enable-period-in-terraform-state-name.yml
new file mode 100644
index 00000000000..e9db80ea34c
--- /dev/null
+++ b/data/deprecations/15-7-enable-period-in-terraform-state-name.yml
@@ -0,0 +1,25 @@
+- title: "Support for periods (`.`) in Terraform state names might break existing states"
+ announcement_milestone: "15.7"
+ announcement_date: "2022-12-22"
+ removal_milestone: "16.0"
+ removal_date: "2023-05-22"
+ breaking_change: true
+ reporter: nagyv-gitlab
+ stage: configure
+ issue_url: https://gitlab.com/gitlab-org/gitlab/-/issues/385564
+ body: |
+ Previously, Terraform state names containing periods were not supported. However, you could still use state names with periods via a workaround.
+
+ GitLab 15.7 [adds full support](https://docs.gitlab.com/ee/user/infrastructure/iac/troubleshooting.html#state-not-found-if-the-state-name-contains-a-period) for state names that contain periods. If you used a workaround to handle these state names, your jobs might fail, or it might look like you've run Terraform for the first time.
+
+ To resolve the issue:
+
+ 1. Change any references to the state file by excluding the period and any characters that follow.
+ - For example, if your state name is `state.name`, change all references to `state`.
+ 1. Run your Terraform commands.
+
+ To use the full state name, including the period, [migrate to the full state file](https://docs.gitlab.com/ee/user/infrastructure/iac/terraform_state.html#migrate-to-a-gitlab-managed-terraform-state).
+ end_of_support_milestone: 16.0
+ end_of_support_date: 2023-05-22
+ tiers: [Free, Silver, Gold, Core, Premium, Ultimate]
+ documentation_url: 'https://docs.gitlab.com/ee/user/infrastructure/iac/troubleshooting.html#troubleshooting-terraform-state'