Actualización de un lanzamiento canary - Amazon API Gateway

Actualización de un lanzamiento canary

Una vez que se implemente el lanzamiento canary, es posible que quiera ajustar el porcentaje de tráfico de canary o que desee habilitar o deshabilitar el uso de la caché de etapas para optimizar el rendimiento de las pruebas. También puede modificar las variables de etapa que se utilizan en el lanzamiento canary cuando se actualiza el contexto de ejecución. Para realizar este tipo de actualizaciones, llame a la operación stage:update utilizando valores nuevos en canarySettings.

Puede actualizar un lanzamiento canary con la consola de API Gateway, el comando update-stage de la AWS CLI o un AWS SDK.

Actualización de un lanzamiento canary con la consola de API Gateway

Si desea utilizar la consola de API Gateway para actualizar la configuración de canary de una etapa, haga lo siguiente:

  1. Inicie sesión en la consola de API Gateway y seleccione una API existente en el panel de navegación principal.

  2. Seleccione Stages (Etapas) en la API y elija una etapa existente en la lista Stages (Etapas) para abrir Stage Editor (Editor de etapas).

  3. Seleccione la pestaña Canary en Stage Editor (Editor de etapas).

  4. Actualice Percentage of requests directed to Canary (Porcentaje de solicitudes dirigidas a canary) aumentando o reduciendo el porcentaje en un valor comprendido entre 0,0 y 100,0 (ambos incluidos).

  5. Actualice Canary Stage Variables (Variables de etapa de canary) incluyendo, agregando, quitando o modificando una variable de etapa.

  6. Actualice la opción Enable use of stage cache (Habilitar uso de la caché de etapas) activando o desactivando la casilla.

  7. Guarde los cambios.

Actualización de un lanzamiento canary a través de la AWS CLI

Si desea utilizar la AWS CLI para actualizar un lanzamiento canary, llame al comando update-stage.

Para habilitar o desactivar el uso de una caché de etapas en el lanzamiento canary, llame al comando update-stage, tal y como se muestra a continuación:

aws apigateway update-stage \ --rest-api-id {rest-api-id} \ --stage-name '{stage-name}' \ --patch-operations op=replace,path=/canarySettings/useStageCache,value=true

Para ajustar el porcentaje de tráfico del lanzamiento canary, llame a update-stage para reemplazar el valor /canarySettings/percentTraffic de stage.

aws apigateway update-stage \ --rest-api-id {rest-api-id} \ --stage-name '{stage-name}' \ --patch-operations op=replace,path=/canarySettings/percentTraffic,value=25.0

Para actualizar las variables de etapa del lanzamiento canary agregando, sustituyendo o quitando una variable de etapa:

aws apigateway update-stage \ --rest-api-id {rest-api-id} \ --stage-name '{stage-name}' \ --patch-operations '[{ \ "op": "replace", \ "path": "/canarySettings/stageVariableOverrides/newVar" \ "value": "newVal", \ }, { \ "op": "replace", \ "path": "/canarySettings/stageVariableOverrides/var2" \ "value": "val4", \ }, { \ "op": "remove", \ "path": "/canarySettings/stageVariableOverrides/var1" \ }]'

Puede realizar todas las actualizaciones anteriores combinando las operaciones en un solo valor patch-operations:

aws apigateway update-stage \ --rest-api-id {rest-api-id} \ --stage-name '{stage-name}' \ --patch-operations '[{ \ "op": "replace", \ "path": "/canary/percentTraffic", \ "value": "20.0" \ }, { \ "op": "replace", \ "path": "/canary/useStageCache", \ "value": "true" \ }, { \ "op": "remove", \ "path": "/canarySettings/stageVariableOverrides/var1" \ }, { \ "op": "replace", \ "path": "/canarySettings/stageVariableOverrides/newVar", \ "value": "newVal" \ }, { \ "op": "replace", \ "path": "/canarySettings/stageVariableOverrides/val2", \ "value": "val4" \ }]'