Terraform

どのようなものか

Terraformは、HashiCorpのInfrastructure as
Codeツールです。クラウドやオンプレミスのリソースをプレーンテキストの
ファイルに記述し、バージョン管理します。Terraformは、稼働中のインフ
ラをそのファイルに合わせるために、実際のオブジェクトをどう作成、変
更、削除するかを判断します。プログラムを呼び出す名前は小文字の
`terraform`で、コマンドやスクリプトにもこの表記が使われます。

言語は宣言型です。HashiCorpのドキュメントでは、「目標に到達する手順
ではなく、到達したい目標を記述する」と説明しています。設定には、ある
大きさのマシンが特定のネットワークに存在することを書き、そのマシンを
作るためのAPI呼び出しは列挙しません。ファイルの拡張子は`.tf`で、JSON
ベースの`.tf.json`形式もあります。ネイティブ構文はHCLという構文に基
づき、主な構成要素は二つです。ほかの内容を収めるブロックと、名前に値
を割り当てる引数です。

ツールの残りの部分を理解する鍵は、三つあります。

プロバイダーはプラグインです。設定にインストールすべきプラグインを指
定すると、`terraform
init`が検索、ダウンロード、インストールします。HashiCorpによれば、ア
クセス可能なAPIを持つほぼあらゆるプラットフォームやサービスを、プロ
バイダーを通じて扱えます。公開されているものはTerraform
Registryに掲載されています。各プロバイダーは、そのプラットフォームの
リソース型を定義します。そのため、同じ中核プログラムで、異なる三つの
事業者のDNSゾーン、仮想マシン、監視ルールを管理できます。

モジュールはディレクトリです。一つのディレクトリにまとめて置かれた
`.tf`と`.tf.json`ファイルの集まりがモジュールであり、Terraformを実行
する作業ディレクトリがルートモジュールです。

状態は記憶です。Terraformは実際のインフラを状態ファイルに記録し、公
式の入門資料ではこれを環境の状態を判断する基準となる情報源と呼んでい
ます。状態は、設定内の各リソースと、それが管理する実際のオブジェクト
をメタデータとともに対応付けます。既定では`terraform.tfstate`という
ローカルファイルで、その隣に前の版が`terraform.tfstate.backup`として
保存されます。

ライセンスは変更されています。HashiCorpは2023年8月10日、以後の製品リ
リースすべてについて、ソースコードのライセンスをMozilla
Public License 2.0からBusiness Source License
1.1へ変更すると発表しました。一方、API、SDK、その他のライブラリのほ
ぼすべてはMPL
2.0のままです。OpenTofuは、Gruntwork、Spacelift、Harness、Env0、
Scalrなどが始め、Linux
Foundationの管理下で開発されるTerraformのフォークと説明されていま
す。リポジトリはMPL
2.0で公開されており、公式サイトは、既存のワークフローと設定を維持で
きるTerraformの代替として紹介しています。

なぜ重要なのか

HashiCorpは基本のワークフローを三段階で説明しています。記述では、複
数のプロバイダーやサービスにまたがることもあるリソースを定義します。
計画では、Terraformが作成、変更、削除する対象を判断し、実行計画とし
て示します。適用では、承認された計画を実行します。その順序は、リソー
スグラフから導いたリソース間の依存関係に従います。

価値の多くは中間の段階にあります。計画は、何かが起こる前に、変更を書
いた本人以外も読める事前確認資料です。レビュー担当者が見るのはファイ
ルの差分だけではありません。二つのリソースを作成し、一つを更新し、と
きには誰も触るつもりのなかった一つを削除する、という結果も分かりま
す。最後の行をプルリクエストで指摘する負担は小さく、実行後に気付く負
担は非常に大きくなります。

二つ目の理由は対応範囲です。各プラットフォームの知識はそれぞれのプロ
バイダーが持つため、一つの言語、一つのワークフロー、共通のレビュー手
順で、チームが使うすべてのプロバイダーに対応できます。二つのクラウド
と別のDNSホストを使う会社なら、その三つを一つのリポジトリに記述し、
同じ方法でレビューできます。MicrosoftのBicepは、Azure
Resource
Managerのワークフローで別の選択をしています。デプロイの状態はAzureが
保存するため、独自の状態ファイルを持ちません。ただし、BicepがAzure専
用の言語という意味ではありません。拡張機能は、KubernetesやMicrosoft
Graphなど、Resource Manager以外のリソースにも対応しています。

三つ目の理由は状態です。Terraformは、どの実際のオブジェクトがどのブ
ロックに属するかを記録するため、自分が管理するものと、まだ見たことが
ないものを区別し、記録と稼働中の実態を比較できます。その記録は、この
ツールを使う代償でもあります。チーム全員がアクセスできる場所に置き、
二つの実行が同時に書き込まないようロックする必要があります。また、秘
密情報を含むことがあるため、秘密情報自体と同じ厳しさのアクセス制御が
必要です。

より小さな負担もあります。HCLという言語を一つ覚える必要があり、各プ
ロバイダーには固有のリソース型や癖があります。Terraformを基盤に製品
を作るチームには、ライセンスを確認する必要もあります。HashiCorpのラ
イセンスFAQは、何が競合する製品やサービスに当たるかを独立した質問と
して扱っています。OpenTofuは、同じワークフローをMPL
2.0で提供します。

実際の活用例

HashiCorpのリソース構文のページには、次の例が掲載されています。

```hcl
resource "aws_instance" "web" {
  ami           = "ami-a1b2c3d4"
  instance_type = "t2.micro"
}
```

`resource`がブロック型で、`aws_instance`がAWSプロバイダーの定義する
リソース型です。`"web"`はローカル名で、Terraformが状態ファイル内でリ
ソースを追跡するラベルです。実際のマシンの設定には影響しません。ブ
ロック内の二行は引数です。

次の三つのコマンドで、このファイルから稼働するマシンを作ります。

```sh
terraform init
terraform plan -out=tfplan
terraform apply tfplan
```

`terraform
init`は作業ディレクトリを準備します。設定で指定されたプロバイダープ
ラグインをインストールし、状態の保存先を設定します。何度実行しても安
全で、公式ドキュメントは依存関係のロックファイルをバージョン管理にコ
ミットするよう案内しています。

`terraform plan
i-out=tfplan`は計画を算出し、人がそのまま読めない形式のファイルに保存		engineer.company	70
iします。この計画作成によって、提案されたインフラ変更が適用されるわけ		engineer.company	70
iではありません。その後、`terraform		engineer.company	70
apply
tfplan`がそのファイル内の操作を確認なしで実行します。HashiCorpは、保
存した計画を渡すこと自体を承認と見なすからです。同じ理由で、計画ファ
イルを指定した場合は`-auto-approve`フラグが無視されます。

チームでは、役割を自然に分けられます。CIジョブがプルリクエストに対し
て計画を生成してファイルを保存し、人が計画と差分の両方を読み、マージ
後に別のジョブが同じファイルを適用します。読んだ内容がそのまま実行さ
れる仕組みです。applyのドキュメントは、忘れやすい条件も加えていま
す。Terraformのワークフロー外で誰もインフラを変更できないようにする
必要があります。そうでなければ、計画が記述する環境は、すでに実態とず
れています。

このサイトの技術構成のページでは、TerraformとAnsibleを並べています。
どちらもマシンのあるべき姿を記述し、環境の実態を後からたどり直すので
はなく、文書として読めるようにします。別のツールで同じ考えを実践した
事例が、Azureインフラのコードによるプロビジョニングです。Bicepを使
い、テスト、ステージング、本番の各環境を同じテンプレート群から構築し
ています。テンプレートはパラメーターを受け取るため、環境の追加や変更
はプルリクエストになります。この事例には、先ほどの選択の違いが表れて
います。BicepはAzureが記録を持つため独自の状態ファイルを必要とせず、
Terraformは独自の状態を保持する代わりに複数のクラウドを扱います。

問題が起きるところ

Terraformの事故の多くは、同じ形を取ります。設定は有効で、実行も成功
したのに、実際のリソースが消えたり変わったりしています。

リソースの名前を変えると、削除される。
ラベルを`"web"`から`"frontend"`に変えると、リソースのアドレスが変わ
ります。HashiCorpのリファクタリングガイドによれば、Terraformは既定
で、アドレスの変更を、既存のオブジェクトを削除して新しいものを作る指
示と解釈します。使い捨てのマシンなら数分の損失ですが、データベースな
らデータを失います。対策は、何も削除せずにアドレスを更新する`moved`
ブロックです。

```hcl
moved {
  from = aws_instance.web
  to   = aws_instance.frontend
}
```

役目を終えた後も、このブロックは残します。HashiCorpは過去の`moved`ブ
ロックを保持することを強く推奨し、削除は破壊的変更になると明記してい
ます。

二人が別々のローカル状態のコピーに対して適用する。
初期状態では、各ワークスペースの状態はローカルファイルです。一人が一
台のノートパソコンで使うには適しています。しかし、同僚が別のコピーか
らTerraformを実行すると、二つの状態ファイルは存在するものについて食
い違い、それぞれの実行が自分の版に基づいて動きます。HashiCorpの推奨
どおり、状態はHCP
Terraformか、ロックとアクセス制御を備えたリモートストレージに保存し
ます。そうするとTerraformは、状態を書き換える可能性のあるすべての操
作で自動的にロックし、取得できなければ処理を進めません。すべての保存
先がロックに対応するわけではないため、選択前に確認してください。
`-lock=false`は使わずにおきます。存在するフラグですが、公式ドキュメ
ントは使用を推奨していません。

誰かがまだ作業中なのに、残ったロックを強制解除する。
自動解除が失敗するとロックが残り、`force-unlock`コマンドはTerraform
が表示したロックIDを使って解除します。ロックのドキュメントは、細心の
注意を求めています。他人が保持するロックを強制解除すると、同じ状態に
二つの実行が書き込む可能性があります。このコマンドは、自動解除に失敗
した自分のロックだけを解除するためのものです。強制操作の前に、誰の
ロックで、その実行がまだ動いているかを調べます。

状態ファイルから秘密情報が漏れる。
HashiCorpは、状態に秘密情報が含まれる可能性があり、安全なアクセス制
御のないシステムに保存すると漏えいし得ると警告しています。誰でも読め
るバケットに置いたり、ビルド成果物にコピーしたりした状態ファイルは、
認証情報の漏えいです。リポジトリには入れず、含まれる秘密情報と同じア
クセス制御を適用し、手作業では編集しません。必要な修正には`terraform
state`コマンドがあります。

承認が形だけになる。
`-auto-approve`は計画の対話的な承認を省略します。保存済みの計画ファ
イルを渡す場合も、そのファイルが承認と見なされるため省略されます。
applyのドキュメントは、リソースの削除を含む破壊的な変更も対象になる
と警告しています。レビュー済みの計画なしでマージのたびに適用するCI
ジョブは、人が削除を事前に見つけられる唯一の機会を取り除いています。
対策は、先ほどの保存済み計画を使う流れで、計画作成ジョブと適用ジョブ
の間に人のレビューを必須にすることです。自動化で`-auto-approve`を使
う場合も、HashiCorp自身が、まず計画を生成してレビューするよう勧めて
います。

参考資料

  * Terraformとは — HashiCorpの入門資料。記述、計画、適用、プロバイ
ダー、状態を説明しています。

  * terraform applyコマンド — 保存した計画、`-auto-approve`、自動化
でのコマンド実行を扱います。

  * 状態のロック — 自動ロック、非対応の保存先、`force-unlock`の注意
事項です。

  * モジュールのリファクタリング — アドレス変更が削除と作成を意味す
る理由と、`moved`ブロックを説明しています。

  * HashiCorpによるBusiness Source Licenseの採用 — MPL 2.0からBSL
1.1への移行を発表した2023年8月の告知です。

  * OpenTofu — Linux Foundationの下で保守されているTerraformのフォー
クです。

hこのページのウェブ版	URL:https://engineer.company/ja/glossary/terraform/	engineer.company	70
