Implementación del código

Obtenga información sobre cómo implementar su código en Producción mediante canalizaciones de Cloud Manager en AEM as a Cloud Service.

La implementación del código en Fase y luego hasta Producción se realiza mediante una canalización de producción. La ejecución de la canalización de producción se divide en dos fases lógicas.

1. Implementación en entorno de ensayo
   • El código se crea e implementa en el entorno de ensayo para pruebas funcionales automatizadas, pruebas de interfaz de usuario, auditoría de experiencias y pruebas de aceptación de usuarios (UAT).
2. Implementación en el entorno de producción
   • Una vez validada la compilación en Stage y aprobada para su promoción en Production, el mismo artefacto de compilación se implementa en el entorno Production.

Solo el tipo de canalización de código de pila completa admite la digitalización de código, las pruebas de funciones, las pruebas de interfaz de usuario y la auditoría de experiencias.

Implementación del código con Cloud Manager en AEM as a Cloud Service

Una vez que haya configuró la canalización de producción incluido el repositorio, el entorno y el entorno de prueba, está listo para implementar su código.

1. Inicie sesión en Cloud Manager en my.cloudmanager.adobe.com y seleccione la organización adecuada.

2. Haga clic en el programa para el que desea implementar el código.

3. Haga clic en Implementación de la llamada a la acción en la variable Información general para iniciar el proceso de implementación.

   

4. La variable Ejecución de canalización se abre. Haga clic en Generar para iniciar el proceso.

   

El proceso de compilación implementa el código en tres fases.

1. Implementación de fase
2. Prueba de prueba
3. Implementación de producción

Fase de implementación de fase

La variable Implementación de fase fase. implica estos pasos.

• Validación : este paso garantiza que la canalización esté configurada para utilizar los recursos disponibles actualmente. Por ejemplo, probar que la rama configurada existe y que los entornos están disponibles.
• Prueba de compilación y unidad - Este paso ejecuta un proceso de compilación en contenedores.
  • Consulte el documento Generar detalles del entorno para obtener más información sobre el entorno de compilación.
• Escaneo de código - Este paso evalúa la calidad del código de la aplicación.
  • Consulte el documento Prueba de calidad de código para obtener más información sobre el proceso de prueba.
• Crear imágenes - Este proceso es responsable de transformar el contenido y los paquetes de Dispatcher producidos por el paso de compilación en imágenes Docker y configuraciones de Kubernetes.
• Implementar en fase - La imagen se implementa en el entorno de ensayo como preparación para la Etapa de prueba de fase.

Fase de prueba de fase

La variable Prueba de fase incluye estos pasos.

• Prueba funcional del producto : la canalización de Cloud Manager ejecuta pruebas que se ejecutan en el entorno de ensayo.

  • Consulte el documento Prueba funcional del producto para obtener más información.

• Pruebas funcionales personalizadas - Este paso en la canalización siempre se ejecuta y no se puede omitir. Si la compilación no produce JAR de prueba, la prueba pasa de forma predeterminada.

  • Consulte el documento Pruebas funcionales personalizadas para obtener más información.

• Pruebas de IU personalizadas : Este paso es una función opcional que ejecuta automáticamente las pruebas de IU creadas para aplicaciones personalizadas.

  • Las pruebas de interfaz de usuario son pruebas basadas en Selenium empaquetadas en una imagen Docker para permitir una amplia variedad de idiomas y marcos (como Java y Maven, Node y WebDriver.io, o cualquier otro marco y tecnología creados en Selenium).
  • Consulte el documento Pruebas de IU personalizadas para obtener más información.

• Auditoría de experiencias - Este paso en la canalización siempre se ejecuta y no se puede omitir. A medida que se ejecuta una canalización de producción, se incluye un paso de auditoría de experiencias después de realizar pruebas funcionales personalizadas que ejecutarán las comprobaciones.

  • Las páginas configuradas se envían al servicio y se evalúan.
  • Los resultados son informativos y muestran las puntuaciones y el cambio entre las puntuaciones actual y anterior.
  • Esta perspectiva es valiosa para determinar si hay una regresión que se introducirá con la implementación actual.
  • Consulte el documento Comprender los resultados de la auditoría de experiencias para obtener más información.

Fase de implementación de producción

El proceso de implementación en topologías de producción difiere ligeramente para minimizar el impacto de los visitantes en un sitio AEM.

Las implementaciones de producción suelen seguir los mismos pasos que se describieron anteriormente, pero de forma gradual.

1. Implemente AEM paquetes para crear.
2. Desasocie Dispatcher1 del equilibrador de carga.
3. Implemente AEM paquetes para publicar1 y el paquete de Dispatcher para dispatcher1, vacíe la caché de Dispatcher.
4. Vuelva a colocar Dispatcher1 en el equilibrador de carga.
5. Una vez que Dispatcher1 vuelva a estar en servicio, separe Dispatcher2 del equilibrador de carga.
6. Implemente AEM paquetes para publicar2 y el paquete de Dispatcher para dispatcher2, vacíe la caché de Dispatcher.
7. Vuelva a colocar Dispatcher2 en el equilibrador de carga.

Este proceso continúa hasta que la implementación haya llegado a todos los editores y distribuidores de la topología.

Tiempos de espera

Los siguientes pasos agotarán el tiempo de espera si se deja esperando los comentarios del usuario:

Proceso de implementación

Todas las implementaciones de Cloud Service siguen un proceso gradual para garantizar que no haya downtime. Consulte el documento Cómo funcionan las implementaciones móviles para obtener más información.

Volver a ejecutar una implementación de producción

La reejecución del paso de implementación de producción se admite en ejecuciones en las que se haya completado el paso de implementación de producción. El tipo de finalización no es importante: la implementación podría cancelarse o no tener éxito. Dicho esto, se espera que el caso de uso principal sean los casos en los que el paso de implementación de producción haya fallado por motivos transitorios. La reejecución crea una nueva ejecución utilizando la misma canalización. Esta nueva ejecución consta de tres pasos:

1. El paso validate : esto es esencialmente la misma validación que se produce durante la ejecución normal de una canalización.
2. El paso de compilación : en el contexto de una nueva ejecución, el paso de compilación es copiar artefactos, no ejecutar realmente un nuevo proceso de compilación.
3. El paso de implementación de producción : utiliza la misma configuración y opciones que el paso de implementación de producción en una ejecución de canalización normal.

El paso de compilación puede tener una etiqueta ligeramente diferente en la interfaz de usuario para reflejar que está copiando artefactos, no reconstruyendo.

Restricciones:

• La ejecución del paso de implementación de producción solo estará disponible en la última ejecución.
• La reejecución no está disponible para las ejecuciones de actualización push. Si la última ejecución es una ejecución de actualización push, no es posible la reejecución.
• Si la última ejecución es una ejecución de actualización push, no es posible la reejecución.
• Si la última ejecución ha fallado en cualquier momento antes del paso de implementación de producción, la reejecución no es posible.

Volver a ejecutar la API

Identificación de una ejecución de nueva ejecución

Para identificar si una ejecución es una ejecución de nueva ejecución, se puede examinar el campo de déclencheur. Su valor será RE_EXECUTE.

Activación de una nueva ejecución

Para déclencheur de una nueva ejecución, se debe realizar una solicitud de PUT al vínculo HAL <(http://ns.adobe.com/adobecloud/rel/pipeline/reExecute)> en el estado del paso de implementación de producción. Si este vínculo está presente, la ejecución se puede reiniciar desde ese paso. Si está ausente, la ejecución no se puede reiniciar desde ese paso. En la versión inicial, este vínculo solo estará presente en el paso de implementación de producción, pero las versiones futuras pueden admitir el inicio de la canalización desde otros pasos. Ejemplo:

 {
  "_links": {
    "http://ns.adobe.com/adobecloud/rel/pipeline/logs": {
      "href": "/api/program/4/pipeline/1/execution/953671/phase/1575676/step/2983530/logs",
      "templated": false
    },
    "http://ns.adobe.com/adobecloud/rel/pipeline/reExecute": {
      "href": "/api/program/4/pipeline/1/execution?stepId=2983530",
      "templated": false
    },
    "http://ns.adobe.com/adobecloud/rel/pipeline/metrics": {
      "href": "/api/program/4/pipeline/1/execution/953671/phase/1575676/step/2983530/metrics",
      "templated": false
    },
    "self": {
      "href": "/api/program/4/pipeline/1/execution/953671/phase/1575676/step/2983530",
      "templated": false
    }
  },
  "id": "6187842",
  "stepId": "2983530",
  "phaseId": "1575676",
  "action": "deploy",
  "environment": "weretail-global-b75-prod",
  "environmentType": "prod",
  "environmentId": "59254",
  "startedAt": "2022-01-20T14:47:41.247+0000",
  "finishedAt": "2022-01-20T15:06:19.885+0000",
  "updatedAt": "2022-01-20T15:06:20.803+0000",
  "details": {
  },
  "status": "FINISHED"

La sintaxis del vínculo HAL href no está previsto que se utilice como punto de referencia. El valor real siempre debe leerse desde el vínculo HAL y no generarse.

Envío de un PUT la solicitud a este extremo dará como resultado un 201 Si la respuesta es correcta, y el cuerpo de respuesta será la representación de la nueva ejecución. Esto es similar a iniciar una ejecución normal a través de la API.