Extensibilité des microservices d'Asset compute

AEM en tant que microservices de Asset compute Cloud Service prennent en charge le développement et le déploiement de travailleurs 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 de flux de travail personnalisés ont été utilisés pour lire, transformer et écrire en retour des rendus de ressources, dans l', en tant que travailleurs d'Asset compute Cloud Service répondent à ce besoin.

Ce que vous allez faire

Ce didacticiel vous guide tout au long de la création d’un simple collaborateur d’Assets compute qui crée un rendu de fichier en recadrant le fichier d’origine sur un cercle et applique un contraste et une luminosité configurables. Bien que le programme de travail lui-même soit de base, ce didacticiel l’utilise pour explorer la création, le développement et le déploiement d’un Asset compute de travail personnalisé à utiliser avec AEM en tant que Cloud Service.

Objectifs

1. Fourniture et configuration des comptes et services nécessaires à la création et au déploiement d'un travailleur d'Asset compute
2. Création et configuration d’un projet d’Asset compute
3. Développer un collaborateur d’Assets compute am qui génère un rendu personnalisé
4. Ecrivez des tests pour et apprenez comment déboguer l'agent d'Asset compute personnalisé.
5. Déployez le travailleur d’Asset compute et intégrez-le AEM en tant que service d’auteur Cloud Service via les Profils de traitement

Configuration

Apprenez à vous préparer correctement à l'extension du personnel d'Asset compute et à comprendre quels services et comptes doivent être configurés et configurés, et quels logiciels doivent être installés localement pour le développement.

Approvisionnement des comptes et des services

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

• Fourniture de comptes et de services

Environnement de développement local

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

• Configuration de l'environnement de développement local

Adobe Projet Firefly

Les projets d'Asset compute sont des projets de lucioles d'Adobe spécialement définis et, en tant que tels, nécessitent l'accès à la luciole de projet d'Adobe dans la console de développement des Adobes pour les configurer et les déployer.

• Configurer la luciole du projet d'Adobe

Développer

Découvrez comment créer et configurer un projet d’Asset compute, puis développer un intervenant personnalisé qui génère un rendu d’actif sur mesure.

Création d’un projet d’Asset compute

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

• Création d’un projet d’Asset compute

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 les informations d'identification d'Adobe I/O et les informations d'identification d'enregistrement cloud requises pour le développement local.

• Configuration des variables d’environnement

Configuration du fichier manifest.yml

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

• Configuration du fichier manifest.yml

Développer un travailleur

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

• Développer un Asset compute

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

L'outil de développement d'Assets compute fournit un outil Web local pour le déploiement, l'exécution et l'aperçu des rendus générés par les travailleurs, ce qui permet le développement rapide et itératif des travailleurs d'Asset compute.

• Utilisation de l'outil de développement d'Assets compute

Test et débogage

Découvrez comment tester les agents d'Asset compute personnalisés pour être sûrs de 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 collaborateur

L’Asset compute fournit une structure de test pour la création de suites de tests pour les travailleurs, en définissant des tests qui garantissent un comportement correct facile.

• Tester un collaborateur

Débogage d’un collaborateur

Les travailleurs d'Asset compute fournissent divers niveaux de débogage, de la sortie traditionnelle console.log(..) à l'intégration avec VS Code et wskdebug, ce qui permet aux développeurs de parcourir le code de travail tel qu'il s'exécute en temps réel.

• Débogage d’un collaborateur

Déploiement

Découvrez comment intégrer des travailleurs d’Asset compute personnalisés avec AEM en tant que Cloud Service, en les déployant d’abord à 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 employés d'Asset compute doivent être déployés à Adobe I/O Runtime pour être utilisés avec l'AEM comme Cloud Service.

• Utilisation des Profils de traitement

Intégrer les travailleurs au moyen de Profils de traitement AEM

Une fois déployés à Adobe I/O Runtime, les travailleurs de l'Asset compute peuvent être enregistrés en tant que Cloud Service dans l'AEM par l'intermédiaire de Profils de traitement des actifs. Les Profils de traitement sont, à leur tour, appliqués aux dossiers de fichiers qui s’appliquent aux fichiers qu’ils contiennent.

• Intégration des Profils de traitement AEM

Avancé

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

• Développement d’un travail de métadonnées d’Asset compute capable de réécrire les métadonnées dans

Codebase sur Github

Le code de base du tutoriel est disponible sur Github à l'adresse suivante :

• branche principale adobe/aem-guides-wknd-asset-computing @

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 complémentaires et des API et SDK utiles pour le développement de travailleurs d'Asset compute.

Documentation

• Documentation Asset compute Service
• Outil de développement d'Asset compute Lisez-moi
• Exemples d'Assets compute

API et SDK

• asset compute SDK
  • asset compute Commons
  • asset compute XMP
• Bibliothèque Adobe Cloud Blobstore Wrapper
• Adobe de la bibliothèque Récupération de la nouvelle tentative
• Exemples d'Assets compute