Configuration de l’environnement de développement local

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.

Instructions de configuration abrégées

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.

  1. 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
    
  2. Installation du code Visual Studio

  3. Installation de Node.js 10+

  4. 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.

Installation du code Visual Studio

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.

Installation de Docker Desktop

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.

Installation de Node.js (et npm)

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.

Installation de l’interface de ligne de commande Adobe I/O

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.

Installation du module Adobe I/O CLI Asset compute

Module externe d’Asset compute de la ligne de commande d’Adobe I/O

$ aio plugins:install @adobe/aio-cli-plugin-asset-compute

Installer wskdebug

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

Installer ngrok

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

Sur cette page