Funciones de Edge de AEM aem-edge-functions

AEM Edge Functions le permite ejecutar JavaScript en la capa de CDN, lo que acerca el procesamiento de datos al usuario final. Esto reduce la latencia y permite experiencias dinámicas y adaptables sin necesidad de realizar un viaje de ida y vuelta al origen.

Los casos de uso comunes incluyen los siguientes:

AEM Edge Functions es compatible tanto con Edge Delivery Services como con la pila Java de AEM as a Cloud Service.

Principales ventajas key-benefits

Requisitos previos prerequisites

Configuración setup

Instalación de la CLI de Adobe install-adobe-cli

Instale la CLI de Adobe Developer (aio):

npm install -g @adobe/aio-cli

Instale el complemento Funciones de AEM Edge:

aio plugins install @adobe/aio-cli-plugin-aem-edge-functions

Autentique y configure el complemento para su entorno:

aio login
aio aem edge-functions setup

El comando setup le solicita que inicie sesión y, a continuación, seleccione el entorno de AEM en el que desea utilizar las funciones de Edge de AEM.

Clonar la plantilla boilerplate

Copie aem-edge-functions-boilerplate en su propio repositorio y luego instale las dependencias:

npm install

Creación de la primera función create-your-function

Los servicios de funciones de AEM Edge se declaran en un archivo de configuración de YAML y se implementan a través de la canalización de configuración de Cloud Manager.

​1. Configurar una canalización de configuración configuration-pipeline

Antes de crear una función perimetral, asegúrese de que exista una canalización de configuración para su entorno en Cloud Manager. Si no, cree primero una canalización de configuración.

​2. Declarar los servicios de función de Edge declare-services

Cree un archivo con el nombre edgeFunctions.yaml en el directorio de configuración:

kind: "EdgeFunctions"
version: "1"
data:
  services:
    - name: first-function
    - name: second-function
    # Uncomment to enable secrets
    # secrets:
    #   - key: API_TOKEN
    #     value: ${{ API_TOKEN_SECRET }}

La configuración admite hasta tres servicios. Las claves de nivel superior son:

​3. Agregar reglas de selector de origen de CDN cdn-routing

Las funciones de Edge se invocan enrutando el tráfico de CDN a ellas a través de reglas de selector de origen. Agregue lo siguiente al archivo de configuración cdn.yaml (o cree uno si no existe):

kind: 'CDN'
version: '1'
data:
  originSelectors:
    rules:
      - name: route-to-first-function
        when: { reqProperty: path, equals: "/weather" }
        action:
          type: selectAemOrigin
          originName: edgefunction-first-function
      - name: route-to-second-function
        when: { reqProperty: path, equals: "/hello-world" }
        action:
          type: selectAemOrigin
          originName: edgefunction-second-function

Las reglas del selector de origen permiten dirigir el tráfico a las funciones perimetrales en función de cualquier condición disponible en el motor de reglas de CDN, como una ruta específica, un dominio o un encabezado de solicitud. Consulte Selectores de origen para obtener la sintaxis completa de la regla.

​4. Implementar la configuración deploy-configuration

Confirme tanto edgeFunctions.yaml como cdn.yaml a su repositorio Git de Cloud Manager y almacene en déclencheur la canalización de configuración. Una vez que la canalización se complete correctamente, los puntos finales de la función Edge estarán disponibles en:

donde pXXXXX-eYYYYY son las coordenadas de entorno. Si se configura un dominio personalizado, también se puede acceder a las funciones en esas rutas de dominio (por ejemplo, example.com/weather).

Generar e implementar el código de función de AEM Edge build-deploy

Generar build

Empaquete el código de función perimetral para la implementación:

aio aem edge-functions build

Implementación deploy

Implemente el paquete creado en un servicio de función perimetral con nombre. El argumento function-name debe coincidir con el valor name de edgeFunctions.yaml:

aio aem edge-functions deploy <function-name>

Desarrollo local local-development

Ejecutar localmente local-run

Iniciar un servidor de desarrollo local en http://127.0.0.1:7676:

aio aem edge-functions serve

Consulte esta Documentación de cómputo de JavaScript para obtener detalles sobre lo que admite el tiempo de ejecución local.

Prueba test

Ejecute el grupo de pruebas con Mocha:

npm run test

Depuración remota remote-debugging

La CDN administrada por Adobe no expone un depurador remoto, pero sí un flujo de registro. Siga los registros de una función implementada para recibir la salida console.log directamente en el terminal:

aio aem edge-functions tail-logs <function-name>

Almacenamiento en caché y depuración de caché caching

Las funciones de Edge pueden reducir significativamente la carga de origen y mejorar los tiempos de respuesta al almacenar en caché los datos en el perímetro de. Sin embargo, el almacenamiento en caché requiere un diseño intencional, especialmente en las funciones de Edge en las que hay dos capas de caché independientes implicadas:

Browser → AEM CDN (CDN Cache) → AEM Edge Functions (Fetch Cache) → Backend (AEM, APIs, etc.)

Antes de configurar el almacenamiento en caché, considere cómo se comporta su contenido:

Dado que la CDN y la caché de recuperación interna de la función Edge funcionan de forma independiente, un cambio en los datos subyacentes requiere la invalidación deliberada de ambas capas. Comprender esta arquitectura es esencial para una administración fiable de la caché.

Para obtener instrucciones técnicas detalladas sobre la configuración del comportamiento del almacenamiento en caché, el control de la duración de la caché, el uso de claves de sustitución y la depuración del contenido almacenado en caché, consulte Almacenamiento en caché en las funciones de Edge de AEM.

Limitaciones limitations

Cada invocación de función de Edge se ejecuta dentro de una zona protegida con límites de recursos impuestos por la plataforma de cálculo subyacente.

Máximo de llamadas de recuperación salientes por invocación max-fetch-calls

Las funciones de AEM Edge aplican un límite estricto de 32 solicitudes back-end por ejecución (es decir, por cada solicitud entrante gestionada por su función). Una vez alcanzado este límite, cualquier llamada adicional de fetch() genera el siguiente error:

Requested backend named '…' does not exist

Cuando vea este error y la configuración de origen sea correcta, la causa más probable es que se haya agotado la cuota de solicitudes back-end por invocación. Consulte Límites de recursos de Fastly Compute para obtener la lista completa de límites de plataforma.

Referencia de configuración configuration-reference

Orígenes origins

De forma predeterminada, las funciones de Edge pueden recuperarse de cualquier origen. Para restringir una función a un conjunto definido de orígenes, declárelos en origins en edgeFunctions.yaml:

origins:
  - name: my-origin-name
    domain: example.com

Haga referencia al origen con nombre en el código de función mediante la opción de captura backend:

const request = new Request("https://example.com/test");
const response = await fetch(request, { backend: "my-origin-name" });

Configuración de servicio service-configuration

Exponga las variables de entorno a sus funciones usando la clave configs en edgeFunctions.yaml. Los valores se almacenan en un almacén de configuración denominado config_default:

configs:
  - key: LOG_LEVEL
    value: DEBUG

Lea los valores de configuración en el código de función:

import { ConfigStore } from "fastly:config-store";

const config = new ConfigStore('config_default');
const logLevel = config.get('LOG_LEVEL') || 'info';

Secretos de servicio service-secrets

Se hace referencia a los secretos, no se almacenan, en edgeFunctions.yaml. El campo value debe señalar a un secreto de Cloud Manager mediante la sintaxis ${{SECRET_REFERENCE}}. Defina primero el secreto subyacente en Cloud Manager; consulte Variables secretas de Cloud Manager.

secrets:
  - key: API_TOKEN
    value: ${{ API_TOKEN_SECRET }}

Recupere secretos en su código de función utilizando el asistente SecretStoreManager de la plantilla:

import { SecretStoreManager } from "./lib/config";

const apiToken = await SecretStoreManager.getSecret('API_TOKEN');

Registro logging

Las funciones de AEM Edge se integran con la función Reenvío de registros de AEM. Crear un archivo de logForwarding.yaml junto con su edgeFunctions.yaml:

kind: "LogForwarding"
version: "1"
metadata:
  envTypes: ["rde", "dev", "stage", "prod"]
data:
  splunk:
    default:
      enabled: true
      host: "splunk-host.example.com"
      token: "${{SPLUNK_TOKEN}}"
      index: "AEMaaCS"

Utilice el registrador en el código de función para escribir entradas de registro estructuradas:

import { Logger } from "fastly:logger";

const logger = new Logger("customerSplunk");
logger.log(JSON.stringify({
  method: event.request.method,
  url: event.request.url
}));