リソース参照の構文
AWSなどのクラウドサービスでインフラを構築する際、リソース同士は独立しているわけではなく、関係性を持っています。例えば、「作成したVPCの中に、サブネットを作りたい」という場合です。この時、サブネット側では「どのVPCに所属するか」を指定する必要があります。
1. 参照の構文
リソースの値(属性)を参照するには、以下の構文を使用します。
リソースの型.リソース名.属性
例えば、aws_vpc というリソース型で、vpc という名前で定義したVPCの、ID(id)を参照したい場合は、以下のように記述します。
aws_vpc.vpc.id
各リソースで参照できる属性(id 以外にも arn や cidr_block など)は、リソースごとにTerraform Registryのドキュメント(例:aws_vpc)の「Attribute Reference」セクションにまとめられています。
2. サンプル
実際に値を参照するサンプルを説明します。
今回は、VPCとサブネットを作り、サブネットに指定するVPCのIDに、作成したVPCのIDを設定する方法を紹介します。
まず、VPCは通常通りのコードで構いません。
resource "aws_vpc" "vpc" {
cidr_block = "10.0.0.0/16"
tags = {
Name = "test-vpc"
}
}
サブネットの定義部分です。
resource "aws_subnet" "subnet" {
vpc_id = aws_vpc.vpc.id
cidr_block = "10.0.1.0/24"
tags = {
Name = "test-subnet"
}
}
この中で、vpc_id = aws_vpc.vpc.id の部分がポイントです。
こうすることで、サブネットに指定されるVPCのIDは、直前の vpc のIDとなります。
| ⚠️ 「has not been declared」エラーが出る場合 |
|---|
aws_vpc.vpc.id の部分で、リソース名(2つ目の vpc)を間違えると「A managed resource "aws_vpc" "xxx" has not been declared」というエラーが発生します。エラーが出たら、リソース定義の名前(resource "aws_vpc" "vpc" の "vpc" 部分)と参照先が一致しているか確認してください。 |
3. 実行順序の自動制御
リソース間の参照による依存関係と作成順序の例を以下に示します。
この記述の重要な点は、Terraformがリソースを作成する順番を自動的に判断してくれることです。
aws_subnet を作るためには、vpc_id が必要です。
vpc_id を知るためには、先に aws_vpc が作られている必要があります。
Terraformはこの関係性をコードから読み取り、「まずはVPCを作成し、その完了後にサブネットを作成する」という正しい順序で処理を実行します。