terraformを0.12以上にアップデートしたい

現在使用しているterraformは0.11.4とする。
なお、今回実行したい 0.12checklist コマンドは0.12にはなく、また、0.11.xであっても、0.11.14が望ましい。

Upgrading to Terraform 0.12 - Terraform by HashiCorp

理由はこちらの公式情報のとおり。
Pre-upgrade Checklistにあるとおり、事前確認ができる。
ここでの警告に対応後、terraformを0.12にあげて terrafrom init する。

その後、今度は0.12.x付属の terraform 0.12upgrade を使うとよい。
※ こちらの実行は別記事で。

providerのバージョンアップも必要

今回はGoogle providerを使っていたのでproviderのバージョンアップも視野にいれた。
なお、低すぎると今回のように

Terraform Google Provider 2.0.0 Upgrade Guide - Terraform by HashiCorp

1.2.0 -> 2.0.0 -> 2.5.0以上を段階的に意識する必要がある。

---

terraform 0.12checklist

terraform付属のコマンドに0.12以上にバージョンアップするための準備コマンドがある。

terraform_help

All other commands:
    0.12checklist      Checks whether the configuration is ready for Terraform v0.12

terraform(0.11.4)

% terraform 0.12checklist
After analyzing this configuration and working directory, we have identified some necessary steps that we recommend you take before upgrading to Terraform v0.12:

- [ ] Upgrade provider "google" to version 2.17.0 or newer.

  No currently-installed version is compatible with Terraform 0.12. To upgrade, set the version constraint for this provider as follows and then run `terraform init`:

      version = "~> 2.17.0"

Taking these steps before upgrading to Terraform v0.12 will simplify the upgrade process by avoiding syntax errors and other compatibility problems.

• Upgrade provider "google" to version 2.17.0 or newer.

テスト実行した環境でGCPを使用。
Google Cloud Storageや Google Cloud IAM を管理していた。
このバージョン以上にアップデートかつ固定したほうがよい。
（0.11.14では想定していないとういこととみる。）

terraform moduleのバージョンを見る

まずは現在のmoduleのバージョン。

% terraform -v
Terraform v0.11.14
+ provider.google v1.20.0

Your version of Terraform is out of date! The latest version
is 0.12.10. You can update by downloading from www.terraform.io/downloads.html

provider.google v1.20.0

Provider: Google Cloud Platform - Terraform by HashiCorp

公式情報より、0.12意識であれば2.5.0以上が必要そうだ。
terraform-provider-google/CHANGELOG.md at master · terraform-providers/terraform-provider-google

2.5.0 より Terraform 0.12 supportとある。

openstack providerをバージョンアップする

基本はバージョンを指定してから terraform initしたほうがよい。
つまりは管理したほうがよい。
方法はこちらにまとめた。

Terraformの使用バージョンを固定する - Qiita

providerに以下設定をしておく。
しかし、その前にバージョンが低すぎるので段階的にアップデートする必要ありだった。

google provider 1.2.0 -> 2.0.0

Terraform Google Provider 2.0.0 Upgrade Guide - Terraform by HashiCorp

example

provider "google" {
  # ... other configuration ...

  version = "~> 1.20.0"
}

公式よりこのような指定から。今回の環境はこの設定をしていた。

これを

provider "google" {
  # ... other configuration ...

  version = "~> 2.0.0"
}

まずはこのバージョンにするところから。
設定は以下の差分となった。

--- google_provider.tf
+++ google_provider.tf
@@ -1,5 +1,5 @@
 provider "google" {
-  version = "~> 1.20.0"
+  version = "~> 2.0.0"
   project = "goope-170607"
   region  = "asia-northeast1"
 }

この状態で terraform init する。

% terraform init

Initializing the backend...

Initializing provider plugins...
- Checking for available provider plugins on https://releases.hashicorp.com...
- Downloading plugin for provider "google" (2.0.0)...

Terraform has been successfully initialized!

今回は無事にアップデートされた。
問題は terraform plan。
この変更によるつまずきどころは段階的に対応する。

なお、このとき注意なのがGoogle IAMに大幅な変更が加わり、未管理だった設定もインポート対象となるため、活用している人はご注意。

google provider 2.0.0 -> 2.5.0(2.7.0以上にする）

terraform0.12対応のversionにアップデートする。
先ほどと同様で今度は 2.5.0以上 とすればよい。