メインコンテンツまでスキップ

tag の例

tag を使うと、プロジェクト、環境、所有チームごとにリソースを分類でき、コストの追跡やポリシーの適用が容易になります。Terraform では、tag を一度作成すれば構成内のすべてのリソースに付与できるため、新しいリソースへの tag の付け忘れがなくなります。tag の概念については FPT Cloud Tagging を参照してください。

前提条件​

tag の付与は 2 つの手順で行う​

  1. resource fptcloud_tagging で tag を作成します。
  2. tag の ID を各リソースの tag_ids 引数に指定します。

このガイドで tag_ids を受け付ける resource は、fptcloud_instance、fptcloud_storage、fptcloud_subnet、fptcloud_security_group、fptcloud_floating_ip、fptcloud_snapshot です。

tag を作成する​

# tags.tf
resource "fptcloud_tagging" "env_production" {
key = "environment"
value = "production"
color = "#057a55"
scope_type = "ORG"
}

resource "fptcloud_tagging" "team_payments" {
key = "team"
value = "payments"
scope_type = "ORG"
}
  • key は必須で、value と color は任意です。
  • scope_type = "ORG" を指定すると、Portal で作成した tag と同様に、組織全体で tag を使用できます。
  • color には tag の色 の表にあるカラーコードを指定します。

リソースに tag を付与する​

tag を付与するリソースに tag_ids を追加します。

# tagged.tf
data "fptcloud_vpc" "example" {
name = "example-vpc"
}

resource "fptcloud_subnet" "payments" {
vpc_id = data.fptcloud_vpc.example.id
name = "payments-subnet"
type = "NAT_ROUTED"
cidr = "10.30.1.0/24"
gateway_ip = "10.30.1.1"
tag_ids = [fptcloud_tagging.env_production.id, fptcloud_tagging.team_payments.id]
}
# tagged.tf
resource "fptcloud_floating_ip" "payments" {
vpc_id = data.fptcloud_vpc.example.id
tag_ids = [fptcloud_tagging.env_production.id, fptcloud_tagging.team_payments.id]
}

Instance と disk の場合は、fptcloud_instance または fptcloud_storage ブロックに同じ tag_ids の行を追加します。tag はその場で更新されるため、tag を追加または削除してもリソースは再作成されません。

すべてのリソースに共通の tag セットを付与する​

共通の tag セットを locals で宣言し、すべてのリソースで再利用します。tag を追加する必要がある場合も、1 か所を編集するだけで済みます。

# common-tags.tf
locals {
common_tag_ids = [
fptcloud_tagging.env_production.id,
fptcloud_tagging.team_payments.id,
]
}

その後、各リソースに tag_ids = local.common_tag_ids を設定します。

map から複数の tag を作成する​

# tags-map.tf
locals {
tags = {
environment = "staging"
project = "online-shop"
cost-center = "cc-1024"
}
}

resource "fptcloud_tagging" "this" {
for_each = local.tags

key = each.key
value = each.value
scope_type = "ORG"
}

ID の一覧は [for t in fptcloud_tagging.this : t.id] で取得します。

既存の tag を再利用する​

tag がすでに Portal で作成されている場合は、再作成するのではなく data source で tag を読み取ります。

# existing-tag.tf
data "fptcloud_tagging" "owner" {
key = "owner"
value = "platform-team"
}

tag_ids には data.fptcloud_tagging.owner.tags[0].id を使用します。

tag の色​

色color の値
Gray#4b5563
Red#c81e1e
Orange#d03801
Yellow#dc6803
Green#057a55
Teal#047481
Indigo#5850ec
Purple#6c2bd9
Sky blue#00bfff

値では大文字と小文字は区別されません。色のない tag を作成するには、color を空のままにします。

次のステップ​