Estrategia de implementación de funciones de AEM Edge en Edge Delivery Services

IMPORTANT
Funciones de AEM Edge se encuentra en la versión beta. Las funciones y la documentación pueden cambiar. Para obtener comentarios, comuníquese con aemcs-edgecompute-feedback@adobe.com.

En Edge Delivery Services, una función de AEM Edge se enlaza a un sitio, y cada sitio se asigna a una rama de Git. Un programa obtiene exactamente 3 instancias de función Edge de AEM, un presupuesto fijo independientemente de cuántas ramas tenga el repositorio. Planifique su estrategia de ramificación en torno a ese presupuesto antes de integrarlo en el proceso de lanzamiento.

Ámbito de las funciones de AEM Edge

Función AEM Edge enlazada a
Límite de implementación
programa Edge Delivery Services
3 por programa (rama principal, de fase y de desarrollo, asignados a los sitios Producción, Ensayo y Desarrollo)

Cada sitio, Producción, Ensayo y Desarrollo, se asigna a una rama fija (main, stage y dev respectivamente) y obtiene su propia instancia de función de AEM Edge.

Modelo de implementación de la función AEM Edge en Edge Delivery Services

Promocionar código en sus sitios

En Edge Delivery Services, su configuración de CDN (edgeFunctions.yaml y cdn.yaml) y su código de función de AEM Edge se encuentran en el mismo repositorio de AEM Edge Functions project. Los pasos de alto nivel para promocionar el código al siguiente sitio son:

  1. Combine la configuración y los cambios del código de función de AEM Edge en la rama asignada al sitio de destino (por ejemplo, dev en stage).

  2. En Cloud Manager, compruebe que la canalización de configuración de Edge Delivery Services utiliza la rama combinada.

  3. Ejecute la canalización de configuración de Edge Delivery para implementar los archivos edgeFunctions.yaml y cdn.yaml.

  4. Compruebe que el contexto CLI (o sistema CI/CD) utiliza la rama combinada y se dirige al sitio deseado mediante el comando aio aem edge-functions info.

  5. Ejecute aio aem edge-functions deploy <name> (a través de la CLI o el sistema CI/CD) para implementar el código de función en el sitio de destino.

Administrar secretos entre sitios

Edge Delivery Services tiene una canalización de configuración por programa, no una por sitio. Los sitios Desarrollo, Ensayo y Producción lo comparten, por lo que no puede agregar el mismo nombre de variable tres veces con tres valores diferentes.

En Cloud Manager, abra la canalización de configuración de Edge Delivery del programa y seleccione Ver/Editar variables. Agregue un secreto por sitio, con el prefijo “nunca chocar”, por ejemplo DEV_TRIPS_API_TOKEN, STAGE_TRIPS_API_TOKEN y MAIN_TRIPS_API_TOKEN. Para ver los pasos exactos, consulte Usar configuraciones y secretos.

Las configuraciones no secretas funcionan igual independientemente del sitio: las declara directamente en edgeFunctions.yaml, y se confirma con Git. Para ver los pasos exactos, consulte Usar configuraciones y secretos.

Planifique su SDLC en torno al ámbito del sitio

  • Pruebe la lógica de la función en la rama dev antes de combinarla con stage o main.
  • Agregue a cada secreto y nombre de variable su sitio (DEV_, STAGE_, MAIN_), ya que una canalización de configuración sirve a los tres sitios.
  • Rastree la configuración y el desvío secreto entre sitios como parte de la lista de comprobación de versiones, no como una idea tardía.

Recursos adicionales

recommendation-more-help
experience-manager-learn-help-cloud-service