count

これまでは、1つのリソースブロックで1つのリソース(EC2やVPCなど)を作成してきました。しかし、「同じ構成のWebサーバを3台作りたい」「サブネットを複数作りたい」という場合、コードをコピー&ペーストして増やすのは効率が悪く、修正も大変になります。

1. 概要

これまでは、1つのリソースブロックで1つのリソース(EC2やVPCなど)を作成してきました。 しかし、「同じ構成のWebサーバを3台作りたい」「サブネットを複数作りたい」という場合、コードをコピー&ペーストして増やすのは効率が悪く、修正も大変になります。

このような「同じリソースを複数個作成したい」場合に利用するのが、count というメタ引数です。

2. 記載方法

リソースブロックの中に count = 回数 を指定するだけで、その回数分だけリソースが作成されます。

また、作成されるリソースには「インデックス番号(0から始まる連番)」が割り当てられます。この番号は count.index という変数で取得でき、名前などに利用することで、それぞれのリソースを区別できます。

resource "リソース型" "名前" {
  count = 作成数

  # count.index で現在のインデックス(0, 1, 2...)を参照可能
  属性 = "値-${count.index}"
}

3. サンプルコード(EC2の例)

例えば、全く同じ設定のEC2インスタンスを3台作成し、それぞれに「Web-0」「Web-1」「Web-2」という名前を付ける場合は以下のようになります。

resource "aws_instance" "web" {
  count = 3  # 3台作成する

  ami           = "ami-0abcdef1234567890"
  instance_type = "t2.micro"

  tags = {
    # count.index には 0, 1, 2 が順番に入る
    Name = "Web-${count.index}"
  }
}

4. 実際に使ってみる

今回は、IAMユーザを3人分作成するシンプルな例で動作を確認してみましょう。 (IAMユーザは作成・削除が早く、料金もかからないため、count の挙動確認に適しています)

4.1 コードの記載

main.tf に以下のコードを記述(または追記)してください。

provider "aws" {
  region = "ap-northeast-1"
}

resource "aws_iam_user" "users" {
  count = 3 # 3人のユーザを作成

  # nameに count.index を使って、user-0, user-1, user-2 とする
  name = "test-user-${count.index}"
}

4.2 リソースの作成

この状態で、terraform apply を実行します。

terraform apply
⚠️ 「EntityAlreadyExists」エラーが出る場合
同名のIAMユーザがすでに存在しています。
AWSコンソールで既存のユーザを削除するか、コード内のnameの値(例:test-user-の部分)を別の名前に変更してください。

実行プラン(Plan)を確認すると、以下のように配列形式で表示されます。

aws_iam_user.users[0]
aws_iam_user.users[1]
aws_iam_user.users[2]

これら3つのリソースが作成されることを確認し、yes で適用してください。

マネジメントコンソールのIAMの画面を確認すると、「test-user-0」「test-user-1」「test-user-2」が作成されているはずです。

確認が終わったらリソースを削除しておきます。

terraform destroy

5. 注意点:countのインデックスずれ

count は非常に便利ですが、「リストの順番(インデックス)」に依存してリソースを管理するという特性があります。

例えば、リスト変数を使ってリソースを作成している場合、リストの途中の要素を削除すると、それ以降のインデックス番号がすべてズレてしまいます。Terraformは「インデックスが変わった=別物」と判断し、意図しないリソースの削除・再作成が発生するリスクがあります。

順序が重要でない単純な数量(例:サーバ台数)の調整には count が適していますが、特定の値をキーにして個別に管理したい場合(例:ユーザ名ごとの管理など)は、この後学習する for_each の方が安全な場合があります。

💡 ポイント
迷ったら for_each を使うことをお勧めします。count はシンプルですが、要素の追加・削除時にインデックスがずれて意図しないリソースの再作成が発生するリスクがあります。for_each はキーで管理するため、このリスクを避けられます。