Menerapkan penerapan kenari Lambda menggunakan alias tertimbang

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

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

Anda dapat menggunakan alias tertimbang untuk membagi lalu lintas antara dua versi berbeda dari fungsi yang sama. Dengan pendekatan ini, Anda dapat menguji versi baru dari fungsi Anda dengan persentase lalu lintas yang kecil dan dengan cepat memutar kembali jika perlu. Ini dikenal sebagai penyebaran kenari. Penerapan Canary berbeda dari penerapan biru/hijau dengan mengekspos versi baru hanya pada sebagian permintaan daripada mengalihkan semua lalu lintas sekaligus.

Anda dapat mengarahkan alias ke maksimal dua versi fungsi Lambda. Versi harus memenuhi kriteria berikut:

Buat alias tertimbang

Console

Untuk mengonfigurasi perutean pada alias menggunakan konsol

catatan

Verifikasi bahwa fungsi memiliki setidaknya dua versi yang dipublikasikan. Untuk membuat versi tambahan, ikuti petunjuk dalam Membuat versi fungsi.

1. Buka halaman Fungsi di konsol Lambda.

2. Pilih fungsi.

3. Pilih Alias, lalu pilih Buat alias.

4. Di halaman Buat alias, lakukan hal berikut:

   1. Masukkan Nama untuk alias.

   2. (Opsional) Masukkan Deskripsi untuk alias.

   3. Untuk Versi, pilih versi fungsi pertama yang ingin Anda tunjuk.

   4. Perluas Alias tertimbang.

   5. Untuk Versi tambahan, pilih versi fungsi kedua yang ingin Anda tunjuk.

   6. Untuk Bobot (%), masukkan nilai bobot untuk fungsi. Bobot adalah persentase lalu lintas yang ditetapkan untuk versi tersebut ketika alias dipanggil. Versi pertama menerima bobot residual. Misalnya, jika Anda menentukan 10 persen ke Versi tambahan, versi pertama ditetapkan ke 90 persen secara otomatis.

   7. Pilih Simpan.

AWS CLI

Gunakan AWS CLI perintah create-alias dan update-alias untuk mengonfigurasi bobot lalu lintas antara dua versi fungsi. Saat membuat atau memperbarui alias, Anda menentukan berat lalu lintas dalam parameter routing-config.

Contoh berikut membuat alias fungsi Lambda bernama routing-alias yang menunjuk ke versi 1 dari fungsi. Versi 2 fungsi menerima 3 persen lalu lintas. 97 persen lalu lintas yang tersisa diarahkan ke versi 1.

aws lambda create-alias \
  --name routing-alias \
  --function-name my-function \
  --function-version 1  \
  --routing-config AdditionalVersionWeights={"2"=0.03}

Gunakan perintah update-alias untuk meningkatkan persentase lalu lintas masuk ke versi 2. Dalam contoh berikut, Anda meningkatkan lalu lintas menjadi 5 persen.

aws lambda update-alias \
  --name routing-alias \
  --function-name my-function \
  --routing-config AdditionalVersionWeights={"2"=0.05}

Untuk mengirimkan semua lalu lintas ke versi 2, gunakan update-alias untuk mengubah properti function-version untuk menunjuk alias ke versi 2. Perintah juga mengatur ulang konfigurasi perutean.

aws lambda update-alias \
  --name routing-alias \
  --function-name my-function  \
  --function-version 2 \
  --routing-config AdditionalVersionWeights={}

AWS CLI Perintah pada langkah sebelumnya sesuai dengan operasi API Lambda berikut:

• CreateAlias

• UpdateAlias

anchoranchor

• Console
• AWS CLI

Untuk mengonfigurasi perutean pada alias menggunakan konsol

catatan

Verifikasi bahwa fungsi memiliki setidaknya dua versi yang dipublikasikan. Untuk membuat versi tambahan, ikuti petunjuk dalam Membuat versi fungsi.

1. Buka halaman Fungsi di konsol Lambda.

2. Pilih fungsi.

3. Pilih Alias, lalu pilih Buat alias.

4. Di halaman Buat alias, lakukan hal berikut:

   1. Masukkan Nama untuk alias.

   2. (Opsional) Masukkan Deskripsi untuk alias.

   3. Untuk Versi, pilih versi fungsi pertama yang ingin Anda tunjuk.

   4. Perluas Alias tertimbang.

   5. Untuk Versi tambahan, pilih versi fungsi kedua yang ingin Anda tunjuk.

   6. Untuk Bobot (%), masukkan nilai bobot untuk fungsi. Bobot adalah persentase lalu lintas yang ditetapkan untuk versi tersebut ketika alias dipanggil. Versi pertama menerima bobot residual. Misalnya, jika Anda menentukan 10 persen ke Versi tambahan, versi pertama ditetapkan ke 90 persen secara otomatis.

   7. Pilih Simpan.

Menentukan versi mana yang dipanggil

Saat Anda mengonfigurasi bobot lalu lintas di antara dua versi fungsi, ada dua cara untuk menentukan versi fungsi Lambda yang sudah dipanggil:

Buat penerapan bergulir dengan alias tertimbang

Use AWS CodeDeploy and AWS Serverless Application Model (AWS SAM) untuk membuat penerapan bergulir yang secara otomatis mendeteksi perubahan pada kode fungsi Anda, menerapkan versi baru fungsi Anda, dan secara bertahap meningkatkan jumlah lalu lintas yang mengalir ke versi baru. Jumlah lalu lintas dan tingkat peningkatan adalah parameter yang dapat Anda konfigurasi.

Dalam penerapan bergulir, AWS SAM lakukan tugas-tugas ini:

Contoh AWS SAM template

Contoh berikut menunjukkan templat AWS SAM untuk deployment bergulir sederhana.

AWSTemplateFormatVersion : '2010-09-09'
Transform: AWS::Serverless-2016-10-31
Description: A sample SAM template for deploying Lambda functions

Resources:
# Details about the myDateTimeFunction Lambda function
  myDateTimeFunction:
    Type: AWS::Serverless::Function
    Properties:
      Handler: myDateTimeFunction.handler
      Runtime: nodejs18.x
# Creates an alias named "live" for the function, and automatically publishes when you update the function.
      AutoPublishAlias: live
      DeploymentPreference:
# Specifies the deployment configuration
          Type: Linear10PercentEvery2Minutes

Templat ini menentukan fungsi Lambda bernama myDateTimeFunction dengan properti berikut.

Untuk informasi selengkapnya tentang cara membuat penerapan bergulir dengan CodeDeploy dan AWS SAM, lihat berikut ini: