インフラストラクチャドリフト検出器

このスキルはインフラストラクチャドリフト検出器タスクの自動サポートを提供します。

前提条件

このスキルを使用する前に、以下を確認してください:

• インフラストラクチャ as Code (IaC) ファイルが {baseDir} に最新の状態で存在すること
• クラウドプロバイダ CLI がインストールされ認証されていること
• IaC ツール (Terraform/CloudFormation/Pulumi) がインストールされていること
• リモート状態ストレージが設定され、アクセス可能であること
• インフラストラクチャリソースへの適切な読み取り権限があること

手順

1. IaC ツールの識別: Terraform、CloudFormation、Pulumi、または ARM を使用しているかを判断します
2. 現在の状態を取得: クラウドプロバイダから実際のインフラストラクチャ状態を取得します
3. 望ましい状態を読み込む: {baseDir}/terraform またはそれに相当するディレクトリから IaC 設定を読み込みます
4. 状態を比較: IaC プラットフォーム用のドリフト検出コマンドを実行します
5. 相違を分析: 追加、修正、または削除されたリソースを識別します
6. レポートを生成: 影響を受けるリソースを含むドリフトの詳細レポートを作成します
7. 修復策を提案: ドリフトを解決するコマンドを提供します (apply または import)
8. 結果を記録: ドリフトレポートを {baseDir}/drift-reports/ に保存します

出力

ドリフト検出レポートを生成します:

Terraform ドリフトレポート:

Drift Detection Report - 2025-12-10 10:30:00
==============================================

Resources with Drift: 3

1. aws_instance.web_server
   Status: Modified
   Drift: instance_type changed from "t3.micro" to "t3.small"
   Action: Update IaC to match or revert instance type

2. aws_s3_bucket.assets
   Status: Modified
   Drift: versioning_enabled changed from true to false
   Action: Re-enable versioning or update IaC

3. aws_iam_role.lambda_exec
   Status: Deleted
   Drift: Role no longer exists in AWS
   Action: terraform apply to recreate

Remediation Command:
terraform plan -out=drift-fix.tfplan
terraform apply drift-fix.tfplan

CloudFormation ドリフト:

StackName: production-vpc
DriftStatus: DRIFTED
Resources:
  - LogicalResourceId: VPC
    ResourceType: AWS::EC2::VPC
    DriftStatus: IN_SYNC
  - LogicalResourceId: PublicSubnet
    ResourceType: AWS::EC2::Subnet
    DriftStatus: MODIFIED
    PropertyDifferences:
      - PropertyPath: /Tags
        ExpectedValue: [{Key: Env, Value: prod}]
        ActualValue: [{Key: Env, Value: production}]

エラーハンドリング

一般的な問題と解決策:

状態ロックエラー

• エラー: "Error acquiring state lock"
• 解決策: 他の terraform プロセスが実行されていないことを確認するか、安全であれば強制的にロックを解除します

認証エラー

• エラー: "Unable to authenticate to cloud provider"
• 解決策: aws configure または gcloud auth login で認証情報を更新します

状態ファイルが見つからない

• エラー: "No state file found"
• 解決策: terraform init で Terraform を初期化するか、リモートバックエンドを指定します

アクセス拒否

• エラー: "Access denied reading resource"
• 解決策: サービスアカウントに読み取り専用の IAM 権限を付与します

状態ファイルバージョン不一致

• エラー: "State file version too new"
• 解決策: Terraform バージョンをアップグレードするか、互換性のある状態バージョンを使用します

リソース

• Terraform ドリフトドキュメント: https://www.terraform.io/docs/cli/state/
• AWS CloudFormation ドリフト検出: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/detect-drift-stack.html
• {baseDir}/docs/drift-remediation.md のドリフト修復ベストプラクティス
• {baseDir}/scripts/drift-check.sh の自動ドリフト検出スクリプト

概要

このスキルは、説明された機能の自動サポートを提供します。

例

使用パターンの例はコンテキストに応じてデモンストレーションされます。