Alias mesin negara

Alias adalah pointer hingga dua versi dari mesin state yang sama. Anda dapat membuat beberapa alias untuk mesin negara Anda. Setiap alias memiliki Nama Sumber Daya Amazon (ARN) yang unik. Alias ARN adalah kombinasi dari ARN mesin negara dan nama alias, dipisahkan oleh titik dua (:). Contoh berikut menunjukkan format mesin negara alias ARN.

arn:partition:states:region:account-id:stateMachine:myStateMachine:aliasName

Anda dapat menggunakan alias untuk merutekan lalu lintas antara salah satu dari dua versi mesin negara. Anda juga dapat membuat alias yang menunjuk ke satu versi. Alias hanya dapat menunjuk ke versi mesin status. Anda tidak dapat menggunakan alias untuk menunjuk ke alias lain. Anda juga dapat memperbarui alias untuk menunjuk ke versi mesin status yang berbeda.

Membuat alias mesin status (Konsol)

Anda dapat membuat hingga 100 alias untuk setiap state machine dengan menggunakan konsol Step Functions atau dengan menjalankan aksi CreateStateMachineAliasAPI. Untuk meminta peningkatan batas lunak ini, gunakan halaman Support Center di halaman AWS Management Console. Hapus alias yang tidak digunakan dari konsol atau dengan menjalankan tindakan API. DeleteStateMachineAlias

Untuk membuat alias mesin negara

1. Buka konsol Step Functions, lalu pilih state machine yang ada.

2. Pada halaman detail mesin State, pilih tab Alias.

3. Pilih Buat alias baru.

4. Di halaman Buat alias, lakukan hal berikut:

   1. Masukkan nama Alias.

   2. (Opsional) Masukkan Deskripsi untuk alias.

5. Untuk mengonfigurasi perutean pada alias, lihat Konfigurasi perutean Alias.

6. Pilih Buat alias.

Mengelola alias dengan operasi Step Functions API

Step Functions menyediakan operasi API berikut yang dapat Anda gunakan untuk membuat dan mengelola alias mesin status atau mendapatkan informasi tentang alias:

• CreateStateMachineAlias— Membuat alias untuk mesin negara.

• DescribeStateMachineAlias— Mengembalikan rincian tentang alias mesin negara.

• ListStateMachineAliases— Daftar alias untuk ARN mesin negara yang ditentukan.

• UpdateStateMachineAlias— Memperbarui konfigurasi alias mesin status yang ada dengan memodifikasi atau. description routingConfiguration

• DeleteStateMachineAlias— Menghapus versi mesin negara.

Untuk membuat alias bernama PROD yang menunjuk ke versi 1 dari mesin negara bernama myStateMachine menggunakan AWS Command Line Interface, gunakan create-state-machine-alias perintah.

aws stepfunctions create-state-machine-alias --name PROD  --routing-configuration "[{\"stateMachineVersionArn\":\"arn:aws:states:us-east-1:123456789012:stateMachine:myStateMachine:1\",\"weight\":100}]"

Konfigurasi perutean alias

Anda dapat menggunakan alias untuk merutekan lalu lintas eksekusi antara dua versi mesin negara. Misalnya, Anda ingin meluncurkan versi baru dari mesin status Anda. Anda dapat mengurangi risiko yang terlibat dalam penerapan versi baru dengan mengonfigurasi perutean pada alias. Dengan mengonfigurasi perutean, Anda dapat mengirim sebagian besar lalu lintas Anda ke versi mesin status Anda yang telah diuji sebelumnya. Versi baru kemudian dapat menerima persentase yang lebih kecil, sampai Anda dapat mengonfirmasi bahwa aman untuk meneruskan versi baru.

Untuk menentukan konfigurasi perutean, pastikan Anda memublikasikan kedua versi mesin status yang ditunjuk alias Anda. Ketika Anda memulai eksekusi dari alias, Step Functions secara acak memilih versi state machine untuk dijalankan dari versi yang ditentukan dalam konfigurasi routing. Ini mendasarkan pilihan ini pada persentase lalu lintas yang Anda tetapkan untuk setiap versi dalam konfigurasi routing alias.

Untuk mengkonfigurasi konfigurasi routing pada alias

• Pada halaman Create alias, di bawah konfigurasi Routing, lakukan hal berikut:

  1. Untuk Versi, pilih versi mesin status pertama yang ditunjuk alias.

  2. Pilih kotak centang Pisahkan lalu lintas antara dua versi.

     Tip

     Untuk menunjuk ke satu versi, kosongkan kotak centang Split traffic antara dua versi.

  3. Untuk Versi, pilih versi kedua yang harus ditunjukkan oleh alias.

  4. Di bidang Persentase lalu lintas, tentukan persentase lalu lintas untuk merutekan ke setiap versi. Misalnya, masukkan 60 dan 40 rute 60 persen lalu lintas eksekusi ke versi pertama dan 40 persen lalu lintas ke versi kedua.

     Persentase lalu lintas gabungan harus sama dengan 100 persen.

Menjalankan mesin status menggunakan alias (Konsol)

Anda dapat memulai eksekusi mesin status dengan alias baik dari konsol atau dengan menjalankan aksi StartExecutionAPI dengan ARN alias. Step Functions kemudian menjalankan versi yang ditentukan oleh alias. Secara default, jika Anda tidak menentukan versi atau alias saat memulai eksekusi mesin status, Step Functions menggunakan revisi terbaru.

Untuk memulai eksekusi mesin status menggunakan alias

1. Buka konsol Step Functions, lalu pilih mesin status yang sudah ada yang telah Anda buat alias. Untuk informasi tentang membuat alias, lihatMembuat alias mesin status (Konsol).

2. Pada halaman detail mesin State, pilih tab Alias.

3. Di bagian Alias, lakukan hal berikut:

   1. Pilih alias yang ingin Anda gunakan untuk memulai eksekusi.

   2. Pilih Mulai Eksekusi.

4. (Opsional) Dalam Mulai eksekusi kotak dialog, masukkan nama untuk eksekusi.

5. Jika diperlukan, masukkan input eksekusi, lalu pilih Mulai eksekusi.