Prácticas recomendadas para la configuración y el uso de AEM GraphQL con fragmentos de contenido best-practices-setup-use-aem-graphql-content-fragments
Estas directrices resumen las prácticas recomendadas para configurar y utilizar AEM con GraphQL y fragmentos de contenido.
Introducción getting-started
Para ayudarle a ponerse al día:
- ¿Qué es sin encabezado?
- Información general sobre los distintos entornos de la arquitectura de AEM
Configuración setup
Para configurar de forma segura AEM GraphQL para utilizarlo con fragmentos de contenido y sus aplicaciones, debe configurar varios componentes.
Creación de extremos de GraphQL (incluida la seguridad) graphql-endpoint-creation
El punto de conexión es la ruta utilizada para acceder a GraphQL para AEM. Estos extremos deben crearse y publicarse para que se pueda acceder a ellos de forma segura.
Detalles details-graphql-endpoint-creation
Administración de puntos de conexión de GraphQL en AEM
Entornos environments-graphql-endpoint-creation
Los extremos deben configurarse en:
- Autor
- Vista previa
- Publicación
Para:
- Desarrollo
- Pruebas
- Producción
Almacenamiento en caché de AEM Dispatcher dispatcher-caching
El almacenamiento en caché de consultas persistentes no está habilitado de forma predeterminada en Dispatcher. La activación predeterminada no es posible, ya que los clientes que utilizan CORS (Intercambio de recursos de origen cruzado) con varios orígenes deben revisar, y posiblemente actualizar, su configuración de Dispatcher.
Detalles details-dispatcher-caching
Consultas persistentes de GraphQL: habilitar el almacenamiento en caché en Dispatcher
Entornos environments-dispatcher-caching
Dispatcher suele estar configurado para lo siguiente:
- Publicar: producción
Configuración de CORS cors-setup
Para acceder al punto de conexión de GraphQL, se debe configurar una política CORS y añadirla a un proyecto de AEM que se implemente en AEM a través de Cloud Manager. Para ello, añada un archivo de configuración OSGi CORS apropiado para los puntos de conexión deseados.
Detalles details-cors-setup
Configuración de Intercambio de Recursos de Origen Cruzado (CORS)
Entornos environments-cors-setup
CORS suele estar configurado para:
- Publicar: producción
Autenticación authentication
Un caso de uso principal para la API de GraphQL de Adobe Experience Manager as a Cloud Service (AEM) para la entrega de fragmentos de contenido es aceptar consultas remotas desde aplicaciones o servicios de terceros. Estas consultas remotas pueden requerir acceso a una API autenticada para asegurar la entrega de contenido sin encabezado.
Detalles details-authentication
Autenticación para consultas de AEM de GraphQL remotas en fragmentos de contenido
Entornos environments-authentication
La autenticación suele configurarse para:
- Vista previa
- Publicación
Para:
- Desarrollo
- Pruebas
- Producción
Permisos permissions
Con una implementación sin encabezado, deben abordarse varias áreas de seguridad y permisos. Los permisos y los perfiles se pueden considerar en general, en función del entorno de AEM Creación o Publicación. Cada entorno contiene diferentes perfiles con distintas necesidades.
Detalles details-permissions
Consideraciones de permisos para contenido sin encabezado
Entornos environments-permissions
Los permisos suelen configurarse para:
- Autor
- Vista previa
- Publicación
Para:
- Desarrollo
- Pruebas
- Producción
Uso de una red de distribución de contenido (CDN) cdn
Las consultas GraphQL y sus respuestas JSON se pueden almacenar en caché si se dirigen como GET solicitudes al utilizar una CDN. Por el contrario, las solicitudes sin almacenar en caché pueden ser muy (recursos) costosas y lentas de procesar, con el potencial de tener más efectos perjudiciales en los recursos del origen.
Detalles details-cdn
Entornos environments-cdn
Una CDN suele configurarse para lo siguiente:
- Publicar: producción
Configurar y crear fragmentos de contenido cconfigure-create-content-fragments
AEM GraphQL se utiliza para recuperar información de los fragmentos de contenido. Deben configurarse y luego definirse una estructura y una ubicación para poder crear el contenido.
Detalles details-content-fragments
Entornos eenvironments-content-fragments
Los fragmentos de contenido se definen, crean, prueban, publican y acceden a ellos en:
- Autor
- Vista previa
- Publicación
Para:
- Desarrollo
- Pruebas
- Producción
Uso de AEM GraphQL use-aem-graphql
Optimización de las consultas de GraphQL optimize-graphql-queries
Estas directrices se proporcionan para ayudar a evitar problemas de rendimiento con las consultas de GraphQL.
Detalles details-optimize-graphql-queries
Optimización de consultas de GraphQL
Acceso a GraphQL desde sus aplicaciones access-graphql-from-your-apps
AEM sin encabezado CMS ofrece a los desarrolladores la libertad de crear y ofrecer experiencias excepcionales utilizando los lenguajes, marcos y herramientas con los que ya están familiarizados.
Detalles details-your-apps
- Instale y utilice AEM SDK para desarrollo
- Recursos para desarrolladores de AEM sin encabezado
- Ejemplos: React, Next.js, Node.js, entre otros
Entornos environments-your-apps
Las aplicaciones suelen desarrollarse, probarse y utilizarse en:
- Vista previa
- Publicación
Para:
- Desarrollo
- Pruebas
- Producción
Recursos adicionales
Para obtener más información sobre AEM GraphQL y los fragmentos de contenido, consulte lo siguiente: