Memulai mesin status sebagai respons terhadap peristiwa di Step Functions

Anda dapat menjalankan mesin AWS Step Functions status sebagai respons terhadap EventBridge aturan Amazon.

Tutorial ini menunjukkan cara mengkonfigurasi mesin status sebagai target untuk EventBridge aturan Amazon. Aturan ini akan memulai eksekusi mesin status saat file ditambahkan ke bucket Amazon Simple Storage Service (Amazon S3).

Untuk aplikasi yang praktis, Anda dapat meluncurkan mesin status yang melakukan operasi pada file yang Anda tambahkan ke bucket, seperti membuat thumbnail atau menjalankan analisis Amazon Rekognition pada file citra dan video.

Dalam tutorial ini, Anda memulai eksekusi mesin Helloworld status dengan mengunggah file ke bucket Amazon S3. Kemudian Anda meninjau contoh input eksekusi tersebut untuk mengidentifikasi informasi yang disertakan dalam input dari pemberitahuan peristiwa Amazon S3 yang dikirimkan ke. EventBridge

Prasyarat: Buat Mesin Status

Sebelum Anda dapat mengonfigurasi mesin status sebagai EventBridge target Amazon, Anda harus membuat mesin status.

• Untuk membuat mesin state dasar, gunakan mesin Creating state yang menggunakan tutorial fungsi Lambda.

• Jika Anda sudah memiliki mesin Helloworld negara, lanjutkan ke langkah berikutnya.

Langkah 1: Buat Bucket di Amazon S3

Sekarang setelah Anda memiliki mesin Helloworld negara, Anda perlu membuat bucket Amazon S3 yang menyimpan file Anda. Pada Langkah 3 tutorial ini, Anda menyiapkan aturan sehingga ketika file diunggah ke bucket ini, EventBridge memicu eksekusi mesin status Anda.

1. Arahkan ke konsol Amazon S3, lalu pilih Buat bucket untuk membuat bucket tempat Anda ingin menyimpan file dan memicu aturan acara Amazon S3.

2. Masukkan Nama bucket, seperti username-sfn-tutorial.

   catatan

   Nama bucket harus unik di semua nama bucket yang ada di semua AWS Wilayah di Amazon S3. Gunakan milik Anda sendiri username untuk membuat nama ini unik. Anda perlu membuat semua sumber daya di AWS Wilayah yang sama.

3. Simpan semua pilihan default di halaman, dan pilih Buat ember.

Langkah 2: Aktifkan Pemberitahuan Acara Amazon S3 dengan EventBridge

Setelah Anda membuat bucket Amazon S3, konfigurasikan bucket tersebut untuk mengirim peristiwa ke EventBridge setiap kali peristiwa tertentu terjadi di bucket S3 Anda, seperti unggahan file.

1. Arahkan ke konsol Amazon S3.

2. Di Bucket pilih nama bucket yang ingin Anda aktifkan untuk peristiwa.

3. Pilih Properti.

4. Gulir ke bawah halaman untuk melihat bagian Pemberitahuan Acara, lalu pilih Edit di EventBridge subbagian Amazon.

5. Di bawah Kirim notifikasi ke Amazon EventBridge untuk semua acara di bucket ini, pilih Aktif.

6. Pilih Simpan perubahan.

   catatan

   Setelah Anda mengaktifkan EventBridge, dibutuhkan sekitar lima menit agar perubahan diterapkan.

Langkah 3: Buat EventBridge Aturan Amazon

Setelah Anda memiliki mesin status, dan telah membuat bucket Amazon S3 dan mengonfigurasinya untuk mengirim pemberitahuan acara EventBridge, buat aturan. EventBridge

catatan

Anda harus mengonfigurasi EventBridge aturan di AWS Wilayah yang sama dengan bucket Amazon S3.

Untuk membuat aturan

1. Arahkan ke EventBridge konsol Amazon, pilih Buat aturan.

   Tip

   Atau, di panel navigasi di EventBridge konsol, pilih Aturan di bawah Bus, lalu pilih Buat aturan.

2. Masukkan Nama untuk aturan Anda (misalnya,S3Step Functions) dan secara opsional masukkan Deskripsi untuk aturan tersebut.

3. Untuk bus Acara dan tipe Aturan, pertahankan pilihan default.

4. Pilih Berikutnya. Ini membuka halaman pola acara Build.

5. Gulir ke bawah ke bagian Pola acara, dan lakukan hal berikut:

   1. Untuk sumber Acara, pertahankan pilihan default AWS acara atau acara EventBridge mitra.

   2. Untuk AWS layanan, pilih Simple Storage Service (S3).

   3. Untuk jenis Acara, pilih Pemberitahuan Acara Amazon S3.

   4. Pilih peristiwa tertentu, lalu pilih Object Created.

   5. Pilih Bucket spesifik berdasarkan nama dan masukkan nama bucket yang Anda buat di Langkah 1 (username-sfn-tutorial) untuk menyimpan file Anda.

   6. Pilih Berikutnya. Ini membuka halaman Pilih target.

Untuk membuat target

1. Di Target 1, pertahankan pilihan AWS layanan default.

2. Dalam daftar tarik-turun Pilih target, pilih mesin status Step Functions.

3. Dalam daftar mesin Negara, pilih mesin status yang Anda buat sebelumnya (misalnya,Helloworld).

4. Simpan semua pilihan default di halaman, dan pilih Berikutnya. Ini membuka halaman Konfigurasi tag.

5. Pilih Selanjutnya sekali lagi. Ini membuka halaman Review dan create.

6. Tinjau detail aturan dan pilih Buat aturan.

   Aturan dibuat dan halaman Aturan ditampilkan, mencantumkan semua EventBridge aturan Amazon Anda.

Langkah 4: Uji Aturan

Sekarang semua sudah berada di tempatnya, uji penambahan file ke bucket Amazon S3, lalu lihat input eksekusi mesin status yang dihasilkan.

1. Tambahkan file ke bucket Amazon S3.

   Arahkan ke konsol Amazon S3, pilih bucket yang Anda buat untuk menyimpan file (username-sfn-tutorial), lalu pilih Unggah.

2. Tambahkan file, misalnyatest.png, lalu pilih Unggah.

   Tindakan ini meluncurkan eksekusi mesin status Anda, meneruskan informasi dari AWS CloudTrail sebagai input.

3. Periksa eksekusi untuk mesin status Anda.

   Arahkan ke konsol Step Functions dan pilih mesin status yang digunakan dalam EventBridge aturan Amazon Anda (Helloworld).

4. Pilih eksekusi terbaru dari mesin status itu dan perluas bagian Input Eksekusi.

   Input ini mencakup informasi seperti nama bucket dan nama objek. Dalam kasus penggunaan dunia nyata, mesin status dapat menggunakan input ini untuk melakukan tindakan pada objek tersebut.

Contoh Input Eksekusi

Contoh berikut menunjukkan masukan khas untuk eksekusi mesin negara.

{
    "version": "0",
    "id": "6c540ad4-0671-9974-6511-756fbd7771c3",
    "detail-type": "Object Created",
    "source": "aws.s3",
    "account": "123456789012",
    "time": "2023-06-23T23:45:48Z",
    "region": "us-east-2",
    "resources": [
      "arn:aws:s3:::username-sfn-tutorial"
    ],
    "detail": {
      "version": "0",
      "bucket": {
        "name": "username-sfn-tutorial"
      },
      "object": {
        "key": "test.png",
        "size": 800704,
        "etag": "f31d8546bb67845b4d3048cde533b937",
        "sequencer": "00621049BA9A8C712B"
      },
      "request-id": "79104EXAMPLEB723",
      "requester": "123456789012",
      "source-ip-address": "200.0.100.11",
      "reason": "PutObject"
    }
  }