Promosikan pelepasan kenari - Amazon API Gateway
Promosikan rilis kenari menggunakan konsol API GatewayPromosikan pelepasan kenari menggunakan AWS CLI

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

Promosikan pelepasan kenari

Saat Anda mempromosikan rilis kenari, rilis kenari menggantikan pengaturan tahap saat ini. Mempromosikan pelepasan kenari tidak menonaktifkan kenari di atas panggung. Untuk menonaktifkan kenari, Anda harus menghapus pengaturan kenari di atas panggung. Untuk mempromosikan kenari, lakukan hal 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%.

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 menggunakan AWS 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"
    }
}

Gunakan perintah update-stage berikut untuk mempromosikan kenari:

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"                           
      }]'

Outputnya akan terlihat seperti berikut:

{
    "_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"
    }
}

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