Configurar canalizaciones que no sean de producción

Obtenga información sobre cómo configurar canalizaciones que no sean de producción para probar la calidad del código antes de implementarlas en entornos de producción.

Canalizaciones que no son de producción

Además de canalizaciones de producción que se implementan en entornos de ensayo y producción, también puede configurar canalizaciones que no sean de producción para validar el código.

Existen dos tipos de canalizaciones que no son de producción:

  • Canalizaciones de calidad de código: ejecutan análisis de calidad del código en el código de una rama de Git y ejecutan los pasos de compilación y calidad del código.
  • Canalizaciones de implementación: además de ejecutar los pasos de compilación y calidad del código como las canalizaciones de calidad del código, estas canalizaciones implementan el código en un entorno que no es de producción.
NOTA

Puede editar la configuración de canalización después de la configuración inicial.

Adición de una nueva canalización que no sea de producción

Una vez que haya configurado el programa y tenga al menos un entorno utilizando la interfaz de usuario de Cloud Manager, estará listo para agregar una canalización que no sea de producción siguiendo estos pasos.

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

  2. Acceda a la tarjeta Canalizaciones de la pantalla de inicio de Cloud Manager. Haga clic en +Agregar y seleccione Agregar canalización que no sea de producción.

    Agregar canalización que no sea de producción

  3. En la pestaña Configuración del cuadro de diálogo Agregar canalización que no sea de producción, seleccione el tipo de canalización que no sea de producción que desee agregar.

    • Canalización de calidad de código: cree una canalización que desarrolle su código, ejecute pruebas unitarias y evalúe la calidad del código, pero no la implemente.
    • Canalización de implementación: cree una canalización que desarrolle su código, ejecute pruebas unitarias, evalúe la calidad del código y se implemente en un entorno.

    Cuadro de diálogo Agregar canalización que no sea de producción

  4. Proporcione un Nombre de canalización que no sea de producción para identificar la canalización junto con la siguiente información adicional.

    • Activador de implementación: dispone de las siguientes opciones al definir los activadores de implementación para iniciar la canalización.

      • Manual: utilice esta opción para iniciar manualmente la canalización.
      • Cambios en Git: esta opción inicia la canalización CI/CD cada vez que se añaden confirmaciones a la rama git configurada. Con esta opción, aún puede iniciar la canalización manualmente según sea necesario.
  5. Si elige crear una Canalización de implementación también tendrá que definir el Comportamiento de errores de métricas importantes.

    • Preguntar cada vez: esta es la configuración predeterminada y requiere intervención manual en caso de que se produzca algún error importante.
    • Produjo un error inmediatamente: si se selecciona, la canalización se cancelará siempre que se produzca un fallo importante. Básicamente, esto emula a un usuario rechazando manualmente cada error.
    • Continuar inmediatamente: si se selecciona, la canalización se realizará automáticamente cada vez que se produzca un error importante. Básicamente, esto está emulando a un usuario que aprueba manualmente cada error.
  6. Haga clic en Continuar.

  7. En la pestaña Código fuente del cuadro de diálogo Agregar canalización que no sea de producción, debe seleccionar qué tipo de código debe procesar la canalización.

Los pasos para completar la creación de la canalización que no sea de producción varían según la opción de Código fuente que haya seleccionado. Siga los enlaces anteriores para ir a la siguiente sección de este documento para completar la configuración de la canalización.

Código front-end

Una canalización de código front-end implementa las compilaciones de código front-end que contienen una o más aplicaciones de interfaz de usuario del lado del cliente. Consulte el documento Canalizaciones CI/CD para obtener más información sobre este tipo de canalización.

Para finalizar la configuración de la canalización de no producción de código front-end, siga estos pasos.

  1. En el Código fuente, debe definir las siguientes opciones.

    • Entornos de implementación aptos: si la canalización es una canalización de implementación, debe seleccionar a qué entornos debe implementar.
    • Repositorio: esta opción define desde qué repositorio de Git la canalización debe recuperar el código.
    SUGERENCIA

    Consulte el documento Adición y administración de repositorios para aprender a añadir y administrar repositorios en Cloud Manager.

    • Rama de Git: esta opción define desde qué rama de la canalización seleccionada debe recuperar el código.
      • Introduzca los primeros caracteres del nombre de la rama y la función de autocompletar de este campo encontrará las ramas coincidentes que le ayudarán a seleccionar.
    • Ubicación del código: esta opción define la ruta en la rama de la repo seleccionada desde la que la canalización debe recuperar el código.

    Canalización front-end

  2. Haga clic en Guardar.

La canalización se guarda y ahora puede administrar las canalizaciones en la tarjeta Canalizaciones en la página Información general del programa.

Código de pila completa

Una canalización de código de pila completa implementa simultáneamente compilaciones de código de back-end y front-end que contienen una o más aplicaciones de servidor AEM junto con la configuración HTTPD/Dispatcher. Consulte el documento Canalizaciones CI/CD para obtener más información sobre este tipo de canalización.

NOTA

Si ya existe una canalización de código de pila completa para el entorno seleccionado, esta selección se desactivará.

Para finalizar la configuración de la canalización de no producción de código de pila completa, siga estos pasos.

  1. En el Código fuente, debe definir las siguientes opciones.

    • Entornos de implementación aptos: si la canalización es una canalización de implementación, debe seleccionar a qué entornos debe implementar.
    • Repositorio: esta opción define desde qué repositorio de Git la canalización debe recuperar el código.
    SUGERENCIA

    Consulte el documento Adición y administración de repositorios para aprender a añadir y administrar repositorios en Cloud Manager.

    • Rama de Git: esta opción define desde qué rama de la canalización seleccionada debe recuperar el código.

      • Introduzca los primeros caracteres del nombre de la rama y la función de autocompletar de este campo encontrará las ramas coincidentes que le ayudarán a seleccionar.
    • Ignorar configuración de nivel web: cuando se selecciona, la canalización no implementa la configuración del nivel web.

    • Canalización: si la canalización es de implementación, puede ejecutar una fase de prueba. Marque las opciones que desee habilitar en esta fase. Si no se selecciona ninguna de las opciones, la fase de prueba no se muestra durante la ejecución de la canalización.

    Canalización de pila completa

  2. Haga clic en Guardar.

La canalización se guarda y ahora puede administrar las canalizaciones en la tarjeta Canalizaciones en la página Información general del programa.

Configuración de nivel web

Una canalización de configuración de nivel web implementa las configuraciones de HTTPD/Dispatcher. Consulte el documento Canalizaciones CI/CD para obtener más información sobre este tipo de canalización.

NOTA

Si ya existe una canalización de código de capa web para el entorno seleccionado, se desactivará esta selección.

Para finalizar la configuración de la canalización de no producción de código de capa web, siga estos pasos.

  1. En el Código fuente, debe definir las siguientes opciones.

    • Entornos de implementación aptos: si la canalización es una canalización de implementación, debe seleccionar a qué entornos debe implementar.
    • Repositorio: esta opción define desde qué repositorio de Git la canalización debe recuperar el código.
    SUGERENCIA

    Consulte el documento Adición y administración de repositorios para aprender a añadir y administrar repositorios en Cloud Manager.

    • Rama de Git: esta opción define desde qué rama de la canalización seleccionada debe recuperar el código.
    • Ubicación del código: esta opción define la ruta en la rama de la repo seleccionada desde la que la canalización debe recuperar el código.
      • Para las canalizaciones de configuración de nivel web, esta es normalmente la ruta que contiene los directorios conf.d, conf.dispatcher.d y opt-in.
      • Por ejemplo, si la estructura del proyecto se generó a partir del tipo de archivo del proyecto de AEM, la ruta sería /dispatcher/src.

    Canalización de niveles web

  2. Haga clic en Guardar.

NOTA

Si tiene una canalización de pila completa existente implementando en un entorno, al crear una canalización de configuración de capa web para el mismo entorno, se omitirá la configuración de capa web existente en la canalización de pila completa.

La canalización se guarda y ahora puede administrar las canalizaciones en la tarjeta Canalizaciones en la página Información general del programa.

Desarrollo de Sites con la canalización front-end

Con las canalizaciones front-end, se da más independencia a los desarrolladores de front-end y el proceso de desarrollo se puede acelerar.

Consulte el documento Desarrollar Sites con la canalización front-end para saber cómo funciona este proceso, así como algunas consideraciones que deben tenerse en cuenta para aprovechar al máximo este proceso.

Omitir paquetes de Dispatcher

Si desea que los paquetes de Dispatcher se creen como parte de la canalización, pero no desea que se publiquen para crear almacenamiento, puede desactivar la publicación, lo que puede reducir la duración de la ejecución de la canalización.

La siguiente configuración para deshabilitar la publicación de paquetes de Dispatcher debe agregarse a través del archivo pom.xml del proyecto. Se basa en una variable de entorno, que sirve como un indicador que puede establecer en el contenedor de compilación de Cloud Manager para definir cuándo se deben ignorar los paquetes de Dispatcher.

<profile>
  <id>only-include-dispatcher-when-it-isnt-ignored</id>
  <activation>
    <property>
      <name>env.IGNORE_DISPATCHER_PACKAGES</name>
      <value>!true</value>
    </property>
  </activation>
  <modules>
    <module>dispatcher</module>
  </modules>
</profile>

En esta página