Dapatkan notifikasi deployment - AWS IoT Greengrass
Peristiwa perubahan status deployment grupPrasyarat untuk membuat EventBridge aturanKonfigurasikan pemberitahuan deployment (konsol)Konfigurasikan pemberitahuan deployment (CLI)Konfigurasikan pemberitahuan deployment (AWS CloudFormation)Lihat juga

AWS IoT Greengrass Version 1 memasuki fase umur panjang pada 30 Juni 2023. Untuk informasi selengkapnya, lihat kebijakan AWS IoT Greengrass V1 pemeliharaan. Setelah tanggal ini, tidak AWS IoT Greengrass V1 akan merilis pembaruan yang menyediakan fitur, penyempurnaan, perbaikan bug, atau patch keamanan. Perangkat yang berjalan AWS IoT Greengrass V1 tidak akan terganggu dan akan terus beroperasi dan terhubung ke cloud. Kami sangat menyarankan Anda bermigrasi ke AWS IoT Greengrass Version 2, yang menambahkan fitur baru yang signifikan dan dukungan untuk platform tambahan.

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

Dapatkan notifikasi deployment

Amazon EventBridge aturan peristiwa menyediakan Anda pemberitahuan tentang perubahan keadaan untuk deployment grup Greengrass Anda. EventBridge menyampaikan pengaliran acara sistem mendekati waktu nyata yang menjelaskan perubahanAWSsumber daya.AWS IoT Greengrassmengirimkan acara ini ke EventBridge padasetidaknya sekalidasar. Ini berarti bahwa AWS IoT Greengrass mungkin mengirim beberapa salinan dari peristiwa tertentu untuk memastikan pengiriman. Selain itu, pendengar peristiwa Anda mungkin tidak menerima peristiwa dalam urutan peristiwa yang terjadi.

catatan

Amazon EventBridge adalah layanan bus peristiwa yang dapat Anda gunakan untuk menghubungkan aplikasi Anda dengan data dari berbagai sumber, sepertiPerangkat inti Greengrassdan notifikasi deployment. Untuk informasi selengkapnya, lihatApa itu Amazon EventBridge?di dalamAmazon EventBridge Panduan Pengguna.

AWS IoT Greengrass mengeluarkan peristiwa ketika deployment grup mengubah keadaan. Anda dapat membuat EventBridge aturan yang berjalan untuk semua transisi keadaan atau transisi ke keadaan yang Anda tentukan. Ketika deployment memasuki keadaan yang memulai aturan, EventBridge memanggil tindakan target yang didefinisikan di dalam aturan. Hal ini mengizinkan Anda untuk mengirim pemberitahuan, menangkap informasi peristiwa, mengambil tindakan korektif, atau menginisiasi peristiwa lain untuk merespon perubahan keadaan. Sebagai contoh, Anda dapat membuat aturan untuk kasus penggunaan berikut:

  • Memulai operasi pasca deployment, seperti mengunduh aset dan memberi tahu personil.

  • Kirim pemberitahuan setelah deployment berhasil atau gagal.

  • Terbitkankan metrik kustom tentang peristiwa deployment.

AWS IoT Greengrass mengeluarkan peristiwa ketika deployment memasuki keadaan berikut: Building, InProgress, Success, dan Failure.

catatan

Memantau status deployment massal saat ini tidak didukung. Namun, AWS IoT Greengrass mengeluarkan peristiwa perubahan keadaan untuk deployment grup individu yang merupakan bagian dari deployment massal.

Peristiwa perubahan status deployment grup

peristiwa untuk perubahan keadaan deployment menggunakan format berikut:

{
    "version":"0",
    "id":" cd4d811e-ab12-322b-8255-EXAMPLEb1bc8",
    "detail-type":"Greengrass Deployment Status Change",
    "source":"aws.greengrass",
    "account":"123456789012",
    "time":"2018-03-22T00:38:11Z",
    "region":"us-west-2",
    "resources":[],
    "detail":{    
        "group-id": "284dcd4e-24bc-4c8c-a770-EXAMPLEf03b8",
        "deployment-id": "4f38f1a7-3dd0-42a1-af48-EXAMPLE09681",
        "deployment-type": "NewDeployment|Redeployment|ResetDeployment|ForceResetDeployment",
        "status": "Building|InProgress|Success|Failure"
    }
}

Anda dapat membuat aturan yang berlaku untuk satu atau lebih grup. Anda dapat memfilter aturan berdasarkan satu atau beberapa jenis deployment berikut dan keadaan deployment:

Jenis deployment

  • NewDeployment. Deployment pertama dari versi grup.

  • ReDeployment. Sebuah deployment ulang versi grup.

  • ResetDeployment. Menghapus informasi deployment yang disimpan di AWS Cloud dan pada AWS IoT Greengrass core. Untuk informasi selengkapnya, lihat Atur ulang deployment.

  • ForceResetDeployment. Menghapus informasi deployment yang disimpan di AWS Cloud dan melaporkan keberhasilan tanpa menunggu core untuk merespon. Juga menghapus informasi deployment yang disimpan pada core jika core terhubung atau ketika terhubung selanjutnya.

Keadaan deployment

  • Building. AWS IoT Greengrass memvalidasi konfigurasi grup dan membangun artefak deployment.

  • InProgress. Deployment sedang berlangsung pada AWS IoT Greengrass core.

  • Success. Deployment berhasil.

  • Failure. Deployment gagal.

Ada kemungkinan bahwa peristiwa dapat diduplikasi atau rusak. Untuk menentukan urutan peristiwa, gunakan properti time ini.

catatan

AWS IoT Greengrass tidak menggunakan resources properti, sehingga selalu kosong.

Prasyarat untuk membuat EventBridge aturan

Sebelum Anda membuat EventBridge aturanAWS IoT Greengrass, lakukan hal berikut:

  • Biasakan diri Anda dengan peristiwa, aturan, dan target EventBridge.

  • Buat dan konfigurasi target yang dipanggil EventBridge aturan. Aturan dapat memanggil berbagai jenis target, termasuk:

    • Amazon Simple Notification Service (Amazon SNS)

    • AWS Lambda fungsi

    • Amazon Kinesis Video Streams

    • Antrean Amazon Simple Queue Service (Amazon SQS)

Untuk informasi selengkapnya, lihatApa itu Amazon EventBridge?danMemulai dengan Amazon EventBridgedi dalamAmazon EventBridge Panduan Pengguna.

Konfigurasikan pemberitahuan deployment (konsol)

Lakukan langkah-langkah berikut untuk membuat EventBridge aturan yang menerbitkan topik Amazon SNS ketika status deployment berubah untuk grup. Hal ini memungkinkan server web, alamat email, dan pelanggan topik lainnya untuk menanggapi peristiwa tersebut. Untuk informasi selengkapnya, lihatMembuat EventBridge aturan yang memicu peristiwaAWSsumber dayadi dalamAmazon EventBridge Panduan Pengguna.

  1. BukaAmazon EventBridgekonsol.

  2. Di panel navigasi, pilih Aturan.

  3. Pilih Buat aturan.

  4. Masukkan nama dan deskripsi untuk aturan.

    Aturan tidak boleh memiliki nama yang sama dengan aturan lain di Wilayah yang sama dan di bus kejadian yang sama.

  5. UntukBus peristiwa, pilih bus peristiwa yang ingin Anda kaitkan dengan aturan ini. Jika Anda ingin aturan ini cocok dengan peristiwa yang berasal dari akun Anda, pilihAWSbus kejadian default. Saat layanan AWS di akun Anda menghasilkan peristiwa, layanan tersebut akan selalu masuk ke bus peristiwa default akun Anda.

  6. UntukJenis aturan, pilihAturan dengan pola peristiwa.

  7. Pilih Selanjutnya.

  8. UntukSumber peristiwa, pilihAWSjasa.

  9. UntukPola peristiwa, pilihAWSjasa.

  10. UntukAWSlayanan, pilih Greengrass.

  11. Untuk Tipe peristiwa, pilih Perubahan Status Deployment Greengrass.

    catatan

    ParameterAWSPanggilan API CloudTrailjenis acara didasarkan padaAWS IoT Greengrassintegrasi denganAWS CloudTrail. Anda dapat menggunakan opsi ini untuk membuat aturan yang diinisiasi dengan membaca atau menulis panggilan ke AWS IoT Greengrass API. Untuk informasi selengkapnya, lihat Mencatat log panggilan API AWS IoT Greengrass dengan AWS CloudTrail.

  12. Pilih keadaan deployment yang menginisiasi pemberitahuan.

    • Untuk menerima pemberitahuan untuk semua peristiwa perubahan keadaan, pilih Keadaan apa pun.

    • Untuk menerima notifikasi untuk beberapa peristiwa perubahan keadaan saja, pilih Keadaan tertentu, lalu pilih keadaan target.

  13. Pilih tipe deployment yang menginisiasi pemberitahuan.

    • Untuk menerima pemberitahuan untuk semua tipe deployment, pilih Keadaan apa pun.

    • Untuk menerima notifikasi untuk beberapa tipe deployment saja, pilih Keadaan tertentu, lalu pilih tipe deployment target.

  14. Pilih Selanjutnya.

  15. UntukJenis target, pilihAWSlayanan.

  16. UntukPilih target, konfigurasikan target Anda. Contoh ini menggunakan topik Amazon SNS, tetapi Anda dapat mengonfigurasi tipe target lain untuk mengirim pemberitahuan.

    1. Untuk Target, pilih topik SNS.

    2. Untuk Topik, pilih topik target Anda.

    3. Pilih Selanjutnya.

  17. Di bawahTanda, tentukan tag untuk aturan tersebut atau biarkan kolom tersebut kosong.

  18. Pilih Selanjutnya.

  19. Tinjau detail aturan dan pilihBuat aturan.

Konfigurasikan pemberitahuan deployment (CLI)

Lakukan langkah-langkah berikut untuk membuat EventBridge aturan yang menerbitkan topik Amazon SNS ketika status deployment berubah untuk grup. Hal ini mengizinkan server web, alamat email, dan pelanggan topik lainnya untuk merespon peristiwa tersebut.

  1. Buat aturan .

    • Ganti id-grup dengan ID AWS IoT Greengrass grup Anda.

    aws events put-rule \
  --name TestRule \
  --event-pattern "{\"source\": [\"aws.greengrass\"], \"detail\": {\"group-id\": [\"group-id\"]}}"

    Properti apa pun yang dihilangkan dari pola akan diabaikan.

  2. Tambahkan topik sebagai target aturan.

    • Ganti topik-arn dengan ARN dari topik Amazon SNS Anda.

    aws events put-targets \
  --rule TestRule \
  --targets "Id"="1","Arn"="topic-arn"
    catatan

    Untuk mengizinkan Amazon EventBridge untuk memanggil topik target Anda, Anda harus menambahkan kebijakan berbasis sumber daya pada topik Anda. Untuk informasi selengkapnya, lihatIzin Amazon SNSdi dalamAmazon EventBridge Panduan Pengguna.

Untuk informasi selengkapnya, lihatPola peristiwa dan pola EventBridgedi dalamAmazon EventBridge Panduan Pengguna.

Konfigurasikan pemberitahuan deployment (AWS CloudFormation)

GunakanAWS CloudFormationtemplat untuk membuat EventBridge aturan yang mengirim pemberitahuan tentang perubahan keadaan untuk deployment grup Greengrass Anda. Untuk informasi selengkapnya, lihatAmazon EventBridge referensi tipe sumber dayadi dalamAWS CloudFormationPanduan Pengguna.

Lihat juga