翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

AWS Proton リソースとタグ付け

AWS Proton Amazon リソースネーム (ARN) が割り当てられた リソースには、環境テンプレートとそのメジャーバージョンとマイナーバージョン、サービステンプレートとそのメジャーバージョンとマイナーバージョン、環境、サービス、サービスインスタンス、コンポーネント、リポジトリが含まれます。タグ付けすることによって、これらのリソースを整理して特定できます。タグを使用し、リソースを目的、所有者、環境などの基準別に分類できます。詳細については、「タグ付け戦略」を参照してください。 AWS Proton リソースを追跡し、管理するには、次のセクションで説明するように、タグ付け機能を使用します。

AWS タグ付け

タグの AWS 形式でリソースにメタデータを割り当てることができます。各タグは、お客様が定義するキーとオプションの値で構成されます。タグは、リソースの管理、識別、整理、検索、フィルタリングに役立ちます。

AWS Proton タグ付け

を使用すると AWS Proton、作成したタグと AWS Proton が自動的に生成するタグの両方を使用できます。

AWS ProtonAWS マネージドタグ

AWS Proton リソースを作成すると、次の図に示すように、 は新しいリソースの AWS マネージドタグ AWS Proton を自動的に生成します。 AWS マネージドタグは、後で新しい AWS Proton リソースに基づく他のリソースに伝播されます。たとえば、環境テンプレートのマネージドタグはそのバージョンに伝えられ、サービスのマネージドタグはサービスインスタンスに伝えられます。

プロビジョニングされたリソースへのタグの伝達

サービステンプレートや環境テンプレートで定義されているようなプロビジョニングされたリソースが AWS タグ付けをサポートしている場合、 AWS マネージドタグはカスタマーマネージドタグとしてプロビジョニングされたリソースに伝播されます。これらのタグは、 AWS タグ付けをサポートしていないプロビジョニングされたリソースには伝播されません。

AWS Proton は、次の表に示すように、 AWS Proton アカウント、登録済みテンプレート、デプロイ済み環境、サービス、サービスインスタンスごとにリソースにタグを適用します。 AWS マネージドタグを使用して AWS Proton リソースを表示および管理することはできますが、変更することはできません。

以下は、 AWS Proton リソースの AWS マネージドタグの例です。

"aws:proton:template" = "arn:aws:proton:region-id:account-id:environment-template/env-template"

以下は、 マネージドタグから伝播されたプロビジョニングされたリソースに適用されるカスタマー AWS マネージドタグの例です。

"proton:environment:database" = "arn:aws:proton:region-id:account-id:rds/env-db"

AWSマネージドプロビジョニングでは、 は伝播されたタグをプロビジョニングされたリソースに直接 AWS Proton 適用します。

セルフマネージドプロビジョニングでは、 AWS Proton は、プロビジョンプルリクエスト (PR) で送信するレンダリングされた IaC ファイルとともに、伝播されたタグを利用できるようにします。タグは文字列マップ変数 proton_tags で提供されます。に AWS Proton タグを含めるには、Terraform 設定でこの変数を参照することをお勧めしますdefault_tags。これにより、 AWS Proton タグはプロビジョニングされたすべてのリソースに伝えられます。

次の例は、環境 Terraform テンプレートにおけるこのタグ伝達方法を示しています。

proton_tags 変数の定義は次のとおりです。

proton.environment.variables.tf:

variable "environment" {
  type = object({
    inputs = map(string)
    name = string
  })
}

variable "proton_tags" {
  type = map(string)
  default = null
}

この変数にタグ値を割り当てる方法は次のとおりです。

proton.auto.tfvars.json:

{
  "environment": {
    "name": "dev",
    "inputs": {
      "ssm_parameter_value": "MyNewParamValue"
    }
  }

  "proton_tags" : {
    "proton:account" : "123456789012",
    "proton:template" : "arn:aws:proton:us-east-1:123456789012:environment-template/fargate-env",
    "proton:environment" : "arn:aws:proton:us-east-1:123456789012:environment/dev"
  }
}

また、プロビジョニングされたリソースに追加されるように Terraform 設定に AWS Proton タグを追加する方法は次のとおりです。

# Configure the AWS Provider
provider "aws" {
  region = var.aws_region
  default_tags {
    tags = var.proton_tags
  }
}

ユーザーマネージドタグ

各 AWS Proton リソースには、カスタマー管理タグの最大クォータが 50 個あります。カスタマーマネージドタグは、 AWS マネージドタグと同じ方法で子 AWS Proton リソースに伝達されます。ただし、既存のリソースやプロビジョニングされた AWS Proton リソースには伝達されません。既存の子リソースを持つ リソースに AWS Proton 新しいタグを適用し、既存の子リソースに新しいタグを付ける場合は、 コンソールまたは を使用して、既存の各子リソースに手動でタグを付ける必要があります AWS CLI。

コンソールおよび CLI を使用してタグを作成する

コンソールを使用して AWS Proton リソースを作成すると、次のコンソールスナップショットに示すように、作成手順の 1 ページ目または 2 ページ目にカスタマーマネージドタグを作成する機会が与えられます。[Add new tag (新しいタグを追加)] を選択し、キーと値を入力して続行します。

AWS Proton コンソールを使用して新しいリソースを作成したら、詳細ページから AWS マネージドタグとカスタマーマネージドタグのリストを表示できます。

を使用してタグを作成する AWS ProtonAWS CLI

を使用してタグを表示、作成、削除、編集できます AWS Proton AWS CLI。

次の例に示すように、リソースのタグを作成または編集できます。

$ aws proton tag-resource \
    --resource-arn "arn:aws:proton:region-id:account-id:service-template/webservice" \
    --tags '[{"key":"mykey1","value":"myval1"},{"key":"mykey2","value":"myval2"}]'

次の例に示すように、リソースのタグを削除できます。

$ aws proton untag-resource \
    --resource-arn "arn:aws:proton:region-id:account-id:service-template/webservice" \
    --tag-keys '["mykey1","mykey2"]'

最後の例に示すように、リソースのタグを一覧表示できます。

$ aws proton list-tags-for-resource \
    --resource-arn "arn:aws:proton:region-id:account-id:service-template/webservice"