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 nueva canalización que no es de producción adding-non-production-pipeline
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 experiece.adobe.com.
-
En la sección Acceso rápido, haga clic en Experience Manager.
-
En el panel lateral izquierdo, haga clic en Cloud Manager.
-
Seleccione la organización que desee.
-
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. Básicamente, emula a un usuario rechazando manualmente cada error.
- Continuar inmediatamente: si se selecciona, la canalización se ejecuta automáticamente cada vez que se produzca un error importante. Básicamente, emula al 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 qué tipo de código debe procesar la canalización que no sea 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 full-stack-code
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, debe seleccionar a qué entornos debe implementar.
-
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 desde qué rama del repositorio seleccionado se debe generar 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
-
BETA 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 important IMPORTANT La generación inteligente solo está disponible para canalizaciones de calidad de código y canalizaciones de implementación de código de pila completa de desarrollo.
-
-
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 ha guardado y ahora puede [administrar sus canalizaciones](canalización de administración)
lines.md) en la tarjeta Canalizaciones de 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 enviar 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 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 desde qué repositorio GIT la canalización que no es de producción debe recuperar 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 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. Encuentra las ramas coincidentes que puede 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.
-
-
Si habilitó la auditoría de experiencias, haga clic en Continuar para avanzar a la pestaña Auditoría de experiencias, donde puede definir las rutas que siempre se deben incluir 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 una canalización que no es de producció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.
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.
Generalmente, los proyectos con muchos módulos independientes pueden ver 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 sintaxis fuerza al módulo a reconstruir 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 pueden almacenar en déclencheur las regeneraciones.
- Es posible que algunos complementos no sean 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. Esto puede acortar el tiempo de ejecución de la canalización.
Agregue la siguiente configuración al archivo del proyecto pom.xml para deshabilitar la publicación de paquetes de Dispatcher. 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>