Solucionar problemas de canalización de CI/CD mediante el agente de desarrollo de AEM
Obtenga información sobre cómo solucionar problemas y corregir una canalización de CI/CD que ha fallado mediante el Agente de desarrollo de AEM.
El Agente de desarrollo de AEM ayuda a equipos técnicos, incluidos desarrolladores, ingenieros de DevOps y administradores a acelerar sus flujos de trabajo al proporcionar orientación y acciones con tecnología de IA.
Información general
El Agente de desarrollo de AEM ofrece varias funciones, incluida la capacidad de enumerar, solucionar problemas y corregir canalizaciones de CI/CD fallidas. Puede invocar el agente de desarrollo de AEM a través del asistente de IA para abordar sus casos de uso específicos.
Este tutorial utiliza el Proyecto de sitios WKND para mostrar cómo solucionar problemas y corregir una canalización de CD/CI con errores mediante el Agente de desarrollo de AEM. Los mismos principios se aplican a cualquier proyecto de AEM.
Para simplificar, este tutorial presenta un error de prueba unitaria en el archivo BylineImpl.java para mostrar las capacidades de solución de problemas de canalización del Agente de desarrollo de AEM.
Requisitos previos
Para seguir este tutorial, necesita lo siguiente:
- Asistente de IA y agentes en AEM habilitados. Consulte Configurar IA en AEM para obtener más información y tenga en cuenta que los parques de reproducción mencionados en ese artículo no tendrán las capacidades del Agente de desarrollo de AEM.
- Acceso a Adobe Cloud Manager con un rol de Desarrollador o Administrador de programas. Consulte definiciones de funciones para obtener más información.
- Un entorno de AEM as a Cloud Service
- Acceso a agentes en AEM a través del programa Beta
- El proyecto de sitios WKND se clonó en el equipo local
Capacidades actuales de AEM Development Agent
Antes de sumergirse en el tutorial, vamos a revisar las capacidades actuales del Agente de desarrollo de AEM:
- Lista de canalizaciones de CI/CD y su estado
- Solucionar problemas y corregir canalizaciones full-stack con errores, incluidos los tipos Calidad del código y Implementación.
- Se admiten los pasos Build (compilación del código para producir un artefacto implementable) y Code Quality (análisis de código estático mediante reglas SonarQube) de las canalizaciones full-stack.
Las capacidades del Agente de desarrollo de AEM se amplían y actualizan continuamente de forma regular. Para recibir comentarios y sugerencias, envíe un correo electrónico a aem-devagent@adobe.com.
Configuración
Siga estos pasos de alto nivel para completar este tutorial:
- Clone el Proyecto WKND Sites y envíelo a su repositorio Git de Cloud Manager
- Creación y configuración de una canalización de calidad de código
- Ejecute la canalización y observe la ejecución fallida
- Utilice el Agente de desarrollo de AEM para solucionar problemas y corregir la canalización fallida
Veamos cada paso en detalle.
Uso del proyecto de WKND Sites como proyecto de demostración
Este tutorial utiliza la rama tutorial/dev-agent/unit-test-failure del proyecto WKND Sites para mostrar cómo utilizar el agente de desarrollo de AEM. Los mismos principios se pueden aplicar a cualquier proyecto de AEM.
-
Se ha introducido un error de prueba unitaria en el archivo
BylineImpl.javade la siguiente manera. Si utiliza su propio proyecto de AEM, puede producir un error de prueba unitaria similar.code language-java ... @Override public String getName() { if (name != null) { return "Author: " + name; // This line is intentionally incorrect to introduce a unit test failure. } return name; } ... -
Clone el Proyecto WKND Sites en su equipo local, vaya al directorio del proyecto y cambie a la rama
tutorial/dev-agent/unit-test-failure.code language-shell git clone https://github.com/adobe/aem-guides-wknd.git cd aem-guides-wknd git checkout tutorial/dev-agent/unit-test-failure -
Cree un nuevo repositorio Git de Cloud Manager para el proyecto WKND Sites y agréguelo como remoto al repositorio Git local:
-
Vaya a Adobe Cloud Manager y seleccione su programa.
-
Haga clic en Repositorios en la barra lateral izquierda.
-
Haga clic en Agregar repositorio en la esquina superior derecha.
-
Escriba un Nombre de repositorio (por ejemplo, "wknd-site-tutorial") y haga clic en Guardar. Espere a que se cree el repositorio.
-
Haga clic en Acceder a la info del repositorio en la esquina superior derecha y copie la URL del repositorio.
-
Añada el repositorio Git de Cloud Manager recién creado como remoto al repositorio Git local:
code language-shell git remote add adobe https://git.cloudmanager.adobe.com/<your-adobe-organization>/wknd-site-tutorial/
-
-
Inserte el repositorio Git local en el repositorio Git de Cloud Manager:
code language-shell git push adobeCuando se le soliciten credenciales, proporcione Nombre de usuario y Contraseña del modal Información del repositorio de Cloud Manager.
Creación y configuración de una canalización de calidad de código
Este tutorial utiliza una canalización de calidad del código (que no es de producción) para almacenar en déclencheur el error de la canalización para solucionar problemas. Consulte Introducción a las canalizaciones de CI/CD para obtener más información sobre las canalizaciones de calidad de código.
-
En Cloud Manager, vaya a la sección Canalizaciones y seleccione Agregar > Agregar canalización que no sea de producción.
-
En el cuadro de diálogo Agregar canalización que no sea de producción, configure lo siguiente:
-
Paso Configuración:
- Mantenga los valores predeterminados como Tipo de canalización como
Code Quality Pipeliney Déclencheur de implementación comoManual. - Para Nombre de canalización que no es de producción, escriba
Code Quality::Fullstack
- Mantenga los valores predeterminados como Tipo de canalización como
-
Paso Código Source:
- Seleccionar código de pila completa
- Para Repositorio, seleccione el repositorio Git de Cloud Manager recién creado
- Para Rama Git, seleccione
tutorial/dev-agent/unit-test-failure - Haga clic en Guardar.
-
-
Ejecute la canalización Calidad del código recién creada haciendo clic en Ejecutar en el menú de tres puntos de la entrada de la canalización.
Observe la ejecución de la canalización fallida
Error en la canalización Calidad del código del paso Preparación de artefactos:
Sin el Agente de desarrollo de AEM, este error de canalización requiere una solución de problemas manual. Un desarrollador tendría que comprobar los registros y revisar el código, un proceso tedioso y laborioso.
A continuación, verá cómo la inteligencia artificial aplicada a la actividad empresarial puede solucionar problemas y corregir la ejecución fallida de la canalización.
Usar el agente de desarrollo de AEM para solucionar problemas y solucionar errores de canalización
Puede invocar el Agente de desarrollo de AEM mediante el Asistente de IA en AEM, describiendo el error de canalización en lenguaje natural.
-
Haga clic en el icono Ayudante de IA en la esquina superior derecha.
-
Escriba los detalles del error de canalización en lenguaje natural conocido como Prompt. Por ejemplo:
code language-text I have a failed pipeline execution on %PROGRAM-NAME% program, help me to troubleshoot and fix it.
Agente de desarrollo de AEM se invoca para solucionar problemas y corregir la ejecución de la canalización con errores.
note note NOTE Si el mensaje introducido no está claro, el asistente de inteligencia artificial pide aclaraciones y proporciona información para ayudarle a refinar el mensaje. -
Una vez que finalice el razonamiento, haga clic en el icono Abrir en pantalla completa para ver el proceso detallado de solución de problemas.
Los resultados contienen información valiosa, incluidos detalles del error, el archivo de origen, el número de línea y una sección Cómo corregir con pasos claros para resolver el problema.
-
En este caso, el agente sugirió correctamente cambiar la implementación (
getName()método) o actualizar la prueba unitaria (getNameTest()método) para solucionar el problema. Evitó las alucinaciones y utilizó un enfoque de "ser humano en el bucle" mientras proporcionaba cambios de código procesables para el desarrollador.
-
Actualice el archivo
BylineImpl.javacon los cambios de código sugeridos, luego confirme e inserte los cambios en el repositorio Git de Cloud Manager.code language-java ... @Override public String getName() { return name; } ... -
Vuelva a ejecutar la canalización y observe la ejecución correcta.
Ejemplos adicionales
El proyecto de WKND Sites incluye ejemplos adicionales de código dañado y problemas de configuración, como dependencias que faltan y configuración incorrecta. Puede explorar estos ejemplos comprobando las ramas que comienzan con tutorial/dev-agent/. Para ver los cambios importantes, puede comparar la rama tutorial/dev-agent/unit-test-failure con la rama main haciendo clic en el botón Comparar. Luego busque la sección archivo modificado.
Vea también Ejemplos de mensajes para obtener más ideas sobre cómo usar el Agente de desarrollo de AEM.
Resumen
En este tutorial, ha aprendido a utilizar el Agente de desarrollo de AEM para solucionar problemas y corregir una canalización de CI/CD que ha fallado mediante el Asistente de IA. También ha aprendido cómo la inteligencia artificial aplicada a la actividad empresarial acelera los flujos de trabajo técnicos al proporcionar perspectivas procesables y cambios de código.
Empiece a utilizar el Agente de desarrollo de AEM y otros agentes en AEM para acelerar los flujos de trabajo. Vea Información general sobre los agentes en AEM para obtener más información.