Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés. # Uso de cambio de tráfico todo a la vez Al cambiar el tráfico de una sola vez, puedes implementar rápidamente una actualización de punto final utilizando las barandillas de seguridad de un dispositivo. blue/green Puede utilizar esta opción de transferencia de tráfico para minimizar la duración de la actualización y, al mismo tiempo, aprovechar las garantías de disponibilidad de blue/green las implementaciones. La función de período de cocción le ayuda a monitorizar el rendimiento y la funcionalidad de las nuevas instancias antes de cerrar las antiguas, lo que garantiza que su nueva flota esté en pleno funcionamiento. El siguiente diagrama muestra cómo los cambios de tráfico gestionan simultáneamente las flotas antiguas y nuevas. ![Un cambio correcto del 100 % del tráfico de la flota antigua a la nueva.](http://docs.aws.amazon.com/es_es/sagemaker/latest/dg/images/deployment-guardrails-blue-green-all-at-once.png) Cuando se utilizan todos los cambios de tráfico de una sola vez, la SageMaker IA redirige el 100% del tráfico a la nueva flota (flota verde). Una vez que la flota verde comienza a recibir tráfico, comienza el período de cocción. El período de cocción es un período de tiempo establecido en el que CloudWatch las alarmas de Amazon preespecificadas controlan el rendimiento de la flota ecológica. Si no se activa ninguna alarma durante el período de inactividad, la SageMaker IA cancelará la flota anterior (flota azul). Si alguna alarma se activa durante el período de cocción, se inicia una reversión automática y el 100 % del tráfico vuelve a la flota azul. ## Requisitos previos Antes de configurar una implementación en la que el tráfico se desplace de una sola vez, debes crear CloudWatch alarmas de Amazon para ver las métricas desde tu punto de conexión. Si alguna de las alarmas se activa durante el período de cocción, el tráfico vuelve a su flota azul. Para obtener información sobre cómo configurar CloudWatch las alarmas en un punto final, consulte la página de requisitos previos[Auto-Rollback Configuración y supervisión](deployment-guardrails-configuration.md). Para obtener más información sobre CloudWatch las alarmas, consulta [Uso de CloudWatch las alarmas de Amazon](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/AlarmThatSendsEmail.html) en la *Guía del CloudWatch usuario de Amazon*. ## Configurar cambio de tráfico todo a la vez Cuando esté listo para la implementación y haya configurado CloudWatch las alarmas para su terminal, puede utilizar la [UpdateEndpoint](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_UpdateEndpoint.html)API de SageMaker IA o el comando [update-endpoint](https://docs.aws.amazon.com/cli/latest/reference/sagemaker/update-endpoint.html) AWS Command Line Interface para iniciar la implementación. **Topics** + [Cómo actualizar un punto de conexión (API)](#deployment-guardrails-blue-green-all-at-once-configure-api-update) + [Cómo actualizar un punto final con una política de blue/green actualización (API) existente](#deployment-guardrails-blue-green-all-at-once-configure-api-existing) + [Cómo actualizar un punto de conexión (CLI)](#deployment-guardrails-blue-green-all-at-once-configure-cli-update) ### Cómo actualizar un punto de conexión (API) En el siguiente ejemplo, se muestra cómo puedes actualizar tu punto de conexión para que el tráfico se desplace de una sola vez mediante [UpdateEndpoint](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_UpdateEndpoint.html)la SageMaker API de Amazon. ``` import boto3 client = boto3.client("sagemaker") response = client.update_endpoint( EndpointName="{{}}", EndpointConfigName="{{}}", DeploymentConfig={ "BlueGreenUpdatePolicy": { "TrafficRoutingConfiguration": { "Type": "ALL_AT_ONCE" }, "TerminationWaitInSeconds": 600, "MaximumExecutionTimeoutInSeconds": 1800 }, "AutoRollbackConfiguration": { "Alarms": [ { "AlarmName": "{{}}" }, ] } } ) ``` Para configurar la opción de cambio de tráfico todo a la vez, haga lo siguiente: + En `EndpointName`, utilice el nombre del punto de conexión existente que quiera actualizar. + En `EndpointConfigName`, utilice el nombre de la configuración de punto de conexión que quiera utilizar. + En `DeploymentConfig` y `BlueGreenUpdatePolicy`, in `TrafficRoutingConfiguration`, establezca el parámetro `Type` en `ALL_AT_ONCE`. Esto especifica que la implementación utiliza el modo de cambio de tráfico todo a la vez. + En `TerminationWaitInSeconds`, utilice `600`. Este parámetro indica a la SageMaker IA que espere el tiempo especificado (en segundos) hasta que la flota verde esté completamente activa antes de cerrar las instancias de la flota azul. En este ejemplo, la SageMaker IA espera 10 minutos después del último período de inactividad antes de dar por finalizada la flota azul. + En `MaximumExecutionTimeoutInSeconds`, utilice `1800`. Este parámetro establece el período máximo de tiempo durante el cual puede ejecutarse la implementación antes de que transcurra el tiempo de espera. En el ejemplo anterior, la implementación tiene un límite de 30 minutos para finalizar. + En`AutoRollbackConfiguration`, dentro del `Alarms` campo, puedes añadir tus CloudWatch alarmas por nombre. Cree una entrada `AlarmName: {{}}` para cada alarma que quiera utilizar. ### Cómo actualizar un punto final con una política de blue/green actualización (API) existente Cuando usa la [CreateEndpoint](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_CreateEndpoint.html)API para crear un punto final, puede especificar opcionalmente una configuración de implementación para reutilizarla en futuras actualizaciones del punto final. Puede usar las mismas `DeploymentConfig` opciones que en el ejemplo de UpdateEndpoint API anterior. No hay cambios en el comportamiento de la CreateEndpoint API. Al especificar la configuración de despliegue no se realiza automáticamente una blue/green actualización en el punto final. La opción de usar una configuración de implementación anterior se produce cuando se usa la [UpdateEndpoint](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_UpdateEndpoint.html)API para actualizar el punto final. Al actualizar el punto de conexión, puede utilizar la opción `RetainDeploymentConfig` para conservar la configuración de implementación que haya especificado al crear el punto de conexión. Al llamar a la [UpdateEndpoint](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_UpdateEndpoint.html)API, configúrela en esta opción `RetainDeploymentConfig` `True` para mantener las `DeploymentConfig` opciones de la configuración original de su punto final. ``` response = client.update_endpoint( EndpointName="{{}}", EndpointConfigName="{{}}", RetainDeploymentConfig=True ) ``` ### Cómo actualizar un punto de conexión (CLI) Si está utilizando la AWS CLI, en el siguiente ejemplo se muestra cómo iniciar una implementación de una blue/green sola vez mediante el comando [update-endpoint](https://docs.aws.amazon.com/cli/latest/reference/sagemaker/update-endpoint.html). ``` update-endpoint --endpoint-name {{}} --endpoint-config-name {{}} --deployment-config '"BlueGreenUpdatePolicy": {"TrafficRoutingConfiguration": {"Type": "ALL_AT_ONCE"}, "TerminationWaitInSeconds": 600, "MaximumExecutionTimeoutInSeconds": 1800}, "AutoRollbackConfiguration": {"Alarms": [{"AlarmName": "{{}}"}]}' ``` Para configurar la opción de cambio de tráfico todo a la vez, haga lo siguiente: + En `endpoint-name`, use el nombre del punto de conexión que quiera actualizar. + En `endpoint-config-name`, utilice el nombre de la configuración del punto de conexión que quiera utilizar. + Para ello`deployment-config`, utilice un objeto [BlueGreenUpdatePolicy](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_BlueGreenUpdatePolicy.html)JSON. **nota** Si prefiere guardar el objeto JSON en un archivo, consulte [Generación de parámetros AWS CLI básicos y de entrada](https://docs.aws.amazon.com/cli/latest/userguide/cli-usage-skeleton.html) en la *Guía del AWS CLI usuario*.