[Beta]{class="badge positive"}
Utilizar implementaciones canarias para validar el código canary-deployments
En el caso de implementaciones de AEM Cloud Service, las implementaciones canarias en Cloud Manager le permiten validar el nuevo código en el nivel de publicación de la infraestructura de producción activa antes de dirigir el tráfico real de usuarios a ella. La nueva versión se implementa junto con la versión estable actual y se accede a ella mediante un encabezado de solicitud dedicado. Después de confirmar que la nueva versión funciona correctamente, puede promocionarla a todo el tráfico (esto sucede automáticamente después de una ventana de 3 horas) o revertirla.
Los entornos de desarrollo y ensayo siguen siendo los principales lugares para probar las versiones de código; las implementaciones canarias sirven como una oportunidad adicional para comprobar que una versión funciona como espera. Por ejemplo, resulta útil si la producción de AEM se integra con el punto de conexión de producción de un servicio externo, que no se valida explícitamente en entornos de AEM inferiores.
Las implementaciones de Canary son para validación interna, no para cambiar el tráfico de usuario real de la versión antigua a la nueva; el tráfico de usuario real nunca se enruta a las instancias de Canary automáticamente.
Proceso de implementación en Canarias how-canary-deployments-work
Cuando se ejecuta una canalización de pila completa que tiene habilitadas las implementaciones canarias, Cloud Manager inicia un conjunto independiente de instancias canarias para la nueva compilación, mientras que las instancias estables siguen sirviendo a los usuarios. El proceso sigue estos pasos:
- Ejecute una canalización de implementación de pila completa, fase o producción, que tenga habilitadas las implementaciones canarias.
Consulte Ejecutar una canalización y Habilitar implementaciones canarias. - Durante el paso de implementación, Cloud Manager inicia instancias canarias que ejecutan la nueva versión del código.
- Las instancias estables existentes siguen sirviendo tráfico en directo.
- Se llega a la nueva versión de forma selectiva añadiendo un encabezado de solicitud canario. Consulte Acceso a la versión de Canary.
- Durante una ventana de validación, se promociona la versión canaria a todo el tráfico o se cancela. Ver Validar y promocionar o cancelar.
Habilitar implementaciones canarias enable-canary-deployments
Las implementaciones canarias se habilitan en la canalización de pila completa. Las implementaciones canarias solo son compatibles con los entornos stage y production. Tenga en cuenta que una canalización configurada para implementar tanto en fase como en producción ejecuta la implementación canaria solo en producción, como se muestra a continuación.
Comportamiento de implementación canaria por tipo de canalización
El lugar en el que se ejecuta la implementación canaria depende del tipo de canalización.
Para habilitar implementaciones canarias:
-
En Cloud Manager, agregue una nueva canalización o edite una canalización existente que implemente código de pila completa en un entorno de ensayo o producción.
-
En el cuadro de diálogo Editar canalización de producción, haga clic en la ficha Código Source.
-
En la sección Canalización, en el encabezado de Opciones de implementación de producción, haga clic en Implementación canaria (beta).
-
Haga clic en Actualizar para completar la habilitación de la canalización.
Durante la ventana de validación, solo las solicitudes que incluyen el encabezado canario llegan a la versión recién implementada. Todas las demás solicitudes siguen llegando a la versión estable.
Acceso a la versión de Canary access-the-canary-release
Después de que Cloud Manager inicie las instancias canarias, se llega a la nueva versión añadiendo un encabezado HTTP a las solicitudes. La versión estable sigue sirviendo solicitudes sin el encabezado.
Para enviar una solicitud a la versión de Canary, incluya el siguiente encabezado:
X-Aem-Canary: true
Validar, promocionar o cancelar validate-and-promote-or-cancel
Cuando las instancias canarias están listas, se abre una ventana de validación para que pueda probar la nueva versión. Cloud Manager muestra las opciones Cambiar a producción y Cancelar implementación en la sección Implementar en producción.
Promocionar la versión para Canarias promote-the-canary-release
Para enrutar todo el tráfico en directo a la nueva versión, haz clic en Promocionar a producción. Cuando promocione la versión de Canary:
- La versión canaria se convierte en la nueva versión estable.
- Cloud Manager enruta todo el tráfico en directo a la nueva versión.
- La reversión ya no está disponible.
Cancelar la implementación canaria cancel-the-canary-deployment
Si encuentra problemas durante la ventana de validación, haga clic en Cancelar implementación. Al cancelar la implementación canaria:
- Cloud Manager detiene la versión de Canary y elimina las instancias de Canary.
- La versión estable anterior sigue sirviendo tráfico.
- La cancelación solo está disponible durante la ventana de validación.
Alcance y limitaciones scope-and-limitations
Tenga en cuenta los siguientes ámbitos y limitaciones al utilizar implementaciones canarias:
- Las implementaciones canarias solo se aplican al nivel de publicación. El nivel de creación permanece en la versión estable durante la validación canaria.
- Los cambios deben ser compatibles con versiones anteriores para que las instancias de publicación canarias puedan servir a las estructuras de contenido existentes.
- Los cambios en el contenido mutable de una versión se aplican después de promocionar la versión canaria. Estos cambios no están disponibles en las instancias canarias durante la validación.