Extensibilidade de microsserviços do Asset Compute

Os microsserviços do Asset Compute do AEM as a Cloud Service permitem o desenvolvimento e a implantação de trabalhadores personalizados usados para ler e tratar dados binários de ativos armazenados no AEM, geralmente para criar representações de ativos personalizados.

Enquanto os processos personalizados de fluxo de trabalho do AEM eram usados para ler, transformar e gravar representações de ativos no AEM 6.x, no AEM as a Cloud Service, os trabalhadores do Asset Compute suprem essa necessidade.

O que você fará

Este tutorial aborda a criação de um trabalhador simples do Asset Compute que cria uma representação de um ativo, recortando o ativo original em um círculo e aplicando opções de contraste e brilho configuráveis. Embora esse trabalhador seja básico, este tutorial usa-o para explorar a criação, o desenvolvimento e a implantação de um trabalhador personalizado do Asset Compute para uso com o AEM as a Cloud Service.

Objetivos objective

Configurar

Saiba como preparar-se corretamente para estender os funcionários do Asset Compute e entender quais serviços e contas devem ser provisionados e configurados, bem como o software instalado localmente para desenvolvimento.

Provisionamento de contas e serviços accounts-and-services

As contas e os serviços a seguir exigem provisionamento e acesso para concluir o tutorial, o ambiente de desenvolvimento do AEM as a Cloud Service ou o programa de sandbox, bem como acesso ao App Builder e ao armazenamento de blobs do Microsoft Azure.

Ambiente de desenvolvimento local

Diferentemente do desenvolvimento tradicional do AEM, o desenvolvimento local de projetos do Asset Compute requer um conjunto específico de ferramentas de desenvolvedor, incluindo: Microsoft Visual Studio Code, Docker Desktop, Node.js e módulos de npm de suporte.

App Builder

Os projetos do Asset Compute são projetos do App Builder definidos especialmente e, por esse motivo, exigem acesso ao App Builder no Adobe Developer Console para serem configurados e implantados.

Desenvolver

Saiba como criar e configurar um projeto do Asset Compute e desenvolver um trabalhador personalizado que gere uma representação de ativo personalizada.

Criar um novo projeto do Asset Compute

Os projetos do Asset Compute que contêm um ou mais trabalhadores do Asset Compute são gerados por meio da CLI interativa do Adobe I/O. Os projetos do Asset Compute são projetos do App Builder com uma estrutura especial, os quais, por sua vez, são projetos de Node.js.

Configurar variáveis de ambiente

As variáveis de ambiente são mantidas no arquivo .env para desenvolvimento local e usadas para fornecer credenciais do Adobe I/O e credenciais de armazenamento na nuvem necessárias para o desenvolvimento local.

Configurar o manifest.yml

Os projetos do Asset Compute contêm manifestos que definem todos os trabalhadores do Asset Compute contidos no projeto, bem como quais recursos estarão disponíveis quando eles forem implantados no Adobe I/O Runtime para execução.

Desenvolver um trabalhador

O desenvolvimento de um trabalhador do Asset Compute é o núcleo da extensão de microsserviços do Asset Compute, pois o trabalhador contém o código personalizado que gera ou coordena a geração da representação de ativos resultante.

Usar a ferramenta de desenvolvimento do Asset Compute

A ferramenta de desenvolvimento do Asset Compute fornece um recurso da web local para implantar, executar e visualizar representações geradas pelo trabalhador, permitindo um desenvolvimento rápido e iterativo do trabalhador do Asset Compute.

Testar e depurar

Saiba como testar trabalhadores personalizados do Asset Compute para uma operação confiável e como depurar trabalhadores do Asset Compute para entender e solucionar problemas de execução do código personalizado.

Testar um trabalhador

O Asset Compute fornece uma estrutura de teste para criar conjuntos de testes para trabalhadores, facilitando a definição de testes a fim de garantir o comportamento adequado.

Depurar um trabalhador

Os trabalhadores do Asset Compute oferecem vários níveis de depuração, desde a saída tradicional do console.log(..) até integrações com o Código VS e o wskdebug, permitindo que os desenvolvedores passem o código do trabalhador, à medida que ele é executado em tempo real.

Implantar

Saiba como integrar trabalhadores personalizados do Asset Compute ao AEM as a Cloud Service, implantando-os primeiro no Adobe I/O Runtime e, em seguida, invocando-os a partir do AEM as a Cloud Service Author por meio dos perfis de processamento do AEM Assets.

Implantar no Adobe I/O Runtime

Os trabalhadores do Asset Compute devem ser implantados no Adobe I/O Runtime para ser usados com o AEM as a Cloud Service.

Integrar trabalhadores por meio de perfis de processamento do AEM

Após a implantação no Adobe I/O Runtime, os trabalhadores do Asset Compute podem ser registrados no AEM as a Cloud Service por meio de Perfis de processamento de ativos. Os perfis de processamento, por sua vez, são aplicados às pastas de ativos e aos ativos contidos nelas.

Avançado

Estes tutoriais resumidos abordam casos de uso mais avançados com base em lições fundamentais estabelecidas nos capítulos anteriores.

Base de código no Github

A base de código do tutorial está disponível no Github, em:

O código-fonte não contém os arquivos .env ou config.json necessários. Eles devem ser adicionados e configurados com as informações das suas contas e serviços.

Recursos adicionais

Confira abaixo vários recursos da Adobe que fornecem mais informações, bem como APIs e SDKs úteis, para o desenvolvimento de trabalhadores do Asset Compute.

Documentação

APIs e SDKs