Aktifkan Guard Hook di akun Anda

Masuk ke Konsol Manajemen AWS dan buka CloudFormation konsol di https://console.aws.amazon.com/cloudformation.

Pada bilah navigasi di bagian atas layar, pilih Wilayah AWS tempat Anda ingin membuat Hook.

Di panel navigasi di sebelah kiri, pilih Hooks.

Pada halaman Hooks, pilih Create a Hook, lalu pilih With Guard.

Jika Anda belum membuat aturan Guard, buat aturan Guard Anda, simpan di Amazon S3, lalu kembali ke prosedur ini. Lihat contoh aturan di Tulis aturan Guard untuk mengevaluasi sumber daya untuk Guard Hooks untuk memulai.

Jika Anda telah membuat aturan Guard dan menyimpannya di S3, lanjutkan ke langkah berikutnya.

Untuk sumber Guard Hook, S impan aturan Guard Anda di S3, lakukan hal berikut:

(Opsional) Untuk bucket S3 untuk laporan keluaran Guard, tentukan bucket S3 untuk menyimpan laporan keluaran Guard. Laporan ini berisi hasil validasi aturan Penjaga Anda.

Untuk mengonfigurasi tujuan laporan keluaran, pilih salah satu opsi berikut:

(Opsional) Perluas parameter input aturan Guard, lalu berikan informasi berikut di bawah S impan parameter input aturan Guard Anda di S3:

Pilih Berikutnya.

Untuk nama Hook, pilih salah satu opsi berikut:

Untuk target Hook, pilih apa yang akan dievaluasi:

Untuk T indakan, pilih tindakan mana (buat, perbarui, hapus) yang akan memanggil Hook Anda.

Untuk mode Hook, pilih bagaimana Hook merespons ketika aturan gagal evaluasi mereka:

Untuk peran Eksekusi, pilih peran IAM yang diasumsikan oleh Hook untuk mengambil aturan Guard Anda dari S3 dan secara opsional menulis laporan keluaran Guard terperinci kembali. Anda dapat mengizinkan CloudFormation untuk secara otomatis membuat peran eksekusi untuk Anda atau Anda dapat menentukan peran yang telah Anda buat.

Pilih Berikutnya.

(Opsional) Untuk filter Hook, lakukan hal berikut:

1. Untuk filter sumber daya, tentukan jenis sumber daya mana yang dapat memanggil Hook. Ini memastikan bahwa Hook hanya dipanggil untuk sumber daya yang relevan.

2. Untuk kriteria Penyaringan, pilih logika untuk menerapkan nama tumpukan dan filter peran tumpukan:

   • Semua nama tumpukan dan peran tumpukan — Hook hanya akan dipanggil ketika semua filter yang ditentukan cocok.

   • Setiap nama tumpukan dan peran tumpukan — Hook akan dipanggil jika setidaknya satu dari filter yang ditentukan cocok.

   catatan

   Untuk operasi Cloud Control API, semua nama St ack dan filter peran Stack diabaikan.

3. Untuk nama Stack, sertakan atau kecualikan tumpukan tertentu dari pemanggilan Hook.

   • Untuk Ser takan, tentukan nama tumpukan yang akan disertakan. Gunakan ini ketika Anda memiliki satu set kecil tumpukan tertentu yang ingin Anda targetkan. Hanya tumpukan yang ditentukan dalam daftar ini yang akan memanggil Hook.

   • Untuk K ecualikan, tentukan nama tumpukan yang akan dikecualikan. Gunakan ini saat Anda ingin memanggil Hook pada sebagian besar tumpukan tetapi mengecualikan beberapa yang spesifik. Semua tumpukan kecuali yang tercantum di sini akan memanggil Hook.

4. Untuk peran Stack, sertakan atau kecualikan tumpukan tertentu dari pemanggilan Hook berdasarkan peran IAM terkait.

   • Untuk Ser takan, tentukan satu atau beberapa ARN peran IAM untuk menargetkan tumpukan yang terkait dengan peran ini. Hanya operasi tumpukan yang diprakarsai oleh peran ini yang akan memanggil Hook.

   • Untuk K ecualikan, tentukan satu atau beberapa ARN peran IAM untuk tumpukan yang ingin Anda kecualikan. Hook akan dipanggil pada semua tumpukan kecuali yang diprakarsai oleh peran yang ditentukan.

Pilih Berikutnya.

Pada halaman T injau dan aktifkan, tinjau pilihan Anda. Untuk membuat perubahan, pilih Edit pada bagian terkait.

Ketika Anda siap untuk melanjutkan, pilih Aktifkan Hook.

Untuk mulai mengaktifkan Hook, gunakan activate-type perintah berikut, ganti placeholder dengan nilai spesifik Anda. Perintah ini mengotorisasi Hook untuk menggunakan peran eksekusi tertentu dari Anda Akun AWS.

aws cloudformation activate-type --type HOOK \
  --type-name AWS::Hooks::GuardHook \
  --publisher-id aws-hooks \
  --type-name-alias Private::Guard::MyTestHook \
  --execution-role-arn arn:aws:iam::123456789012:role/my-execution-role \
  --region us-west-2

Untuk menyelesaikan pengaktifan Hook, Anda harus mengonfigurasinya menggunakan file konfigurasi JSON.

Gunakan cat perintah untuk membuat file JSON dengan struktur berikut. Untuk informasi selengkapnya, lihat Referensi sintaks skema konfigurasi hook.

$ cat > config.json
{
  "CloudFormationConfiguration": {
    "HookConfiguration": {
      "HookInvocationStatus": "ENABLED",
      "TargetOperations": [
        "STACK",
        "RESOURCE",
        "CHANGE_SET"
      ],
      "FailureMode": "WARN",
      "Properties": {
        "ruleLocation": "s3://amzn-s3-demo-bucket/MyGuardRules.guard",
        "logBucket": "amzn-s3-demo-logging-bucket",
        "options": {
          "inputParams": "s3://amzn-s3-demo-bucket/MyInputParams.json"
        }
      },
      "TargetFilters": {
        "Actions": [
          "CREATE",
          "UPDATE",
          "DELETE"
        ]
      }
    }
  }
}

Gunakan set-type-configuration perintah berikut, bersama dengan file JSON yang Anda buat, untuk menerapkan konfigurasi. Ganti placeholder dengan nilai spesifik Anda.

aws cloudformation set-type-configuration \
  --configuration file://config.json \
  --type-arn "arn:aws:cloudformation:us-west-2:123456789012:type/hook/MyTestHook" \
  --region us-west-2