Bekerja dengan AWS Step Functions - AWS Toolkit for VS Code

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

Bekerja dengan AWS Step Functions

Anda dapat menggunakan AWS Toolkit for Visual Studio Code (Kode VS) untuk melakukan berbagai operasi dengan mesin negara.

Prasyarat

Bekerja dengan mesin negara di VS Code

Anda dapat menggunakan VS Code untuk berinteraksi dengan mesin status jarak jauh, dan mengembangkan mesin status secara lokal dalam format JSON atau YAMB. Anda dapat membuat atau memperbarui mesin status, membuat daftar mesin status yang ada, menjalankannya, dan mengunduhnya. Kode VS juga memungkinkan Anda membuat mesin status baru dari templat, melihat visualisasi mesin status Anda, dan menyediakan cuplikan kode, penyelesaian kode, serta validasi kode.

Daftar mesin negara yang ada

Jika Anda telah membuat mesin status, Anda dapat melihat daftarnya:

  1. Buka AWS Explorer.

  2. Pilih Step Functions

  3. Verifikasi bahwa itu mencantumkan semua mesin negara di akun Anda.

    AWS Explorer menu showing regions and services, with LambdaStateMachine highlighted under Step Functions.

Unduh mesin negara

Untuk mengunduh mesin negara:

  1. Di AWS Explorer, klik kanan mesin status yang ingin Anda unduh.

  2. Pilih Unduh, lalu pilih lokasi di mana Anda ingin mengunduh mesin negara.

  3. Verifikasi bahwa itu diunduh dengan benar.

    AWS Explorer menu showing LambdaStateMachine with Download Definition option highlighted.

Buat mesin status

Anda dapat membuat mesin status baru sendiri, atau Anda dapat menggunakan templat. Untuk informasi selengkapnya tentang membuat mesin status dari templat, lihat bagian State Machine Templates. Untuk membuat mesin negara baru:

  1. Buat file Amazon States Language (ASL) baru dengan definisi mesin status Anda. Gunakan menu di kanan bawah untuk mengaturnya sebagai Bahasa Negara Amazon.

  2. Pilih Publish to Step Functions.

    JSON code snippet showing state machine configuration with FirstState and ChoiceState.
  3. Pilih Buat Cepat, pilih peran, dan beri nama mesin status Anda.

    Quick Create option highlighted for creating a state machine with default settings.
    Dropdown menu showing execution role options, with ECSRole highlighted for selection.
    Dialog box prompting user to name their state machine, with input field and instructions.

Perbarui mesin negara

Untuk memperbarui mesin status:

  1. Edit file ASL dengan definisi mesin status Anda.

  2. Pilih Publish to Step Functions.

    JSON code snippet showing state machine configuration with FirstState and ChoiceState.
  3. Pilih Pembaruan Cepat, lalu pilih mesin status yang ingin Anda perbarui.

    Quick Update option highlighted in the Publish to AWS Step Functions menu.
    Dropdown menu showing state machine options for updating in us-east-1 region.

Jalankan mesin negara

Untuk menjalankan mesin status:

  1. Di AWS Explorer, klik kanan mesin status yang ingin Anda jalankan.

  2. Berikan masukan untuk mesin negara. Anda dapat mencoba input dari file, dan masukan dalam kotak teks.

  3. Mulai mesin status dan verifikasi bahwa itu berjalan dengan sukses.

    AWS Explorer menu showing LambdaStateMachine with Start Execution option highlighted.
    Start Execution interface for LambdaStateMachine with JSON input option and example.

Templat mesin negara

Saat Anda membuat mesin status, Anda memiliki opsi untuk membuatnya dari templat. Template berisi definisi mesin status sampel dengan beberapa status yang umum digunakan, dan memberi Anda titik awal. Untuk menggunakan templat mesin negara:

  1. Buka Command Palette di VS Code.

  2. Pilih AWS Toolkit Buat mesin status Step Functions baru.

  3. Pilih template yang ingin Anda gunakan.

    List of starter templates including Hello world, Retry failure, Wait state, and others.
  4. Pilih apakah Anda ingin menggunakan format template JSON atau YAMAL.

    Dropdown menu showing JSON and YAML options for selecting a template format.

Visualisasi grafik mesin negara

Visualisasi grafik memungkinkan Anda melihat seperti apa mesin status Anda dalam format grafis. Saat Anda membuat visualisasi grafik, tab lain akan terbuka dan menampilkan visualisasi mesin status JSON atau YAMB. Anda kemudian dapat membandingkan definisi mesin negara yang Anda tulis bersamaan dengan visualisasinya. Saat Anda mengubah definisi mesin status Anda, visualisasi akan diperbarui.

catatan

Untuk membuat visualisasi definisi mesin negara, definisi harus terbuka di editor aktif. Jika Anda menutup atau mengganti nama file definisi, visualisasi akan ditutup.

Untuk membuat visualisasi grafik mesin negara:

  1. Tentukan mesin negara Anda.

  2. Buka Command Palette di VS Code.

  3. Untuk membuat visualisasi, gunakan tombol visualisasi di sudut kanan atas, atau pilih AWS Render grafik.

    JSON code and graph visualization of Amazon States Language with choice state example.

Cuplikan kode

Cuplikan kode memungkinkan Anda memasukkan bagian pendek kode. Untuk menggunakan cuplikan kode:

  1. Buka file dan simpan dengan ekstensi .asl.json untuk format JSON, atau .asl.yaml untuk format YAMAL.

  2. Buat mesin negara baru dengan properti States.

  3. Tempatkan kursor di dalam Negara.

  4. Gunakan kombinasi tombol Control + Space, dan pilih cuplikan kode pilihan Anda.

  5. Gunakan Tab untuk melintasi variabel dan parameter dalam cuplikan kode.

  6. Uji Coba Lagi dan Tangkap cuplikan dengan menempatkan kursor dalam status terkait.

    Code snippet for Lambda Task State with dropdown menu showing various state types.

Penyelesaian dan validasi kode

Untuk melihat cara kerja penyelesaian kode:

  1. Buat beberapa negara.

  2. Tempatkan kursor setelah properti Berikutnya, StartAt, atau Default.

  3. Gunakan kombinasi tombol Control + Space untuk membuat daftar penyelesaian yang tersedia. Properti tambahan dapat diakses menggunakan Control + Space lagi, dan akan didasarkan Type padaState.

  4. Saat Anda bekerja, validasi kode akan terjadi untuk:

    • Properti yang hilang

    • Nilai yang salah

    • Tidak ada status terminal

    • Tidak ada keadaan yang ditunjuk

    JSON code snippet showing state machine structure with task, choice, and default states.
    Code snippet showing AWS Lambda function properties with a tooltip describing the Catch property.