Terraform 状態ファイルと Cloud Infra が同期していない | Harold Finch 著 | 2024 年 7 月

Terraform の状態ファイルと実際のクラウド インフラストラクチャが同期していないと、Terraform が既存のリソースを再作成しようとしたり、リソースを正しく管理できなかったりするなど、さまざまな問題が発生する可能性があります。この問題を解決するには、次の手順に従ってください。

1. 問題を理解する

修正措置を講じる前に、状態ファイルとインフラストラクチャが同期していない理由を理解してください。一般的な原因は次のとおりです。

• Terraform 外部のインフラストラクチャへの手動変更。
• 実行中の問題点 terraform apply コマンド。
• 複数のユーザーが適切なロックなしで同時に状態を変更します。

2. 状態を更新する

まず、Terraformの状態を更新して、インフラストラクチャから最新の情報を取得します。

terraform refresh

このコマンドは、リソースの現在の状態で状態ファイルを更新します。

3. 不足しているリソースをインポートする

クラウド インフラストラクチャにリソースが存在するが、状態ファイルにない場合は、それらを Terraform にインポートできます。

terraform import . 

例

terraform import aws_instance.example i-1234567890abcdef0

このコマンドは、指定されたリソースを状態ファイルにインポートするように Terraform に指示します。

4. 状態ファイルを手動で編集する（上級）

場合によっては、状態ファイルを手動で編集する必要があります。この方法はリスクが伴うため、注意して使用する必要があります。

1. 状態ファイルをバックアップします。 変更を加える前に、状態ファイルのバックアップを作成してください。
2. 状態ファイルを編集します。 状態ファイルを開き、インフラストラクチャの正しい状態を反映するように手動で編集します。誤った編集はさらなる問題を引き起こす可能性があるため、この手順は十分に注意してください。

5. 使用 terraform state コマンド

Terraform には、状態ファイルをインフラストラクチャに合わせるのに役立つ状態操作コマンドがいくつか用意されています。

• terraform state list: 状態内のすべてのリソースを一覧表示します。
• terraform state rm : 状態からリソースを削除します。
• terraform state mv: 状態内のリソースを移動します。

リソースの削除の例

terraform state rm aws_instance.example

このコマンドは、実際のインフラストラクチャに影響を与えずに、指定されたリソースを状態ファイルから削除します。

6. 状態ファイルを再作成する

状態ファイルが大幅に破損しているか同期が取れておらず、手動での修正が不可能な場合は、状態ファイルを最初から再作成する必要がある場合があります。

1. リソースを破壊する: Terraform によって管理されている現在のリソースを慎重に破棄します。

terraform destroy

2. リソースを再作成する: Terraform 構成を使用してリソースを再作成します。

terraform apply

リソースを破棄する前に、バックアップがあることを確認し、影響を認識しておいてください。

7. 状態ロックを有効にする

将来的に状態ファイルの問題が発生するのを防ぐには、状態ロックがまだ有効になっていない場合は有効にします。これはチーム環境では特に重要です。

• ロック用 DynamoDB を使用した S3 バックエンド

terraform {
backend "s3" {
bucket         = "my-terraform-state"
key            = "path/to/my/key"
region         = "us-east-1"
dynamodb_table = "my-lock-table"
}
}

8. 一貫したワークフロー

Terraform を使用してインフラストラクチャを管理するための一貫したワークフローを確立します。

• Terraform の外部のインフラストラクチャに手動で変更を加えないようにしてください。
• Terraform 構成ファイルのバージョン管理を使用します。
• CI/CD パイプラインを実装して、Terraform のデプロイメントを自動化します。

まとめ

1. 状態を更新して現在のインフラストラクチャと同期します。
2. 不足しているリソースを Terraform にインポートします。
3. 必要に応じて、状態ファイルを手動で編集します (注意して)。
4. 使用 terraform state 状態を調整するためのコマンド。
5. 状態ファイルが大幅に破損している場合は再作成します。
6. 将来の問題を防ぐために状態ロックを有効にします。
7. インフラストラクチャを管理するための一貫したワークフローを確立します。

これらの手順に従うことで、Terraform 状態ファイルとクラウド インフラストラクチャ間の不一致を解決し、スムーズで信頼性の高いインフラストラクチャ管理を実現できます。