Bekerja dengan penyediaan tipe perubahan () CTs - Panduan Pengembang Aplikasi AMS Advanced
Lihat apakah CT yang ada memenuhi kebutuhan AndaMinta CT baruUji CT baru

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

Bekerja dengan penyediaan tipe perubahan () CTs

AMS bertanggung jawab atas infrastruktur terkelola Anda, untuk membuat perubahan, Anda harus mengirimkan RFC dengan klasifikasi CT yang benar (kategori, subkategori, item, dan operasi). Bagian ini menjelaskan cara menemukan CTs, menentukan apakah ada yang tepat untuk kebutuhan Anda, dan meminta CT baru jika tidak ada.

Lihat apakah CT yang ada memenuhi kebutuhan Anda

Setelah Anda menentukan apa yang ingin Anda terapkan dengan AMS, langkah selanjutnya adalah mempelajari yang ada CTs dan CloudFormation templat untuk melihat apakah solusi sudah ada.

Saat membuat RFC, Anda harus menentukan CT. Anda dapat menggunakan Konsol Manajemen AWS atau AMS API/CLI. Contoh penggunaan keduanya dijelaskan selanjutnya.

Anda dapat menggunakan konsol atau API/CLI untuk menemukan perubahan jenis ID (CT) atau versi. Ada dua metode, baik pencarian atau memilih klasifikasi. Untuk kedua jenis pilihan, Anda dapat mengurutkan pencarian dengan memilih Paling sering digunakan, Paling baru digunakan, atau Alfabetis.

YouTube Video: Bagaimana cara membuat RFC menggunakan AWS Managed Services CLI dan di mana saya dapat menemukan Skema CT?

Di konsol AMS, pada halaman RFCs-> Buat RFC:

  • Dengan Browse by change type yang dipilih (default), baik:

    • Gunakan area Quick create untuk memilih dari AMS yang paling populer CTs. Klik pada label dan halaman Jalankan RFC terbuka dengan opsi Subjek diisi otomatis untuk Anda. Selesaikan opsi yang tersisa sesuai kebutuhan dan klik Jalankan untuk mengirimkan RFC.

    • Atau, gulir ke bawah ke Semua jenis perubahan area dan mulai mengetik nama CT di kotak opsi, Anda tidak harus memiliki nama jenis perubahan yang tepat atau lengkap. Anda juga dapat mencari CT dengan mengubah jenis ID, klasifikasi, atau mode eksekusi (otomatis atau manual) dengan memasukkan kata-kata yang relevan.

      Dengan tampilan Kartu default yang dipilih, kartu CT yang cocok muncul saat Anda mengetik, pilih kartu dan klik Buat RFC. Dengan tampilan Tabel dipilih, pilih CT yang relevan dan klik Buat RFC. Kedua metode membuka halaman Run RFC.

  • Atau, dan untuk menjelajahi pilihan jenis perubahan, klik Pilih berdasarkan kategori di bagian atas halaman untuk membuka serangkaian kotak opsi drop-down.

  • Pilih Kategori, Subkategori, Item, dan Operasi. Kotak informasi untuk jenis perubahan itu muncul panel muncul di bagian bawah halaman.

  • Saat Anda siap, tekan Enter, dan daftar jenis perubahan yang cocok akan muncul.

  • Pilih jenis perubahan dari daftar. Kotak informasi untuk jenis perubahan itu muncul di bagian bawah halaman.

  • Setelah Anda memiliki jenis perubahan yang benar, pilih Buat RFC.

catatan

AMS CLI harus diinstal agar perintah ini berfungsi. Untuk menginstal AMS API atau CLI, buka halaman Sumber Daya Pengembang konsol AMS. Untuk materi referensi tentang AMS CM API atau AMS SKMS API, lihat bagian Sumber Informasi AMS di Panduan Pengguna. Anda mungkin perlu menambahkan --profile opsi untuk otentikasi; misalnya,aws amsskms ams-cli-command --profile SAML. Anda mungkin juga perlu menambahkan --region opsi karena semua perintah AMS kehabisan us-east-1; misalnya. aws amscm ams-cli-command --region=us-east-1

catatan

Titik akhir AMS API/CLI (amscm dan amsskms) berada di Wilayah AWS N. Virginia,. us-east-1 Bergantung pada bagaimana autentikasi Anda disetel, dan di Wilayah AWS akun dan sumber daya Anda, Anda mungkin perlu menambahkan --region us-east-1 saat mengeluarkan perintah. Anda mungkin juga perlu menambahkan--profile saml, jika itu adalah metode otentikasi Anda.

Untuk mencari jenis perubahan menggunakan AMS CM API (lihat ListChangeTypeClassificationSummaries) atau CLI:

Anda dapat menggunakan filter atau kueri untuk mencari. ListChangeTypeClassificationSummaries Operasi memiliki opsi Filter untukCategory,Subcategory,Item, danOperation, tetapi nilainya harus sama persis dengan nilai yang ada. Untuk hasil yang lebih fleksibel saat menggunakan CLI, Anda dapat menggunakan opsi. --query

Ubah jenis penyaringan dengan AMS CM API/CLI
Atribut Nilai valid Kondisi valid/default Catatan

ChangeTypeId

String apa pun yang mewakili a ChangeTypeId (Misalnya: ct-abc123xyz7890)

Setara

Untuk jenis perubahan IDs, lihat Referensi Ubah Jenis.

Untuk jenis perubahan IDs, lihat Menemukan Jenis Perubahan atau CSIO.

Kategori

Teks bentuk bebas apa pun

Contains

Ekspresi reguler di setiap bidang individu tidak didukung. Pencarian yang tidak peka huruf besar/kecil

Subkategori

Item

Operasi

  1. Berikut adalah beberapa contoh klasifikasi jenis perubahan daftar:

    Perintah berikut mencantumkan semua kategori jenis perubahan.

    aws amscm list-change-type-categories

    Perintah berikut mencantumkan subkategori milik kategori tertentu.

    aws amscm list-change-type-subcategories --category CATEGORY

    Perintah berikut mencantumkan item milik kategori dan subkategori tertentu.

    aws amscm list-change-type-items --category CATEGORY --subcategory SUBCATEGORY

  2. Berikut adalah beberapa contoh pencarian jenis perubahan dengan kueri CLI:

    Perintah berikut mencari ringkasan klasifikasi CT untuk yang berisi “S3" di Nama item dan membuat output dari kategori, subkategori, item, operasi, dan mengubah ID tipe dalam bentuk tabel. 

    aws amscm list-change-type-classification-summaries --query "ChangeTypeClassificationSummaries [?contains(Item, 'S3')].[Category,Subcategory,Item,Operation,ChangeTypeId]" --output table
    +---------------------------------------------------------------+
|               ListChangeTypeClassificationSummaries           |
+----------+-------------------------+--+------+----------------+
|Deployment|Advanced Stack Components|S3|Create|ct-1a68ck03fn98r|
+----------+-------------------------+--+------+----------------+

  3. Anda kemudian dapat menggunakan ID tipe perubahan untuk mendapatkan skema CT dan memeriksa parameternya. Perintah berikut output skema ke file JSON bernama creates3params.schema.json.

    aws amscm get-change-type-version --change-type-id "ct-1a68ck03fn98r" --query "ChangeTypeVersion.ExecutionInputSchema" --output text > CreateS3Params.schema.json

    Untuk informasi tentang penggunaan kueri CLI, lihat Cara Memfilter Output dengan Opsi --query dan referensi bahasa kueri, Spesifikasi. JMESPath

  4. Setelah Anda memiliki ID tipe perubahan, kami sarankan untuk memverifikasi versi untuk jenis perubahan untuk memastikan itu adalah versi terbaru. Gunakan perintah ini untuk menemukan versi untuk jenis perubahan tertentu:

    aws amscm list-change-type-version-summaries --filter Attribute=ChangeTypeId,Value=CHANGE_TYPE_ID

    Untuk menemukan tipe perubahan tertentu, jalankan perintah ini: AutomationStatus

    aws amscm --profile saml get-change-type-version --change-type-id CHANGE_TYPE_ID --query "ChangeTypeVersion.{AutomationStatus:AutomationStatus.Name}"

    Untuk menemukan tipe perubahan tertentu, jalankan perintah ini: ExpectedExecutionDurationInMinutes

    aws amscm --profile saml get-change-type-version --change-type-id ct-14027q0sjyt1h --query "ChangeTypeVersion.{ExpectedDuration:ExpectedExecutionDurationInMinutes}"

Setelah Anda menemukan CT yang menurut Anda sesuai, lihat parameter eksekusi skema JSON yang terkait dengannya untuk mengetahui apakah itu membahas kasus penggunaan Anda.

Gunakan perintah ini untuk menampilkan skema CT ke file JSON yang dinamai CT; contoh ini mengeluarkan skema penyimpanan Create S3:

aws amscm get-change-type-version --change-type-id "ct-1a68ck03fn98r" --query "ChangeTypeVersion.ExecutionInputSchema" --output text > CreateBucketParams.json

Mari kita lihat lebih dekat apa yang ditawarkan skema ini.

Skema Buat Bucket S3 
{	
  "$schema": "http://json-schema.org/draft-04/schema#",
"name": "Create S3 Storage  
"description": "Use to create an Amazon Simple Storage Service stack.",
  "type": "object",
  "properties": {
    "Description": {
      "description": "The description of the stack.",
      "type": "string",
      "minLength": 1,
      "maxLength": 500
    },
    "VpcId": {
      "description": "ID of the VPC to create the S3 Bucket in, in the form vpc-a1b2c3d4e5f67890e.",
      "type": "string",
      "pattern": "^vpc-[a-z0-9]{17}$"
    },
    "StackTemplateId": {
      "description": "Required value: stm-s2b72beb000000000.",
      "type": "string",
      "enum": ["stm-s2b72beb000000000"]
    },
    "Name":{
      "description": "The name of the stack to create.",
      "type": "string",
      "minLength": 1,
      "maxLength": 255
    },
    "Tags": {
      "description": "Up to seven tags (key/value pairs) for the stack.",
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "Key": {
            "type": "string",
            "minLength": 1,
            "maxLength": 127
          },
          "Value": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255
          }
        },
        "additionalProperties": false,
        "required": [
          "Key",
          "Value"
        ]
      },
      "minItems": 1,
      "maxItems": 7
    },
    "TimeoutInMinutes": {
      "description": "The amount of time, in minutes, to allow for creation of the stack.",
      "type": "number",
      "minimum": 0,
      "maximum": 60
    },
    "Parameters": {
      "description": "Specifications for the stack.",
      "type": "object",
      "properties": {
        "AccessControl": {
          "description": "The canned (predefined) access control list (ACL) to assign to the bucket.",
          "type": "string",
          "enum": [
            "Private",
            "PublicRead",
            "AuthenticatedRead",
            "BucketOwnerRead"
          ]
        },
        "BucketName": {
          "description": "A name for the bucket. The bucket name must contain only lowercase letters, numbers, periods (.), and hyphens (-).",
          "type": "string",
          "pattern": "^[a-z0-9]([-.a-z0-9]+)[a-z0-9]$",
          "minLength": 3,
          "maxLength": 63
        }
      },
      "additionalProperties": false,
      "required": [
        "AccessControl",
        "BucketName"
      ]
    }
  },
  "additionalProperties": false,
  "required": [
    "Description",
    "VpcId",
    "StackTemplateId",
    "Name",
    "TimeoutInMinutes",
    "Parameters"
  ]
}

Skema dimulai dengan CT (“deskripsi”), yang memberi tahu Anda untuk apa skema itu. Dalam hal ini, untuk membuat tumpukan penyimpanan S3.

Selanjutnya, Anda memiliki properti wajib dan opsional yang dapat Anda tentukan. Nilai properti default diberikan. Properti yang diperlukan tercantum di akhir skema.

Di StackTemplateId area tersebut, Anda melihat bahwa ada satu template tumpukan khusus untuk CT dan skema ini, dan ID-nya adalah nilai properti wajib.

Skema ini memungkinkan Anda untuk menandai tumpukan yang Anda buat, untuk tujuan pembukuan internal. Selain itu, beberapa opsi, seperti cadangan, memerlukan tag key:Backup dan Value:True. Untuk informasi mendalam, baca Menandai Sumber Daya Amazon EC2 Anda.

Bagian Parameter dari skema CT JSON adalah tempat Anda memberikan parameter eksekusi.

Untuk skema ini, hanya ACL dan parameter eksekusi BucketName yang diperlukan.

Minta CT baru

Setelah memeriksa skema, Anda dapat memutuskan bahwa itu tidak menyediakan parameter yang cukup untuk membuat penerapan yang Anda inginkan. Jika itu masalahnya, periksa CloudFormation templat yang ada untuk menemukan templat yang lebih dekat dengan yang Anda inginkan. Setelah Anda tahu parameter tambahan apa yang Anda butuhkan, kirimkan Manajemen | Lainnya | Lainnya | Buat CT.

catatan

Semua Lainnya | Buat dan Pembaruan Lainnya CTs menerima perhatian dari operator AMS, yang akan menghubungi Anda untuk mendiskusikan CT baru.

Untuk mengirimkan permintaan CT baru, akses konsol AMS melalui reguler Konsol Manajemen AWSdan kemudian ikuti langkah-langkah ini.

  1. Dari navigasi kiri, klik RFCs.

    Halaman RFCs dasbor terbuka.

  2. Klik Buat.

    Halaman Buat permintaan untuk perubahan terbuka.

  3. Pilih Manajemen di Kategori daftar drop-down, dan Lainnya untuk Subkategori dan Item. Untuk Operasi, pilih Buat. RFC akan membutuhkan persetujuan sebelum dapat diimplementasikan.

  4. Masukkan informasi mengapa Anda menginginkan CT, misalnya: Meminta CT penyimpanan Create S3 yang dimodifikasi yang memungkinkan kustom ACLs, berdasarkan CT penyimpanan Create S3 yang ada. Ini akan menghasilkan CT baru: Deployment | Komponen Tumpukan Tingkat Lanjut | Penyimpanan S3 | Buat ACL kustom S3. CT baru ini bisa bersifat publik.

  5. Klik Kirim.

    RFC Anda ditampilkan di dasbor RFC.

Uji CT baru

Setelah AWS Managed Services membuat CT baru itu, Anda mengujinya dengan mengirimkan RFC dengannya. Jika Anda bekerja dengan AMS untuk membuat CT baru telah disetujui sebelumnya, maka Anda cukup mengikuti pengiriman RFC standar, dan perhatikan hasilnya (untuk detail tentang pengiriman RFCs, lihat Membuat dan Mengirimkan RFC). Jika CT baru tidak disetujui sebelumnya (Anda ingin memastikan bahwa CT tidak pernah dijalankan tanpa persetujuan eksplisit), maka Anda perlu mendiskusikan implementasinya dengan AMS setiap kali Anda ingin menjalankannya.