Terraform Cloudで課金対象となるリソース合計数を、コマンドで取得する
宣伝記事です。
2023年5月より、Terraform Cloudで新しい料金体系が導入された。多くの人が使うであろう、Free tierと真ん中のStandard tierはリソース数に応じた課金（Freeはリソース数500までの制限）、という説明になっているが、パッと見では、何のリソースのことかよくわからない。
結論から言うと、Terraform Cloudに保存しているState上に記録されたリソース数の合計ということになる。要するに terraform state list で出てくるリソースの数ということになるのだが、 null_resource や data は含まないということで、ただそのまま数えればいいというわけではない。
こちらのClassmethodの記事にそのあたりは詳しく書いてあり、Terraform CloudのGUI上における数え方も記載されている。ただ残念なのは、まだ新料金体系で契約をしていない場合、課金対象となるOrganization全体のリソース数を直接見る手段がなく、各Workspaceのリソース数を1つずつ見て足し合わせるしかないということだ。Standard tierへ移行する前に、どの程度の料金になるのか見積もりたくても、そのための手段がないというのは、ちょっと不便だと思う。
というところで宣伝にはなるが、Terraform CloudのAPIを実行する tfcloud というCLIツールを以前から作っている。これの workspace view コマンドを使えば、以下のようにリソース数を始めとした情報を取得できる。何もオプションを付けずに実行すれば、カレントディレクトリのTerraformの設定を見て、そのbackendとなっているWorkspaceの情報を取得する。
$ tfcloud workspace view
Name: test-a
Terraform Version: 1.6.2
VCS Repo:
Working Directory:
Execution mode: local
Auto Apply: false
Resource count: 1
Created at: 2023-05-05 00:16:03 (UTC)
Updated at: 2023-08-02 10:42:25 (UTC)
URL: https://app.terraform.io/app/chroju/workspaces/test-a
すべてのWorkspaceの情報を一括で取得するなら workspace list コマンドを使えばいい。 --format json を付加すれば、全Workspaceの情報が単純に配列になった形の雑なJSON構造で落ちてくるので、こういう感じでjqを使えば一発でリソース数合計も取れる。
$ tfcloud workspace list chroju --format json | jq '[.[].resource_count] | add'
122
tfcloud、ローカルからTerraform Cloudの情報を取るのには結構便利で、自分用のツールとしてちまちまと使い続けている。最近 tfc-workflows-tooling という、Terraform CloudのAPIを実行する公式のツールも出てきたので、tfcloudはお役御免になるかなと期待もしているが、こちらは plan や discard を実行する、本当にワークフロー周りのAPIしか実装しないようで、しばらくはtfcloudが必要そうだ。OpenTofuの顛末を見ていると、これも名前を変えたほうがいいのかな、とちょっと思っている。