Extensibilité des microservices d’Asset compute

AEM en tant que microservices d’Asset compute Cloud Service prennent en charge le développement et le déploiement de programmes de travail personnalisés utilisés pour lire et manipuler les données binaires des ressources stockées dans AEM, le plus souvent, pour créer des rendus de ressources personnalisés.

Alors que dans AEM 6.x, les processus AEM personnalisés étaient utilisés pour lire, transformer et écrire des rendus de ressources, dans l’ en tant qu’Asset compute Cloud Service les programmes de travail répondent à ce besoin.

Ce que vous allez faire

Ce tutoriel décrit la création d’un objet Worker d’Assets compute simple qui crée un rendu de ressource en recadrant la ressource d’origine sur un cercle et en appliquant un contraste et une luminosité configurables. Bien que le programme de travail lui-même soit de base, ce tutoriel l’utilise pour explorer la création, le développement et le déploiement d’un programme de travail d’Asset compute personnalisé à utiliser avec AEM en tant que Cloud Service.

Objectifs

  1. Configuration et configuration des comptes et services nécessaires pour créer et déployer un Asset compute Worker
  2. Création et configuration d’un projet Asset compute
  3. Développer un objet Worker am Asset compute qui génère un rendu personnalisé
  4. Rédigez des tests pour et apprenez à déboguer le programme de travail d’Asset compute personnalisé.
  5. Déployez Asset compute Worker et intégrez-le AEM en tant que service de création de Cloud Service via les profils de traitement

Configuration

Découvrez comment vous préparer correctement à étendre les employés d’Asset compute et comprendre quels services et comptes doivent être configurés et configurés, ainsi que quels logiciels installés localement en vue du développement.

Approvisionnement des comptes et des services

Les comptes et services suivants nécessitent la mise en service et l’accès à pour suivre le tutoriel, AEM en tant que programme Sandbox ou environnement de développement de Cloud Service, l’accès à Adobe Project Firefly et à Microsoft Azure Blob Storage.

Environnement de développement local

Le développement local de projets d’Asset compute nécessite un ensemble d’outils de développement spécifique, différent du développement AEM traditionnel, notamment : Microsoft Visual Studio Code, Docker Desktop, Node.js et prise en charge des modules npm.

Adobe Project Firefly

Les projets Asset compute sont des projets Adobe Project Firefly spécialement définis. Par conséquent, ils nécessitent l’accès à Adobe Project Firefly dans Adobe Developer Console pour les configurer et les déployer.

Développer

Découvrez comment créer et configurer un projet Asset compute, puis développer un programme de travail personnalisé qui génère un rendu de ressource personnalisé.

Création d’un projet Asset compute

Les projets d’Asset compute, qui contiennent un ou plusieurs objets Worker d’Asset compute, sont générés à l’aide de l’interface de ligne de commande de l’Adobe I/O interactif. Les projets Asset compute sont des projets Adobe Project Firefly spécialement structurés, qui sont à leur tour des projets Node.js.

Configuration des variables d’environnement

Les variables d’environnement sont conservées dans le fichier .env pour le développement local et sont utilisées pour fournir des informations d’identification d’Adobe I/O et des informations d’identification de l’espace de stockage requises pour le développement local.

Configuration du fichier manifest.yml

Les projets Asset compute contiennent des manifestes qui définissent tous les Assets compute employés contenus dans le projet, ainsi que les ressources dont ils disposent lorsqu’ils sont déployés vers Adobe I/O Runtime pour exécution.

Développement d’un worker

Le développement d’un objet Worker d’Asset compute constitue le coeur de l’extension des microservices d’Asset compute, dans la mesure où il contient le code personnalisé qui génère, ou orchestre, la génération du rendu de ressource résultant.

Utilisation de l’outil de développement d’Assets compute

L’outil de développement d’Asset compute fournit un outil web local pour le déploiement, l’exécution et la prévisualisation des rendus générés par le programme de travail, ce qui permet le développement rapide et itératif des Assets compute Worker.

Test et débogage

Découvrez comment tester les agents d’Asset compute personnalisés pour qu’ils soient confiants dans leur fonctionnement et déboguer les agents d’Asset compute pour comprendre et résoudre les problèmes liés à l’exécution du code personnalisé.

Tester un programme de travail

asset compute fournit une structure de test pour la création de suites de tests pour les programmes de travail, en définissant des tests qui garantissent un comportement correct facile.

Débogage d’un programme de travail

Les objets Worker Asset compute fournissent différents niveaux de débogage, de la sortie console.log(..) traditionnelle aux intégrations avec VS Code et wskdebug, ce qui permet aux développeurs de parcourir le code de travail lorsqu’il s’exécute en temps réel.

Déploiement

Découvrez comment intégrer des objets Worker Asset compute personnalisés avec AEM en tant que Cloud Service, en les déployant d’abord vers Adobe I/O Runtime, puis en appelant à partir d’AEM en tant qu’auteur Cloud Service via les profils de traitement d’AEM Assets.

Déploiement sur Adobe I/O Runtime

Les objets Worker Asset compute doivent être déployés sur Adobe I/O Runtime pour être utilisés avec AEM en tant que Cloud Service.

Intégrer des objets Worker via des profils de traitement AEM

Une fois déployé dans Adobe I/O Runtime, les objets Worker Asset compute peuvent être enregistrés en tant que Cloud Service dans AEM via Profils de traitement des ressources. Les profils de traitement sont, à leur tour, appliqués aux dossiers de ressources s’appliquant aux ressources qu’ils contiennent.

Avancé

Ces tutoriels abrégés abordent des cas d’utilisation plus avancés en s’appuyant sur des connaissances fondamentales établies dans les chapitres précédents.

  • Développez un processus de métadonnées d’Asset compute qui peut écrire des métadonnées dans le

Codebase sur Github

Le code base du tutoriel est disponible sur Github à l’adresse :

Le code source ne contient pas les fichiers .env ou config.json requis. Ils doivent être ajoutés et configurés à l’aide de vos comptes et services informations.

Ressources supplémentaires

Vous trouverez ci-dessous diverses ressources d’Adobe qui fournissent des informations supplémentaires ainsi que des API et des SDK utiles pour le développement des employés d’Asset compute.

Documentation

API et SDK

Sur cette page