Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

AWS Proton sumber daya dan penandaan

AWS Proton sumber daya yang diberi Nama Sumber Daya Amazon (ARN) mencakup templat lingkungan dan versi mayor dan minor, templat layanan dan versi mayor dan minor, lingkungan, layanan, instance layanan, komponen, dan repositori. Anda dapat menandai sumber daya ini untuk membantu Anda mengatur dan mengidentifikasi mereka. Anda dapat menggunakan tag untuk mengategorikan sumber daya berdasarkan tujuan, pemilik, lingkungan, atau kriteria lainnya. Untuk informasi selengkapnya, lihat Strategi Penandaan . Untuk melacak dan mengelola AWS Proton sumber daya, Anda dapat menggunakan fitur penandaan yang dijelaskan di bagian berikut.

AWS penandaan

Anda dapat menetapkan metadata ke AWS sumber daya Anda dalam bentuk tag. Setiap tag terdiri dari kunci yang ditentukan pelanggan dan nilai opsional. Tanda dapat membantu Anda mengelola, mengidentifikasi, mengatur, dan memfilter sumber daya.

AWS Proton penandaan

Dengan AWS Proton, Anda dapat menggunakan kedua tag yang Anda buat serta tag yang AWS Proton secara otomatis menghasilkan untuk Anda.

AWS ProtonAWS tag terkelola

Saat Anda membuat AWS Proton sumber daya, AWS Proton secara otomatis menghasilkan tag AWS terkelola untuk sumber daya baru Anda seperti yang ditunjukkan pada diagram berikut. AWS tag terkelola kemudian menyebar ke AWS Proton sumber daya lain yang didasarkan pada sumber daya baru Anda. Misalnya, tag terkelola dari templat lingkungan menyebar ke versinya, dan tag terkelola dari layanan menyebar ke instance layanannya.

Perbanyakan tag ke sumber daya yang disediakan

Jika sumber daya yang disediakan, seperti yang didefinisikan dalam templat layanan dan lingkungan, mendukung penandaan, AWS tag terkelola akan menyebar sebagai tag yang AWS dikelola pelanggan ke sumber daya yang disediakan. Tag ini tidak akan menyebar ke sumber daya yang disediakan yang tidak mendukung penandaan. AWS

AWS Proton menerapkan tag ke sumber daya Anda berdasarkan AWS Proton akun, templat terdaftar, dan lingkungan yang diterapkan, serta layanan dan instance layanan seperti yang dijelaskan dalam tabel berikut. Anda dapat menggunakan tag AWS terkelola untuk melihat dan mengelola AWS Proton sumber daya Anda, tetapi Anda tidak dapat memodifikasinya.

Berikut ini adalah contoh tag AWS terkelola untuk AWS Proton sumber daya.

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

Berikut ini adalah contoh tag terkelola pelanggan yang diterapkan ke sumber daya yang disediakan yang disebarkan dari tag terkelola AWS .

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

Dengan penyediaan AWS-managed, AWS Proton menerapkan tag yang disebarkan langsung ke sumber daya yang disediakan.

Dengan penyediaan yang dikelola sendiri, AWS Proton membuat tag yang disebarkan tersedia bersama dengan file IAc yang dirender yang dikirimkan dalam permintaan tarik penyediaan (PR). Tag disediakan dalam variabel peta stringproton_tags. Kami menyarankan Anda membuat referensi ke variabel ini dalam konfigurasi Terraform Anda untuk menyertakan AWS Proton tag di. default_tags Ini menyebarkan AWS Proton tag ke semua sumber daya yang disediakan.

Contoh berikut menunjukkan metode propagasi tag ini di lingkungan Template Terraform.

Berikut definisi proton_tags variabelnya:

proton.environment.variables.tf:

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

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

Berikut cara nilai tag ditetapkan ke variabel ini:

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"
  }
}

Dan inilah cara Anda dapat menambahkan AWS Proton tag ke konfigurasi Terraform Anda sehingga ditambahkan ke sumber daya yang disediakan:

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

Tag terkelola pelanggan

Setiap AWS Proton sumber daya memiliki kuota maksimum 50 tag yang dikelola pelanggan. Tag terkelola pelanggan menyebar ke AWS Proton sumber daya anak dengan cara yang sama seperti tag AWS terkelola, kecuali tag tersebut tidak menyebar ke AWS Proton sumber daya yang ada atau ke sumber daya yang disediakan. Jika Anda menerapkan tag baru ke AWS Proton sumber daya dengan sumber daya turunan yang ada dan Anda ingin sumber daya anak yang ada diberi tag dengan tag baru, Anda perlu menandai setiap sumber daya anak yang ada secara manual, menggunakan konsol atau AWS CLI.

Buat tag menggunakan konsol dan CLI

Saat membuat AWS Proton resource menggunakan konsol, Anda diberi kesempatan untuk membuat tag terkelola pelanggan baik di halaman pertama atau kedua prosedur pembuatan seperti yang ditunjukkan pada snapshot konsol berikut. Pilih Tambahkan tag baru, masukkan kunci dan nilai dan lanjutkan.

Setelah Anda membuat sumber daya baru menggunakan AWS Proton konsol, Anda dapat melihat daftar tag yang AWS dikelola dan dikelola pelanggan dari halaman detail.

Buat tag menggunakan AWS ProtonAWS CLI

Anda dapat melihat, membuat, menghapus, dan mengedit tag menggunakan AWS Proton AWS CLI.

Anda dapat membuat atau mengedit tag untuk sumber daya seperti yang ditunjukkan pada contoh berikut.

$ 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"}]'

Anda dapat menghapus tag untuk sumber daya seperti yang ditunjukkan pada contoh berikutnya.

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

Anda dapat mencantumkan tag untuk sumber daya seperti yang ditunjukkan pada contoh akhir.

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