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

AWS Proton リソースとタグ付け

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

AWS タグ付け

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

AWS Proton タグ付け

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

AWS ProtonAWS マネージドタグ

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

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

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

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

次に示すのは、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 で提供されます。default_tags に AWS Proton タグを含めるために、Terraformの設定でこの変数を参照することが推奨されています。これにより、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"