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

EventBridge Integrasi Amazon dalam Pembuat Gambar

Amazon EventBridge adalah layanan bus acara tanpa server yang dapat Anda gunakan untuk menghubungkan aplikasi Image Builder Anda dengan data terkait dari yang lain Layanan AWS. Di EventBridge, aturan mencocokkan peristiwa yang masuk dan mengirimkannya ke target untuk diproses. Satu aturan dapat mengirim peristiwa ke beberapa target, dan peristiwa ini kemudian berjalan secara paralel.

Dengan EventBridge, Anda dapat mengotomatiskan Layanan AWS dan merespons secara otomatis peristiwa sistem seperti masalah ketersediaan aplikasi atau perubahan sumber daya. Layanan AWS mengirimkan acara EventBridge dalam waktu hampir real time. Anda dapat mengatur aturan yang bereaksi terhadap peristiwa yang masuk untuk memulai tindakan. Misalnya, mengirim peristiwa ke fungsi Lambda ketika status instance EC2 berubah dari tertunda menjadi berjalan. EventBridge memanggil pola peristiwa definisi yang cocok ini. Untuk membuat aturan berdasarkan pola peristiwa, lihat Membuat EventBridge aturan Amazon yang bereaksi terhadap peristiwa di Panduan EventBridge Pengguna Amazon.

Image Builder bekerja dengan EventBridge dalam dua arah independen. Pilih salah satu yang sesuai dengan tujuan Anda:

Untuk prosedur langkah demi langkah untuk kedua arah, lihatGunakan EventBridge dengan pipeline Image Builder. Untuk katalog acara, lihatPesan acara yang dikirim Image Builder.

Tindakan yang dapat dimulai secara otomatis meliputi:

Anda juga dapat mengatur aturan penjadwalan untuk bus peristiwa default untuk melakukan tindakan secara berkala, seperti menjalankan pipeline Image Builder untuk menyegarkan gambar setiap tiga bulan. Ada dua jenis ekspresi jadwal:

Untuk informasi selengkapnya tentang bagaimana EventBridge aturan berintegrasi dengan pipeline gambar Pembuat Gambar, lihatGunakan EventBridge dengan pipeline Image Builder.

Pesan acara yang dikirim Image Builder

Image Builder mengirimkan peristiwa ke bus EventBridge peristiwa default ketika sumber daya Pembuat Gambar mencapai titik penting dalam siklus hidupnya — misalnya, ketika gambar berubah status, pemindaian selesai, langkah alur kerja berhenti untuk input, atau pipeline dinonaktifkan secara otomatis. Setiap peristiwa menggunakan sumbernyaaws.imagebuilder.

Bagian berikut menjelaskan setiap peristiwa: ketika Image Builder mengirimkannya, bidang dalam acaradetail, dan ARN sumber daya dalam resources array. Untuk bertindak atas peristiwa ini, lihatBereaksi terhadap peristiwa yang dikirim Image Builder. ID akun, Wilayah, ARN, dan stempel waktu dalam contoh adalah placeholder—ganti dengan milik Anda sendiri.

Perubahan Status Gambar Pembuat Gambar EC2

Image Builder mengirimkan peristiwa ini ketika status berubah untuk sumber daya gambar selama pembuatan gambar. Misalnya, ketika status gambar berubah dari satu keadaan ke status lainnya, sebagai berikut:

{
    "version": "0",
    "id": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
    "detail-type": "EC2 Image Builder Image State Change",
    "source": "aws.imagebuilder",
    "account": "111122223333",
    "time": "2024-01-18T17:50:56Z",
    "region": "us-west-2",
    "resources": ["arn:aws:imagebuilder:us-west-2:111122223333:image/cmkencryptedworkflowtest-a1b2c3d4-5678-90ab-cdef-EXAMPLE22222/1.0.0/1"],
    "detail": {
        "previous-state": {
            "status": "TESTING"
        },
        "state": {
            "status": "AVAILABLE"
        }
    }
}

Image Builder mengirimkan peristiwa ini setiap kali sumber daya gambar berubah status selama pembuatan gambar, melintasi transisi build yang ditunjukkan di atas.

Acara ini detail berisi bidang-bidang berikut:

Nilai status transisi build adalahBUILDING,,,TESTING,DISTRIBUTING, INTEGRATING AVAILABLECANCELLED, dan. FAILED

Ar resources ray berisi ARN dari sumber daya gambar yang mengubah status.

EC2 Image Builder CVE Terdeteksi

Jika deteksi CVE diaktifkan untuk gambar Anda, Pembuat Gambar mengirimkan pesan dengan hasilnya setiap kali pemindaian gambar selesai.

{
    "version": "0",
    "id": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
    "detail-type": "EC2 Image Builder CVE Detected",
    "source": "aws.imagebuilder",
    "account": "111122223333",
    "time": "2023-03-01T16:59:09Z",
    "region": "us-east-1",
    "resources": [
        "arn:aws:imagebuilder:us-east-1:111122223333:image/test-image/1.0.0/1",
        "arn:aws:imagebuilder:us-east-1:111122223333:image-pipeline/test-pipeline"
    ],
    "detail": {
        "resource-id": "i-1234567890abcdef0",
        "finding-severity-counts": {
            "all": 0,
            "critical": 0,
            "high": 0,
            "medium": 0
        }
    }
}

Image Builder mengirimkan acara ini ketika pemindaian gambar selesai, dan hanya ketika Anda mengaktifkan pemindaian gambar (Amazon Inspector) untuk gambar. Jika pemindaian tidak aktif, Pembuat Gambar tidak mengirim acara ini. Untuk mengaktifkan pemindaian, lihatKonfigurasikan pemindaian keamanan untuk gambar Image Builder di Konsol Manajemen AWS.

Acara ini detail berisi bidang-bidang berikut:

resourcesArray berisi ARN sumber daya gambar, dan ARN dari pipeline gambar ketika pemindaian berjalan dari pipa.

Langkah Alur Kerja Pembuat Gambar EC2 Menunggu

Image Builder mengirimkan pesan ketika langkah WaitForAction alur kerja berhenti untuk menunggu tindakan asinkron selesai.

{
    "version": "0",
    "id": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
    "detail-type": "EC2 Image Builder Workflow Step Waiting",
    "source": "aws.imagebuilder",
    "account": "111122223333",
    "time": "2024-01-18T16:54:44Z",
    "region": "us-west-2",
    "resources": ["arn:aws:imagebuilder:us-west-2:111122223333:image/workflowstepwaitforactionwithvalidsnstopictest-a1b2c3d4-5678-90ab-cdef-EXAMPLE22222/1.0.0/1", "arn:aws:imagebuilder:us-west-2:111122223333:workflow/build/build-workflow-a1b2c3d4-5678-90ab-cdef-EXAMPLE33333/1.0.0/1"],
    "detail": {
        "workflow-execution-id": "wf-a1b2c3d4-5678-90ab-cdef-EXAMPLE22222",
        "workflow-step-execution-id": "step-a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
        "workflow-step-name": "TestAutoSNSStop"
    }
}

Image Builder mengirimkan acara ini ketika langkah WaitForAction alur kerja berhenti untuk menunggu tanggapan Anda. Alur kerja tetap dijeda sampai Anda merespons atau waktu langkah habis.

Acara ini detail berisi bidang-bidang berikut:

resourcesArray berisi ARN sumber daya gambar dan ARN alur kerja.

Untuk merespons, SendWorkflowStepAction panggil dengan workflow-step-execution-id from the event dan an action of RESUME untuk melanjutkan, atau STOP untuk mengakhiri build. Lihat WaitForAction. Untuk mendorong ini dari acara secara otomatis, lihatBereaksi terhadap peristiwa yang dikirim Image Builder.

Pipeline Gambar EC2 Image Builder Dinonaktifkan Secara Otomatis

Jika Anda telah mengonfigurasi autoDisablePolicy untuk pipeline Anda, maka Image Builder menonaktifkan pipeline dan mengirimkan pesan peristiwa EventBridge ketika jumlah kegagalan eksekusi pipeline terjadwal berturut-turut melebihi jumlah maksimum yang diizinkan menurut kebijakan.

{
    "version": "0",
    "id": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
    "detail-type": "EC2 Image Builder Image Pipeline Automatically Disabled",
    "source": "aws.imagebuilder",
    "account": "111122223333",
    "time": "2025-09-18T16:54:44Z",
    "region": "us-west-2",
    "resources": ["arn:aws:imagebuilder:us-west-2:111122223333:image-pipeline/disabled-image-pipeline-name"],
    "detail": {
        "consecutive-failures": "5"
    }
}

Jika Anda mengonfigurasi autoDisablePolicy jadwal pipeline, Image Builder menghitung kegagalan berturut-turut dari build terjadwal. Saat jumlah mencapai kebijakanfailureCount, Image Builder menonaktifkan pipeline dan mengirimkan acara ini.

Acara ini detail berisi bidang-bidang berikut:

Ar resources ray berisi ARN dari pipeline yang dinonaktifkan.