tag の例
tag を使うと、プロジェクト、環境、所有チームごとにリソースを分類でき、コストの追跡やポリシーの適用が容易になります。Terraform では、tag を一度作成すれば構成内のすべてのリソースに付与できるため、新しいリソースへの tag の付け忘れがなくなります。tag の概念については FPT Cloud Tagging を参照してください。
前提条件
- ✅ セットアップと設定 を完了していること。
- ✅ アカウントに tag を作成する権限があること。
tag の付与は 2 つの手順で行う
- resource
fptcloud_taggingで tag を作成します。 - 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 を空のままにします。