メインコンテンツへスキップ
見出し画像

terraform plan を定期 CI として実行する - IaC の宣言と実環境の乖離を検出する

    こんにちは. Funds プラットフォーム開発部の上村です.

    Terraform でインフラを管理していても, コードと実環境が常に一致しているとは限りません. apply の実行漏れもありますし, Terraform 以外の経路からリソースが変更されることもあります.

    そこで, 個人のインフラで運用していた terraform plan の定期実行を, 仕事にも導入しました. HCP Terraform (旧 Terraform Cloud. 以下 Terraform Cloud) の各 Workspace で plan を実行し, 差分やエラーを Slack に通知する仕組みです.

    感覚としては, terraform plan をインフラの定期 CI として位置付けています.

    前提: apply の実行経路を揃える

    私たちの運用では, terraform apply は Terraform Cloud の Remote Execution でのみ許可しています. State の保存先だけでなく実行場所も揃え, コードのレビュー, plan の確認, apply の履歴を追えるようにしています.

    ただし, 実行経路を限定しても, apply の実行漏れや Terraform 外からの変更はなくなりません. 定期 plan で差分を見つけ, run 履歴や監査ログと照合して原因を調べます.

    目的: terraform plan を定期 CI にする

    Pull Request の plan は, 提案された変更の影響を確認するものです. 一方, 定期 plan は, 次のコード変更を待たずに宣言と実環境の整合性を確認するものです. 主な目的は以下の2つです.

    • apply の実行漏れの検知: 変更後のコードが Workspace に取り込まれていても, apply されていなければ差分が残ります. その差分を確認し, 実行漏れに気づけるようにします.

    • リソース直接操作による攻撃の早期検知: 認証情報の悪用などによる変更を, 宣言との差分から調査するきっかけにします.

    差分は不正な変更の証明ではなく, apply 待ちや意図的な変更も含みます. また, Terraform 管理外の変更や, 次の確認までに元へ戻された操作まで網羅的に検知するものではありません.

    仕組み: 検知して通知し, 修正は分ける

    GitHub Actions を実行の起点にし, Terraform Cloud で plan を実行して, 結果を Slack に通知します.

    GitHub Actions で定期実行 / 手動実行
      ↓
    対象 Workspace ごとに plan-only run を作成
      ↓
    Terraform Cloud で plan を実行
      ↓
    結果を確認し, 差分やエラーを Slack に通知

    保存された State を読むだけでは, 実環境の現在の状態は分かりません. Terraform Cloud に plan-only run を作成し, 実環境を参照した plan の評価結果を使います. apply は行わず, GitHub Actions 側に別の Terraform 実行環境を用意する必要もありません.

    結果は「差分なし」「差分あり」「エラー」「タイムアウト」に分け, 差分なしの場合だけ通知しません. 確認できなかったことを正常扱いしないために, 差分と確認失敗は区別します.

    通知から該当の plan を確認し, 変更の意図を調べます. 実環境をコードの宣言へ戻すのか, 必要な変更をコードへ取り込むのかは, その後に判断します. 検知した差分を無条件に修正する仕組みにはしていません.

    補足: Health Assessments

    Terraform Cloud には, drift を定期的に検知する Health Assessments という機能もあります. Standard / Premium 向けの機能で, 個人の環境では Free プランを使っていたため選択肢にありませんでした. 私は記事を書く中で知りました.

    当初は apply 漏れを見つけたいという目的から, plan を定期実行する方式にしています. 標準機能も含め, 目的や利用条件に合わせて選ぶとよいと思います.

    雑感

    個人のインフラでは, セキュリティーを保ってくれるのは自分しかいませんし, 何かあれば後始末をするのも自分です. 自然と運用にもシビアになり, 「設定したつもり」ではなく, 今も設定通りなのかを確認したくなります. 定期 plan は, その確認を機械にやって貰うために使っていました.

    仕事でも, apply の実行漏れや意図しない変更に早く気づきたいという点は同じです. 個人の環境で運用していた仕組みを, その確認にも使うことにしました.

    当社には「超・自分ごと」というバリューがあります. 個人のインフラは, 自分ごとにしようと意識するまでもなく自分ごとです. そこで自然に身に付いた運用の姿勢を, 仕事にも持っていけるとよいと思います.

    定義があることと, その通りに運用されていることは別です. 「コードで管理している」で終わらせず, 「コードと一致しているかを確認している」まで持っていく. 地味ですが, こういう部分も運用・維持の仕事だと思います.

    採用情報

    堅牢なシステム開発に興味のある方は, ぜひ採用情報をご覧ください.


     
     
    Software engineer. 💡問題⇒解決=憂さ⇒晴らし. なるほど, 分からん. 分かるのは手を動かしたことだけ.

    あなたへのおすすめ