Capacidad de extensión de los microservicios de asset compute

AEM como microservicios de Asset compute de Cloud Service admiten el desarrollo y la implementación de trabajadores personalizados que se utilizan para leer y manipular datos binarios de recursos almacenados en AEM, normalmente para crear representaciones de recursos personalizadas.

Mientras que en AEM 6.x los procesos de flujo de trabajo AEM personalizados se utilizaban para leer, transformar y escribir representaciones de recursos, en AEM los trabajadores de Asset compute de Cloud Service satisfacen esta necesidad.

Qué hará

Este tutorial recorta la creación de un Asset compute de trabajo simple que crea una representación de recursos recortando el recurso original en un círculo y aplica el contraste y el brillo configurables. Aunque el propio trabajador es básico, este tutorial lo utiliza para explorar la creación, el desarrollo y la implementación de un Asset compute de trabajo personalizado para utilizarlo con AEM como Cloud Service.

Objetivos

  1. Aprovisionar y configurar las cuentas y los servicios necesarios para crear e implementar un trabajador de Asset compute
  2. Creación y configuración de un proyecto de Asset compute
  3. Desarrollar un programa de trabajo de Asset compute de am que genere una representación personalizada
  4. Escriba pruebas para y aprenda a depurar el Asset compute de trabajo personalizado
  5. Implemente el Asset compute de trabajo e inclúyalo AEM como un servicio Cloud Service Author a través de Perfiles de procesamiento

Configuración

Aprenda a prepararse adecuadamente para la ampliación de los trabajadores del Asset compute, y comprenda qué servicios y cuentas deben aprovisionarse y configurarse, y qué software debe instalarse localmente para el desarrollo.

Aprovisionamiento de cuentas y servicios

Las siguientes cuentas y servicios requieren aprovisionamiento y acceso a para completar el tutorial, AEM como entorno de desarrollo de Cloud Service o programa de espacio aislado, acceso a Proyecto de Adobe Firefly y almacenamiento de blob de Microsoft Azure.

Entorno de desarrollo local

El desarrollo local de los proyectos de Asset compute requiere un conjunto de herramientas para desarrolladores específico, diferente del desarrollo de AEM tradicional, que incluye: Microsoft Visual Studio Code, Docker Desktop, Node.js y módulos npm compatibles.

Luciérnagas del proyecto Adobe

Los proyectos de asset compute son proyectos de Adobe especialmente definidos y como tales, requieren acceso a Proyecto de Adobe Firefly en la consola para desarrolladores de Adobe para configurarlos e implementarlos.

Desarrollar

Obtenga información sobre cómo crear y configurar un proyecto de Asset compute y, a continuación, desarrollar un programa de trabajo personalizado que genere una representación de recursos personalizada.

Crear un nuevo proyecto de Asset compute

Los proyectos de asset compute, que contienen uno o más trabajadores de Asset compute, se generan mediante la CLI de Adobe I/O interactiva. Los proyectos de asset compute son proyectos especialmente estructurados del Proyecto de Adobe Firefly, que a su vez son proyectos de Node.js.

Configuración de variables de entorno

Las variables de entorno se mantienen en el archivo .env para el desarrollo local y se utilizan para proporcionar las credenciales de Adobe I/O y las credenciales de almacenamiento en la nube necesarias para el desarrollo local.

Configurar manifest.yml

Los proyectos de asset compute contienen manifiestos que definen todos los trabajadores del Asset compute contenidos en el proyecto, así como los recursos disponibles cuando se implementan en Adobe I/O Runtime para su ejecución.

Desarrollo de un trabajador

El desarrollo de un Asset compute de trabajo es la base de la ampliación de los microservicios de Asset compute, ya que el contiene el código personalizado que genera u organiza la generación de la representación de recursos resultante.

Uso de la herramienta de desarrollo de Asset compute

La herramienta de desarrollo de Assets computes proporciona un mazo de cables web local para implementar, ejecutar y previsualizar las representaciones generadas por el trabajador, lo que permite un desarrollo rápido e iterativo del trabajador de Asset compute.

Prueba y depuración

Obtenga información sobre cómo probar a los Assets computes personalizados para que estén seguros de su funcionamiento, y depurar a los trabajadores de Asset compute para que entiendan y solucionen problemas cómo se ejecuta el código personalizado.

Probar un trabajador

asset compute proporciona un marco de pruebas para crear grupos de pruebas para los trabajadores, lo que facilita la definición de pruebas que garanticen un comportamiento adecuado.

Depurar un trabajador

Los trabajadores de asset compute proporcionan varios niveles de depuración desde la salida tradicional console.log(..) hasta integraciones con Código VS y wskdebug, lo que permite a los desarrolladores pasar por el código de trabajo a medida que se ejecuta en tiempo real.

Implementar

Obtenga información sobre cómo integrar a los trabajadores de Asset compute personalizados con AEM como Cloud Service, implementándolos primero en Adobe I/O Runtime y luego invocando desde AEM como autor Cloud Service a través de los Perfiles de procesamiento de AEM Assets.

Implementar en Adobe I/O Runtime

Los trabajadores de asset compute deben implementarse en Adobe I/O Runtime para su uso con AEM como Cloud Service.

Integración de trabajadores mediante Perfiles de procesamiento de AEM

Una vez implementados en Adobe I/O Runtime, los trabajadores de Asset compute se pueden registrar en AEM como un Cloud Service a través de Assets Processing Profiles. Los perfiles de procesamiento se aplican, a su vez, a las carpetas de recursos que se aplican a los recursos que contienen.

Avanzado

Estos tutoriales abreviados abordan casos de uso más avanzados basados en las enseñanzas básicas establecidas en capítulos anteriores.

  • Desarrolle un trabajo de metadatos de Asset compute que pueda volver a escribir metadatos en el

Código base en Github

El código base del tutorial está disponible en Github en:

El código fuente no contiene los archivos .env o config.json necesarios. Se deben agregar y configurar usando la información de cuentas y servicios.

Recursos adicionales

A continuación se indican varios recursos de Adobe que proporcionan más información y API y SDK útiles para el desarrollo de trabajadores de Asset compute.

Documentación

API y SDK

En esta página