Promosikan pelepasan kenari

Untuk mempromosikan rilis kenari membuatnya tersedia dalam tahap produksi versi API yang sedang diuji. Operasi ini melibatkan tugas-tugas berikut:

• Setel ulang ID penyebaran panggung dengan pengaturan ID penerapan kenari. Ini memperbarui snapshot API panggung dengan snapshot kenari, menjadikan versi uji sebagai rilis produksi juga.

• Perbarui variabel tahap dengan variabel tahap kenari, jika ada. Ini memperbarui konteks eksekusi API panggung dengan konteks kenari. Tanpa pembaruan ini, versi API baru dapat menghasilkan hasil yang tidak terduga jika versi pengujian menggunakan variabel tahap yang berbeda atau nilai berbeda dari variabel tahap yang ada.

• Atur persentase lalu lintas kenari menjadi 0,0%.

Mempromosikan pelepasan kenari tidak menonaktifkan kenari di atas panggung. Untuk menonaktifkan kenari, Anda harus menghapus pengaturan kenari di atas panggung.

Promosikan rilis kenari menggunakan konsol API Gateway

Untuk menggunakan konsol API Gateway untuk mempromosikan penerapan rilis canary, lakukan hal berikut:

Untuk mempromosikan penyebaran rilis kenari

1. Masuk ke konsol API Gateway dan pilih API yang ada di panel navigasi utama.

2. Di panel navigasi utama, pilih Tahapan, lalu pilih tahap yang ada.

3. Pilih tab Canary.

4. Pilih Promosikan kenari.

5. Konfirmasikan perubahan yang akan dilakukan dan pilih Promosikan kenari.

Setelah promosi, rilis produksi mereferensikan versi API yang sama (deploymentID) dengan rilis canary. Anda dapat memverifikasi ini menggunakanAWS CLI. Sebagai contoh, lihat Promosikan pelepasan kenari menggunakan AWS CLI.

Promosikan pelepasan kenari menggunakan AWS CLI

Untuk mempromosikan rilis kenari ke rilis produksi menggunakan AWS CLI perintah, panggil update-stage perintah untuk menyalin kenari yang terkait dengan tahap terkait, deploymentId untuk mengatur ulang persentase lalu lintas kenari ke nol (0.0)deploymentId, dan, untuk menyalin variabel tahap terikat kenari ke yang terikat tahap yang sesuai.

Misalkan kita memiliki penyebaran rilis kenari, dijelaskan oleh tahap yang mirip dengan yang berikut ini:

{
    "_links": {
        ...
    },
    "accessLogSettings": {
        ...
    },
    "cacheClusterEnabled": false,
    "cacheClusterStatus": "NOT_AVAILABLE",
    "canarySettings": {
        "deploymentId": "eh1sby",
        "useStageCache": false,
        "stageVariableOverrides": {
            "sv2": "val3",
            "sv1": "val2"
        },
        "percentTraffic": 10.5
    },
    "createdDate": "2017-11-20T04:42:19Z",
    "deploymentId": "nfcn0x",
    "lastUpdatedDate": "2017-11-22T00:54:28Z",
    "methodSettings": {
        ...
    },
    "stageName": "prod",
    "variables": {
        "sv1": "val1"
    }
}

Kami menyebut update-stage permintaan berikut untuk mempromosikannya:

aws apigateway update-stage  \
    --rest-api-id {rest-api-id}  \
    --stage-name '{stage-name}'  \
    --patch-operations '[{                                
        "op": "replace",                                  
        "value": "0.0",                                    
        "path": "/canarySettings/percentTraffic"         
      }, {                                                
        "op": "copy",                                     
        "from": "/canarySettings/stageVariableOverrides", 
        "path": "/variables"                             
      }, {                                                
        "op": "copy",                                     
        "from": "/canarySettings/deploymentId",           
        "path": "/deploymentId"                           
      }]'

Setelah promosi, panggung sekarang terlihat seperti ini:

{
    "_links": {
        ...
    },
    "accessLogSettings": {
        ...
    },
    "cacheClusterEnabled": false,
    "cacheClusterStatus": "NOT_AVAILABLE",
    "canarySettings": {
        "deploymentId": "eh1sby",
        "useStageCache": false,
        "stageVariableOverrides": {
            "sv2": "val3",
            "sv1": "val2"
        },
        "percentTraffic": 0
    },
    "createdDate": "2017-11-20T04:42:19Z",
    "deploymentId": "eh1sby",
    "lastUpdatedDate": "2017-11-22T05:29:47Z",
    "methodSettings": {
        ...
    },
    "stageName": "prod",
    "variables": {
        "sv2": "val3",
        "sv1": "val2"
    }
}

Seperti yang Anda lihat, mempromosikan rilis kenari ke panggung tidak menonaktifkan kenari dan penerapan tetap menjadi penerapan rilis kenari. Untuk menjadikannya penyebaran rilis produksi reguler, Anda harus menonaktifkan pengaturan kenari. Untuk informasi selengkapnya tentang cara menonaktifkan penerapan rilis kenari, lihat. Matikan pelepasan kenari