Les projets Adobe Asset compute ne peuvent pas être intégrés au runtime AEM local fourni par le SDK AEM et sont développés à l’aide de leur propre chaîne d’outils, distincte de celle requise par les applications en fonction de l’archétype de projet Maven.
Pour étendre les microservices Asset compute, les outils suivants doivent être installés sur la machine locale du développeur.
Vous trouverez ci-dessous des instructions de configuration abrégées. Les détails de ces outils de développement sont décrits dans des sections discrètes ci-dessous.
Installez Docker Desktopet extrayez les images Docker requises :
$ docker pull openwhisk/action-nodejs-v12:latest
$ docker pull adobeapiplatform/adobe-action-nodejs-v12:3.0.22
Installez les modules npm requis et les modules CLI d’Adobe I/O à partir de la ligne de commande :
$ npm i -g @adobe/aio-cli@7.1.0 @openwhisk/wskdebug ngrok --unsafe-perm=true \
&& aio plugins:install @adobe/aio-cli-plugin-asset-compute
Pour plus d’informations sur les instructions d’installation abrégées, consultez les sections ci-dessous.
Le code Microsoft Visual Studio est utilisé pour le développement et le débogage des objets Worker Asset compute. Bien que d’autres IDE compatibles avec JavaScript puissent être utilisés pour développer le programme de travail, seul le code Visual Studio peut être intégré à debug Asset compute worker.
Ce tutoriel suppose l’utilisation de Visual Studio Code, car il fournit la meilleure expérience de développement pour étendre l’Asset compute.
Téléchargez et installez la dernière version de Docker Desktop, car cela est nécessaire pour tester et déboguer Asset compute les projets localement.
Après avoir installé Docker Desktop, démarrez-le et installez les images Docker suivantes à partir de la ligne de commande :
$ docker pull openwhisk/action-nodejs-v12:latest
$ docker pull adobeapiplatform/adobe-action-nodejs-v12:3.0.22
Les développeurs sur les machines Windows doivent s’assurer qu’ils utilisent des conteneurs Linux pour les images ci-dessus. Les étapes de basculement vers des conteneurs Linux sont décrites dans la documentation Docker pour Windows.
Les objets Worker Asset compute sont basés sur Node.js et nécessitent donc Node.js 10+ (et npm) pour le développement et la création.
Installez l’interface de ligne de commande ou le module npm ____ aiois an command line (CLI) Adobe I/O qui facilite l’utilisation et l’interaction avec les technologies d’Adobe I/O. Il est utilisé pour générer et développer localement des agents d’Asset compute personnalisés.
$ npm install -g @adobe/aio-cli@7.1.0
La version 7.1.0 de l’interface de ligne de commande d’Adobe I/O est requise. Les versions ultérieures de l’interface de ligne de commande d’Adobe I/O ne sont pas prises en charge pour le moment.
Module externe d’Asset compute de la ligne de commande d’Adobe I/O
$ aio plugins:install @adobe/aio-cli-plugin-asset-compute
Téléchargez et installez le module npm Apache OpenWhisk debug pour faciliter le débogage local des objets Worker Asset compute.
Visual Studio Code 1.48.x+ est requis pour que 🔗 wskdebugto fonctionne.
$ npm install -g @openwhisk/wskdebug
Téléchargez et installez le module npm ngrok, qui permet au public d’accéder à votre machine de développement locale, afin de faciliter le débogage local des objets Worker Asset compute.
$ npm install -g ngrok --unsafe-perm=true