【Terraform】【AWS】Map変数をModuleに渡してマルチAZ構成のVPCを作る

2022 11/18

前書き

やること

本日はTerraformのお話です。

Map型で宣言した変数を、Moduleに渡してみたいと思います。

得られるメリット

Map型の変数を使用することによって階層構造で定義することができ、視覚的にわかりやすくすることができます。

また、Map型で定義した変数をfor_eachで繰り返して、マルチAZ構成のサブネット等が作れます。

リスト型で定義してしまうと、それぞれのAZの情報の数（サブネットの数など）を合わせる必要が出てきますが、Map型であれば必要なくなります。

リスト型だとインデックスが0から始まり、インクリメントをする必要が出てきますが、Map型の場合はKeyで指定するのでインクリメントのズレによるバグも防げます。

リスト型だとインデックスが0から始まるので、片系を”01″、片系を”02″と呼びたいときにずれが発生しますが、Map型なら自由に決められます。

やってみる

ディレクトリ構成

ディレクトリ構成は以下のようになっています。

{root}/
|
|---[environment]
|      |---[dev]
|          |---main.tf
|          |---provider.tf
|          |---variable.tf　←Map型変数を定義する。
|
|---[module]
       |---[Network]
           |---vpc.tf
           |---subnet.tf
           |---variable.tf

dev/environmentディレクトリがTerraform実行ディレクトリです。

ここのvariable.tfにMap型変数でそれぞれのAZの情報を定義します。

コード内容

コードの内容を記載していきます。

dev/provider.tf

terraform {
  required_version = "~> 1.2.0"
  required_providers {
    aws = {
      source  = "hashicorp/aws"
      version = "~> 4.38.0"
    }
  }
}

provider "aws" {
  region = "us-east-1"
}

TerraformとAWSレジストリのバージョン、AWSのリージョンを指定しています。

dev/variable.tf

variable "param" {
  default = {
    sysname    = "demo"
    env        = "dev"
    cidr_block = "10.0.0.0/16"
    zone = {
      "01" = {
        az           = "us-east-1a"
        public_cidr  = "10.0.1.0/24"
        private_cidr = "10.0.10.0/24"
      },
      "02" = {
        az           = "us-east-1c"
        public_cidr  = "10.0.2.0/24"
        private_cidr = "10.0.20.0/24"
      }
    }
  }
}

今回の肝となるコードです。

Map変数名はparamとして、その中にsysname(システム名)、env(環境名)、cidr_block(VPCのCIDR)、zone(各AZ固有の情報)を定義しています。zoneはMap変数として、Keyを”01″と”02″で分け、それぞれに各AZの情報を定義しました。

dev/main.tf

module "network" {
  source     = "../../module/Network"
  sysname    = var.param.sysname
  env        = var.param.env
  cidr_block = var.param.cidr_block
  zone       = var.param.zone
}

Map変数のparamをnetworkモジュールに渡しています。

Map型の変数のため、var.[変数名].[変数名]の形で値にアクセスできます。

module/Network/variable.tf

### module/Network/variable.tf
variable "sysname" {}
variable "env" {}
variable "zone" {}
variable "cidr_block" {}

main.tfから渡された変数をnetworkモジュールで扱えるようにするため、networkモジュール内のvariable.tfでも変数宣言をします。

module/Network/vpc.tf

### VPC
resource "aws_vpc" "vpc" {
  cidr_block = var.cidr_block
  tags = {
    "Name" = "${var.env}-${var.sysname}-vpc"
  }
}

VPCを作成しています。

main.tfから渡された変数に対して、var.[変数名]でアクセスしています。

module/Network/subnet.tf

### パブリックサブネット
resource "aws_subnet" "public_subnet" {
  for_each          = var.zone
  vpc_id            = aws_vpc.vpc.id
  cidr_block        = each.value.public_cidr
  availability_zone = var.zone[each.key].az
  tags = {
    "Name" = "${var.env}-${var.sysname}-public-subnet-${each.key}"
  }
}

### プライベートサブネット
resource "aws_subnet" "private_subnet" {
  for_each          = var.zone
  vpc_id            = aws_vpc.vpc.id
  cidr_block        = each.value.private_cidr
  availability_zone = var.zone[each.key].az
  tags = {
    "Name" = "${var.env}-${var.sysname}-private-subnet-${each.key}"
  }
}

パブリックサブネット×２とプライベートサブネット×２を作っています。

for_eachをMap型変数のzoneで繰り返して、それぞれのサブネットをus-east-1aとus-east-1cに作っています。

AZ(us-east-1aorus-east-1c)は、var.zone[each.key].azで取得しています。

tagsのところを見ていただきたいのですが、${each.key}でKeyを取得しています。us-east-1aであれば01、us-east-1cであれば02となります。