Adición de una canalización que no es de producción configuring-non-production-pipelines
Después de configurar un programa y crear al menos un entorno en la interfaz de usuario de Cloud Manager, puede agregar canalizaciones que no sean de producción. Estas canalizaciones le permiten probar la calidad del código antes de implementarlo en entornos de producción.
Un usuario debe tener la función Administrador de implementación para configurar canalizaciones que no sean de producción.
Adición de una canalización que no es de producción
Después de configurar un programa y crear al menos un entorno en la interfaz de usuario de Cloud Manager, puede agregar canalizaciones que no sean de producción. Utilice estas canalizaciones para probar la calidad del código antes de implementarlo en entornos de producción.
Para agregar una nueva canalización que no sea de producción:
-
Inicie sesión en Cloud Manager en experience.adobe.com.
- En la sección Acceso rápido, haga clic en Experience Manager.
- En el panel izquierdo, haga clic en Cloud Manager.
-
En Cloud Manager, cerca de la esquina superior derecha de la página, seleccione la organización que desee utilizar.
-
En la consola Mis programas, haga clic en un programa.
-
En el panel lateral izquierdo, haga clic en Canalizaciones.
-
En la página Canalizaciones, cerca de la esquina superior derecha, haga clic en Agregar canalización > Agregar canalización que no sea de producción.
-
En la ficha Configuración del cuadro de diálogo Agregar canalización que no sea de producción, seleccione una de las siguientes canalizaciones que no sean de producción que desee crear:
- Canalización de calidad de código: crea una canalización que crea el código en una rama GIT, ejecuta pruebas unitarias y evalúa la calidad del código sin implementarlo en un entorno.
- Canalización de implementación: crea una canalización que genera el código, ejecuta pruebas unitarias, evalúa la calidad del código y se implementa en un entorno que no es de producción.
-
En la sección Configuración de canalización, en el campo Nombre de canalización que no es de producción, escriba una descripción para la canalización que no es de producción.
-
En la sección Opciones de implementación, seleccione uno de los siguientes déclencheur de implementación que desee usar:
- Manual: Le permite iniciar manualmente la canalización.
- Cambios en Git: Inicia la canalización cuando se añaden confirmaciones a la rama de Git configurada. Con esta opción, aún puede iniciar la canalización manualmente, según sea necesario.
-
Seleccione el Comportamiento de errores de métricas importantes que desee usar.
- Preguntar cada vez: esta es la configuración predeterminada y requiere intervención manual en caso de que se produzca algún error importante.
- Fallo inmediatamente: si se selecciona, la canalización se cancela siempre que se produzca un fallo importante. Emula a un usuario que rechaza manualmente cada error.
- Continuar inmediatamente: si se selecciona, la canalización se ejecuta automáticamente cada vez que se produce un error importante. Emula a un usuario que aprueba manualmente cada error.
-
Haga clic en Continuar.
-
Los pasos restantes que utilice para completar la configuración de la canalización que no sea de producción dependen del tipo de código fuente que elija utilizar.En la ficha Código Source del cuadro de diálogo Agregar canalización que no sea de producción, seleccione el tipo de código que procesa la canalización que no es de producción.
Consulte Canalizaciones de CI/CD para obtener más información sobre los tipos de canalizaciones.
Estoy utilizando código de pila completa
Una canalización de código de pila completa implementa simultáneamente generaciones de código back-end y front-end que contienen una o más aplicaciones de servidor de AEM junto con la configuración HTTPD/Dispatcher.
Para finalizar la configuración de la canalización de no producción de código de pila completa, haga lo siguiente:
-
En la sección Código Source, defina las siguientes opciones.
-
Entornos de implementación aptos: solo disponible cuando edita una canalización que no es de producción. Si la canalización es una canalización de implementación, seleccione los entornos a los que se implementa.
-
Repositorio: en la lista desplegable, elija el repositorio Git que la canalización usa como origen. Cloud Manager genera código a partir del repositorio que elija aquí.
note tip TIP Consulte Adición y administración de repositorios para poder aprender a añadir y administrar repositorios en Cloud Manager. -
Rama de Git: en la lista desplegable, elija la rama del repositorio seleccionado desde la que se genera la canalización. El valor predeterminado es
main. La canalización utiliza la rama elegida como origen para la compilación y la implementación. Si es necesario, haga clic en Actualizar para actualizar la lista de ramas disponibles para el repositorio seleccionado. Utilice esta opción si una rama creada recientemente no aparece en la lista. -
Estrategia de compilación
-
Compilación completa: genera todos los módulos del repositorio cada vez
-
Smart Build: genera solo módulos que han cambiado desde la última confirmación.
Obtenga más información acerca de cómo usar Smart Build en una canalización que no es de producción.note NOTE La generación inteligente está disponible para canalizaciones de calidad de código y todas las canalizaciones de implementación de pila completa (Desarrollo, Ensayo, Producción).
-
-
Ignorar configuración de nivel web: cuando está marcada, la canalización no implementa la configuración del nivel web.
-
-
En la sección Canalización, si la canalización es una canalización de implementación, puede elegir 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.
- Prueba funcional del producto - Ejecute pruebas funcionales del producto en el entorno de desarrollo.
- Pruebas funcionales personalizadas - Ejecute pruebas funcionales personalizadas en el entorno de desarrollo.
- Pruebas de IU personalizadas - Ejecutar pruebas de IU personalizadas para aplicaciones personalizadas.
- Auditoría de experiencias - Ejecutar Auditoría de experiencias
-
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.
Estoy utilizando la implementación dirigida targeted-deployment
Una implementación de destino implementa código solo para partes seleccionadas de la aplicación de AEM. En una implementación de este tipo, puede elegir Incluir uno de los siguientes tipos de código:
-
Código front-end: configure JavaScript y CSS para el front-end de su aplicación AEM.
- 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 Desarrollo de sitios 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.
-
Configuración de nivel web: configure las propiedades de Dispatcher para almacenar, procesar y entregar páginas web al cliente.
-
Consulte el documento Canalizaciones de CI/CD para obtener más información.
-
Si existe una canalización de código de nivel web para el entorno seleccionado, esta selección está deshabilitada.
-
Si una canalización de pila completa ya se implementa en un entorno, aún puede crear una canalización de configuración de capa web para ese mismo entorno. Cuando lo haga, Cloud Manager ignorará la configuración del nivel web en la canalización de pila completa.
note NOTE Las canalizaciones de configuración de nivel web no son compatibles con los repositorios privados. Consulte Agregar repositorios privados en Cloud Manager para obtener detalles y la lista completa de limitaciones.
-
-
En la sección Código Source, defina las siguientes opciones:
-
Repositorio: esta opción define el repositorio GIT desde el que la canalización que no es de producción recupera el código.
note tip TIP Consulte Adición y administración de repositorios para poder aprender a añadir y administrar repositorios en Cloud Manager. -
Rama Git: esta opción define la rama desde la que la canalización seleccionada recupera el código. Introduzca los primeros caracteres del nombre de la rama y utilice la función de autocompletar de este campo. Encuentra las ramas coincidentes que puede seleccionar.
-
Ubicación del código: esta opción define la ruta en la rama del repositorio seleccionado desde la que la canalización recupera el código.
-
-
Si habilitaste la auditoría de experiencias, haz clic en Continuar para avanzar a la pestaña Auditoría de experiencias. Defina las rutas que siempre se incluyen en la auditoría de experiencias.
- Si habilitó Auditoría de experiencias, consulte el documento Auditoría de experiencias para obtener detalles sobre cómo configurar.
- Si no lo ha hecho, omita este paso.
-
Haga clic en Guardar para guardar la canalización.
La canalización se guarda y ahora puede administrar las canalizaciones en la tarjeta Canalizaciones en la página Información general del programa.
Acerca del uso de Smart Build en la canalización about-smart-build-non-production-pipeline
Smart Build en Cloud Manager es una estrategia de compilación optimizada para canalizaciones que no son de producción. La versión inteligente reduce los tiempos de compilación al almacenar en caché los módulos y reconstruir solo los módulos que han cambiado desde la última ejecución correcta. Los módulos no modificados se reutilizan desde la caché, mientras que solo se reconstruyen los módulos modificados y sus dependencias, lo que mejora la eficacia de los flujos de trabajo de desarrollo iterativos.
Actualmente, Smart Build solo está disponible para lo siguiente:
- Código de calidad de las canalizaciones.
- Desarrollo de canalizaciones de implementación de pila completa.
- Canalizaciones de implementación de pila completa de fase y producción
Se recomienda Smart Build cuando se dispone de lo siguiente:
- Está desarrollando y comprometiendo activamente cambios incrementales frecuentes.
- El proyecto contiene varios módulos Maven.
- Las compilaciones completas están tardando un tiempo considerable.
Smart Build no siempre es ideal cuando se tiene lo siguiente:
- Su compilación se basa en gran medida en complementos que realizan operaciones fuera del gráfico de dependencias de Maven.
- Se requiere una validación de regeneración completa en cada ejecución.
Comprender el rendimiento de compilación smart-build-performance
La mejora del rendimiento obtenida mediante el uso de Smart Build depende de varios factores, entre los que se incluyen los siguientes:
- Número de módulos del proyecto.
- La frecuencia y el ámbito del código cambian.
- La distribución de dependencias entre módulos.
Los proyectos con muchos módulos independientes son los que ven la mayor mejora.
Exclusión de caché por módulo smart-build-cache-optout
Smart Build proporciona un control detallado que le permite deshabilitar el almacenamiento en caché para módulos específicos. Esta capacidad es útil cuando se utilizan ciertos módulos:
- Use complementos, como
exec-maven-pluginomaven-antrun-plugin. - Realizar operaciones de archivo no rastreadas por dependencias de Maven.
- El contenido almacenado en caché produce resultados incoherentes.
Deshabilitar el almacenamiento en caché de un módulo smart-build-disable-caching
Puede agregar la siguiente propiedad al pom.xml del módulo afectado:
<properties>
<maven.build.cache.enabled>false</maven.build.cache.enabled>
</properties>
Esta configuración requiere que el módulo se reconstruya en cada ejecución de canalización, mientras que otros módulos siguen beneficiándose del almacenamiento en caché.
Limitaciones y consideraciones al utilizar Smart Build smart-build-limitations
Tenga en cuenta lo siguiente al utilizar Smart Build:
- La generación inteligente se basa en el análisis de dependencias de Maven.
- Los cambios fuera del gráfico de dependencias no almacenan en déclencheur las regeneraciones.
- Algunos complementos no son totalmente compatibles con el almacenamiento en caché.
- Puede volver a Compilación completa en cualquier momento editando la canalización que no sea de producción.
Si encuentra un comportamiento de compilación inesperado, considere la posibilidad de deshabilitar el almacenamiento en caché para módulos específicos o cambiar temporalmente su estrategia de compilación a Compilación completa.
Solución de problemas de Smart Build smart-build-troubleshoot
· Compruebe el comportamiento de los complementos (especialmente los complementos
exec/antrun).· Compruebe si la mayoría de los módulos cambian con frecuencia.
· Use Compilación completa para la verificación.
Consulte Agregar una canalización que no sea de producción para habilitar Smart Build.
Excluir paquetes de Dispatcher exclude-dispatcher-packages
Si desea que los paquetes de Dispatcher se creen en su canalización pero no se carguen en el almacenamiento de la compilación, deshabilite la publicación. Esta configuración puede acortar el tiempo de ejecución de la canalización.
Para deshabilitar la publicación de paquetes de Dispatcher, agregue la configuración siguiente al archivo del proyecto pom.xml. Establezca una variable de entorno en el contenedor de compilación de Cloud Manager para marcar cuándo se deben ignorar los paquetes de Dispatcher. La canalización lee este indicador e ignora en consecuencia.
<profile>
<id>only-include-dispatcher-when-it-isnt-ignored</id>
<activation>
<property>
<name>env.IGNORE_DISPATCHER_PACKAGES</name>
<value>[!NOTE]rue</value>
</property>
</activation>
<modules>
<module>dispatcher</module>
</modules>
</profile>