AEM as a Cloud Service Developer Console developer-console
AEM as a Cloud Service Developer Console incluye un conjunto de herramientas de solo lectura para depurar entornos de nube. Se puede acceder a él a través de un vínculo por entorno en Cloud Manager y ofrece funciones para ver paquetes, configuración de OSGi, servicios y servlets, etc.
- AEM Developer Console (Cloud Service) no debe confundirse con Adobe Developer Console con un nombre similar.
Acceso a AEM Developer Console
Para acceder y utilizar AEM Developer Console, se deben otorgar los siguientes permisos al Adobe ID del desarrollador a través de Admin Console de Adobe.
- Asegúrese de que en el conmutador de organización de Adobe pueda ver la organización de Adobe relacionada con los entornos que desea inspeccionar en AEM Developer Console.
- Para poder iniciar sesión en AEM Developer Console, el desarrollador debe ser miembro de cualquiera de las siguientes funciones:
+ Desarrollador del producto Cloud Manager - Perfil del producto Cloud Service: En este caso, el desarrollador verá la lista completa de entornos disponibles en la URL de AEM Developer Console seleccionada; si se ha seleccionado un entorno de desarrollo o RDE en Cloud Manager, puede que aparezcan otros entornos de desarrollo o RDE en el mismo programa.
+ Perfil de producto de Administradores de AEM en Autor de AEM: En este caso, la lista de entornos descritos en la viñeta anterior se limitará a los perfiles de producto relacionados donde se asigna este rol. - El desarrollador debe ser miembro del perfil de producto Usuarios de AEM o Administradores de AEM en AEM Author y/o Publish.
+ Si esta pertenencia no existe, los volcados status agotarán el tiempo de espera con un error 401 no autorizado.
Borre las cookies del explorador y el estado de la aplicación (almacenamiento local) y vuelva a iniciar sesión en AEM Developer Console
Solución de problemas del acceso a AEM Developer Console
Al iniciar sesión, no veo el entorno que estoy buscando en la lista
Asegúrese de lo siguiente:
+ Ha seleccionado la URL correcta de AEM Developer Console haciendo clic en los tres puntos del entorno seleccionado a través de Cloud Manager y seleccione AEM Developer Console.
+ O bien tiene Desarrollador del producto Cloud Manager - Perfil del producto Cloud Service🔗 para ver la lista completa de entornos, o bien forma parte del perfil del producto Administradores de AEM en Autor de AEM para el entorno que no encuentra.
401 Error no autorizado al descargar el estado
Para resolver el problema no autorizado:
- Asegúrese de que el usuario sea miembro del perfil de producto de Adobe IMS correspondiente (administradores de AEM o usuarios de AEM) para la instancia de producto de AEM as a Cloud Service asociada a AEM Developer Console.
+ Recuerde que las instancias de producto AEM Developer Console acceden a 2 instancias de producto Adobe IMS; las instancias de producto AEM as a Cloud Service Author y Publish, por lo que debe asegurarse de que se utilizan los perfiles de producto correctos según el nivel de servicio que requiera acceso a través de AEM Developer Console. - Espere hasta 30 minutos para que la suscripción al Perfil del producto de Adobe IMS se sincronice con AEM as a Cloud Service.
- Inicie sesión en AEM as a Cloud Service (Autor o Publicación) y asegúrese de que los usuarios y grupos se hayan sincronizado correctamente con AEM.
+ AEM Developer Console requiere que se cree su registro de usuario en el nivel de servicio de AEM correspondiente para que se autentique en ese nivel de servicio. - Borre las cookies de su explorador, así como el estado de la aplicación (almacenamiento local) y vuelva a iniciar sesión en AEM Developer Console, asegurándose de que el token de acceso que utiliza AEM Developer Console sea correcto y no haya caducado.
Restricciones de IP ip-restrictions
El acceso a Developer Console depende de la capacidad para llegar a la instancia de autor. Si su organización ha configurado una lista de permitidos IP en el servicio de autor en Cloud Manager, debe conectarse desde una dirección IP dentro de ese intervalo permitido.
Por ejemplo, si la instancia de autor está restringida a su VPN corporativa, solo puede utilizar la Developer Console mientras está conectado a esa VPN.
Navegar a Developer Console
Se accede a Developer Console por entorno de AEM as a Cloud Service a través de Cloud Manager.
- Vaya a Cloud Manager
- Abra el Programa que contiene el entorno de AEM as a Cloud Service para abrir Developer Console.
- Busque Entorno y seleccione
.... - Seleccione Developer Console de la lista desplegable.
O abra esta dirección URL para iniciar sesión: https://experience.adobe.com/skyline-console
O utilice este comando de la CLI de Cloud Manager:
aio cloudmanager:open-developer-console <ENVIRONMENTID> --programId <PROGRAMID>
Selector de entorno/programa
Para utilizar AEM Developer Console, debe seleccionar el entorno y el programa que desea inspeccionar.
Los selectores se encuentran en la esquina superior izquierda y derecha de la interfaz de usuario de AEM Developer Console.
Si se selecciona un entorno, se almacenará en déclencheur una actualización de los datos en AEM Developer Console y se verán los datos del entorno seleccionado.
Al ir al explorador del repositorio, el entorno seleccionado se utilizará para abrir el explorador del repositorio en una nueva pestaña.
Los botones de actualización junto a los selectores almacenan en déclencheur una memoria caché del explorador para borrar las llamadas de programas o entorno a Cloud Manager.
Puede utilizarlo si se ha creado un entorno nuevo y no lo ve en la lista de entornos.
Todavía pueden pasar unos minutos hasta que el nuevo entorno esté disponible en AEM Developer Console.
Las luces de estado indican la salud del medio ambiente.
- Rojo: indica que el entorno no está en buen estado y no está disponible (posiblemente en hibernación).
- Naranja: es posible que el entorno se esté reiniciando o degradando (algunos de los pods están temporalmente inactivos, pero aún hay pods en buen estado disponibles).
- Verde: En marcha, todos los pods están en pie y saludables
Una vez seleccionado un entorno, puede utilizar las pestañas para navegar a las diferentes vistas de AEM Developer Console.
Puede ver el estado de cada nivel del entorno.
Paquetes OSGi
- Una descripción general de los paquetes OSGI implementados en el tipo de entorno seleccionado. Permite una búsqueda de texto completo.
- Es útil obtener información sobre el estado real de los paquetes en el entorno. Puede obtener información como paquetes exportados, paquetes importados, servicios utilizados y más.
- Los desarrolladores quieren verificar el entorno real y comprobar si el paquete hace lo que esperan que haga.
- Ejemplo de caso de uso: Se ha especificado un intervalo de versiones de una dependencia en el paquete. Algo va mal en la dependencia. Desea comprobar qué versión de la dependencia se está cableando en el paquete. Para comprobarlo, vaya a los detalles del paquete y utilice la importación de paquetes/paquetes para comprobar qué versión del paquete o versión del paquete se está utilizando en el tiempo de ejecución. Con esta información, puede ajustar el intervalo de versiones de dependencia de Maven o adaptar el código.
Para buscar, utilice la barra de búsqueda. Para descargar la lista de paquetes como json, haga clic en el botón Descargar lista en la parte superior derecha para obtener un volcado JSON completo.
Si desea obtener el volcado de publicación o vista previa, puede utilizar el selector de entorno para seleccionar el entorno de publicación o vista previa y, a continuación, descargar la lista.
Paquetes Java
Los paquetes Java se utilizan para solucionar problemas cuando los paquetes no se inician debido a importaciones sin resolver o clases sin resolver en scripts (HTL, JSP, etc.). Si los paquetes Java informan de que no hay paquetes que exporten un paquete Java (o la versión no coincide con la importada por un paquete OSGi):
+ Asegúrese de que la versión de la dependencia Maven de la API de AEM de su proyecto coincida con la versión de la versión de AEM del entorno (y, si es posible, actualice todo a la última).
+ Si se utilizan dependencias Maven adicionales en el proyecto Maven
+ Determine si se puede utilizar una API alternativa proporcionada por la dependencia de la API de AEM SDK en su lugar.
+ Si se requiere la dependencia adicional, asegúrese de que se proporcione como un paquete OSGi (en lugar de como un Jar sin formato) y de que esté incrustado en el paquete de código del proyecto, (ui.apps), de forma similar a como está incrustado el paquete OSGi principal en el paquete ui.apps.
Al hacer clic en un paquete, se accede a los detalles del mismo:
Configuraciones configurations
- Una lista de configuraciones activa en el entorno en la que se pueden buscar. Puede ver qué propiedades proporcionan las configuraciones desprotegiendo la página de detalles.
- Ejemplo de caso de uso: Un desarrollador desea asegurarse de que las configuraciones que especificó estén realmente presentes en el entorno. Si falta la configuración, pueden comprobar el modelo de funciones o el modo de ejecución o la carpeta de configuración.
Para obtener más información sobre cómo configurar permisos de usuario, consulte Documentación de Cloud Manager.
Servlets servlets
- Un mensaje de búsqueda en el que se puede especificar una ruta con selectores y una extensión con GET o POST. A continuación, proporciona los resultados de los servlets en orden de preferencia que administra la solicitud en Sling.
- Ejemplo de caso de uso: Tiene un servlet OSGI que debe activarse tras una solicitud e imprimirse en la respuesta. Sin embargo, en lugar del resultado esperado, la respuesta devuelve empty. Debe comprobar si algún otro servlet tiene prioridad sobre el servlet debido a selectores,
resourceType, extensiones o clasificación más específicos. Busca la ruta esperada y descubre que hay otro servlet activo con una clasificación más alta. A continuación, decida si puede colocar el servlet por encima en la clasificación añadiendo selectores, por ejemplo.
Servicios services
Componentes enumera todos los servicios OSGi.
Los servicios OSGi ayudan en la depuración al:
+ Enumerar todos los servicios OSGi en AEM, junto con su paquete OSGi proporcionado y todos los paquetes OSGi que lo consumen
Componentes OSGi osgi-components
Los componentes ayudan en la depuración al:
+ Enumeración de todos los componentes OSGi implementados en AEM as a Cloud Service
+ Proporcionar el estado de cada componente OSGi; incluso si están activos o no satisfechos
+ Proporcionar detalles sobre referencias de servicio no satisfechas puede provocar que los componentes OSGi se activen
+ Enumerar las propiedades OSGi y sus valores enlazados al componente OSGi.
+ Esto mostrará los valores reales insertados a través de variables de configuración de entorno OSGi.
Integraciones integrations
- Los administradores del sistema pueden generar, cambiar el nombre y eliminar credenciales de servicio y tokens de desarrollador.
- Encontrará más información al respecto aquí: Generación de tokens de acceso para las API del servidor.
Repositorio repository
- Abre el Explorador del repositorio.
- Aviso: Deberá poder iniciar sesión en el servicio de AEM para acceder al explorador del repositorio. Si no puede iniciar sesión, póngase en contacto con el administrador del sistema para obtener acceso.
- Necesita acceso concedido en el nivel al que intenta acceder. Por ejemplo, si intenta acceder al explorador del repositorio en el nivel de publicación, debe tener acceso (administrador de AEM o usuario de AEM) concedido en el nivel de publicación.
Volcados de estado/Consultas status-dumps-queries
- Un volcado de texto completo o JSON del estado actual de paquetes, paquetes, configuraciones, servicios, componentes, trabajos de Sling o definiciones de Oak.
- Resulta útil, especialmente si el desarrollador ha descubierto algún estado inesperado y desea comunicar o documentar este estado para otros desarrolladores. Al descargar el volcado, se obtiene una instantánea del estado para consultarlo más adelante.
Trabajos de Sling
Trabajos de Sling enumera todas las colas de trabajos de Sling.
Los trabajos de Sling ayudan en la depuración al:
+ Lista de colas de trabajos de Sling y sus configuraciones
+ Proporcionar información sobre el número de trabajos de Sling activos, en cola y procesados, lo que resulta útil para depurar problemas con el flujo de trabajo, el flujo de trabajo transitorio y otro trabajo realizado por los trabajos de Sling en AEM.
Definiciones de Oak
Los índices Oak proporcionan un volcado de los nodos definidos debajo de /oak:index. Tenga en cuenta que esto no muestra índices combinados, lo que ocurre cuando se modifica un índice AEM.
Los índices Oak ayudan en la depuración al:
+ Enumeración de todas las definiciones de índice de Oak que proporcionan información sobre cómo se ejecutan las consultas de búsqueda en AEM. Tenga en cuenta que las modificaciones en los índices AEM no se reflejan aquí. Esta vista solo es útil para índices que solo proporciona AEM o que solo proporciona el código personalizado.
Herramienta de rendimiento de consultas
- Las consultas ayudan a proporcionar información sobre qué y cómo se ejecutan las consultas de búsqueda en AEM.
- Las consultas solo funcionan cuando se selecciona un pod específico, ya que abre la consola web de rendimiento de las consultas de ese pod, lo que requiere que el desarrollador tenga acceso para iniciar sesión en el servicio de AEM.
Las consultas ayudan a depurar:
+ Explicar cómo Oak interpreta, analiza y ejecuta las consultas. Esto es muy importante a la hora de rastrear por qué una consulta es lenta y comprender cómo se puede acelerar.
+ Enumeración de las consultas más populares que se ejecutan en AEM, con la capacidad de Explicarlas.
+ Enumeración de las consultas más lentas que se ejecutan en AEM, con la capacidad de Explicarlas.
Encontrará más documentación aquí.