summaryrefslogtreecommitdiff
path: root/data/deprecations/15-7-enable-period-in-terraform-state-name.yml
blob: e9db80ea34c98648e0542639af3c16f4af5cc65a (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
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'