Buat logika penyediaan khusus dengan sumber daya khusus

Penyedia sumber daya kustom menulis logika yang menentukan cara menangani permintaan dari CloudFormation dan melakukan tindakan pada sumber daya kustom.

Penyedia sumber daya khusus membuat SNS topik Amazon atau fungsi Lambda tempat CloudFormation dapat mengirim permintaan. SNSTopik Amazon atau fungsi Lambda harus berada di Wilayah yang sama tempat tumpukan akan dibuat.

Penyedia sumber daya khusus memberikan SNS topik Amazon ARN atau fungsi Lambda ARN ke pengembang template.

Pengembang template mendefinisikan sumber daya kustom dalam CloudFormation template mereka. Ini termasuk token layanan dan parameter data input apa pun. Token layanan dan struktur data input ditentukan oleh penyedia sumber daya khusus. Token layanan menentukan SNS topik Amazon ARN atau ARN fungsi Lambda dan selalu diperlukan, tetapi data input bersifat opsional tergantung pada sumber daya khusus.

CloudFormation mengirimkan permintaan ke token layanan yang ditentukan. Permintaan tersebut mencakup informasi seperti jenis permintaan dan Layanan Penyimpanan Simple Amazon yang telah ditandatangani sebelumnyaURL, tempat sumber daya kustom mengirimkan tanggapan. Untuk informasi selengkapnya tentang apa saja yang disertakan dalam permintaan, lihat Objek permintaan sumber daya kustom.

Data sampel berikut menunjukkan apa yang CloudFormation termasuk dalam Create permintaan. Dalam contoh ini, ResourceProperties memungkinkan CloudFormation untuk membuat payload khusus untuk dikirim ke fungsi Lambda.

{
   "RequestType" : "Create",
   "ResponseURL" : "http://pre-signed-S3-url-for-response",
   "StackId" : "arn:aws:cloudformation:us-west-2:123456789012:stack/mystack/5b918d10-cd98-11ea-90d5-0a9cd3354c10",
   "RequestId" : "unique id for this create request",
   "ResourceType" : "Custom::TestResource",
   "LogicalResourceId" : "MyTestResource",
   "ResourceProperties" : {
      "Name" : "Value",
      "List" : [ "1", "2", "3" ]
   }
}

Penyedia sumber daya kustom memproses CloudFormation permintaan dan mengembalikan respons SUCCESS atau FAILED ke pra-ditandatanganiURL. Penyedia sumber daya khusus memberikan respons dalam file yang JSON diformat -dan mengunggahnya ke S3 yang telah ditandatangani sebelumnya. URL Untuk informasi selengkapnya, lihat Mengunggah objek menggunakan pra-tanda tangan URLs di Panduan Pengguna Layanan Penyimpanan Sederhana Amazon.

Sebagai tanggapan, penyedia sumber daya kustom juga dapat menyertakan pasangan nama-nilai yang dapat diakses oleh pengembang template. Misalnya, respons dapat menyertakan data output jika permintaan berhasil atau pesan kesalahan jika permintaan gagal. Untuk informasi selengkapnya tentang respons, lihat Objek tanggapan sumber daya khusus.

Penyedia sumber daya khusus bertanggung jawab untuk mendengarkan dan menanggapi permintaan. Misalnya, untuk SNS pemberitahuan Amazon, penyedia sumber daya khusus harus mendengarkan dan menanggapi pemberitahuan yang dikirim ke topik tertentuARN. CloudFormation menunggu dan mendengarkan tanggapan di lokasi yang telah ditandatangani sebelumnyaURL.

Data contoh berikut menunjukkan apa yang mungkin disertakan oleh sumber daya kustom dalam respons:

{
   "Status" : "SUCCESS",
   "PhysicalResourceId" : "TestResource1",
   "StackId" : "arn:aws:cloudformation:us-west-2:123456789012:stack/mystack/5b918d10-cd98-11ea-90d5-0a9cd3354c10",
   "RequestId" : "unique id for this create request",
   "LogicalResourceId" : "MyTestResource",
   "Data" : {
      "OutputName1" : "Value1",
      "OutputName2" : "Value2",
   }
}

Setelah mendapat SUCCESS respons, CloudFormation lanjutkan dengan operasi tumpukan. Jika respons FAILED atau tidak ada respons dikembalikan, operasi gagal. Setiap data keluaran dari sumber daya kustom disimpan di URL lokasi yang telah ditandatangani sebelumnya. Pengembang template dapat mengambil data tersebut dengan menggunakan Fn::GetAttfungsi.