Extensibilidade de microsserviços do Asset compute

AEM como os microsserviços de Asset compute e desenvolvimento oferecem suporte à implantação de trabalhadores personalizados usados para ler, manipular dados binários de ativos armazenados em AEM, geralmente para criar representações de ativos personalizados.

Enquanto em AEM 6.x os processos de fluxo de trabalho de AEM personalizados foram usados para ler, transformar e gravar representações de ativos, em AEM como um Asset compute Cloud Service atende a essa necessidade.

O que você vai fazer

Este tutorial aborda a criação de um trabalhador do Asset compute simples que cria uma representação de ativos ao recortar o ativo original para um círculo e aplica contraste e brilho configuráveis. Embora o trabalhador em si seja básico, este tutorial o usa para explorar a criação, o desenvolvimento e a implantação de um Asset compute personalizado para uso com o AEM como Cloud Service.

Objetivos

  1. Provisionamento e configuração das contas e serviços necessários para criar e implantar um trabalhador Asset compute
  2. Criar e configurar um projeto do Asset compute
  3. Desenvolver um trabalhador do Asset compute am que gera uma representação personalizada
  4. Escreva testes para e saiba como depurar o trabalhador do Asset compute personalizado
  5. Implante o trabalhador do Asset compute e integre-o AEM como um serviço de Autor do Cloud Service por meio de Perfis de processamento

Configurar

Saiba como se preparar adequadamente para estender os funcionários do Asset compute, e entender quais serviços e contas devem ser provisionados e configurados, além de software instalado localmente para desenvolvimento.

Provisionamento de conta e serviços

As contas e serviços a seguir exigem provisionamento e acesso ao para concluir o tutorial, AEM como um ambiente de desenvolvimento de Cloud Service ou programa de sandbox, acesso ao Adobe Project Firefly e ao Microsoft Azure Blob Storage.

Ambiente de desenvolvimento local

O desenvolvimento local de projetos Assets compute requer um conjunto de ferramentas de desenvolvimento específico, diferente do desenvolvimento AEM tradicional, incluindo: Microsoft Visual Studio Code, Docker Desktop, Node.js e módulos npm de suporte.

Adobe Project Firefly

Os projetos do Asset compute são projetos do Adobe Project Firefly especialmente definidos e, como tal, exigem acesso ao Adobe Project Firefly no Adobe Developer Console para configurá-los e implantá-los.

Desenvolver

Saiba como criar e configurar um projeto do Asset compute e, em seguida, desenvolver um trabalhador personalizado que gera uma representação de ativos personalizados.

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 usando a CLI do Adobe I/O interativo. Os projetos do Asset compute são projetos do Adobe Project Firefly especialmente estruturados, que por sua vez são projetos do Node.js.

Configurar variáveis de ambiente

As variáveis de ambiente são mantidas no arquivo .env para desenvolvimento local e são usadas para fornecer credenciais de Adobe I/O e credenciais de armazenamento de 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 eles têm disponíveis quando 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, já que o trabalhador contém o código personalizado que gera, ou orquestra, a geração da representação de ativos resultante.

Usar a ferramenta de desenvolvimento de Assets compute

A Ferramenta de desenvolvimento de Assets compute fornece um recurso da Web local para implantar, executar e visualizar representações geradas por funcionários, com suporte ao desenvolvimento rápido e iterativo de funcionários do Asset compute.

Testar e depurar

Saiba como testar trabalhadores personalizados do Asset compute para terem confiança em sua operação e depurar os trabalhadores do Asset compute para entender e solucionar problemas de como o código personalizado é executado.

Testar um trabalhador

O Asset compute fornece uma estrutura de teste para criar conjuntos de teste para trabalhadores, tornando fácil a definição de testes que garantam que o comportamento adequado seja fácil.

Depurar um trabalhador

Os trabalhadores do Asset compute fornecem vários níveis de depuração da saída console.log(..) tradicional, para integrações com Código VS e wskdebug, permitindo que os desenvolvedores passem pelo código do trabalhador, pois ele é executado em tempo real.

Implantar

Saiba como integrar trabalhadores personalizados do Asset compute com o AEM as a Cloud Service, primeiro implantando-os no Adobe I/O Runtime e, em seguida, chamando do AEM como um autor do Cloud Service 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 serem usados com o AEM como um Cloud Service.

Integrar trabalhadores por meio de Perfis de processamento de AEM

Depois de implantados no Adobe I/O Runtime, os trabalhadores do Asset compute podem ser registrados no AEM como um Cloud Service via Assets Processing Profiles. Os Perfis de processamento são, por sua vez, aplicados às pastas de ativos que se aplicam aos ativos neles contidos.

Avançado

Esses tutoriais resumidos abordam casos de uso mais avançados com base em aprendizagens fundamentais estabelecidas nos capítulos anteriores.

  • Desenvolver um trabalho de metadados de Asset compute que possa gravar metadados de volta no

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 usando as informações accounts and services.

Recursos adicionais

Veja a seguir vários recursos do Adobe que fornecem mais informações e APIs úteis e SDKs para desenvolver funcionários do Asset compute.

Documentação

APIs e SDKs

Nesta página