Configurer l’environnement de développement local

Les projets Assets Compute ne peuvent pas être intégrés à l’exécution AEM locale fournie 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 Assets Compute, les outils suivants doivent être installés sur la machine de développement locale.

Instructions de configuration abrégées.

Vous trouverez ci-dessous des instructions de configuration abrégées. Ces outils de développement sont décrits dans les sections ci-dessous.

1. Installez Docker Desktop et procédez à l’extraction des images Docker requises :

   $ docker pull openwhisk/action-nodejs-v12:latest
   $ docker pull adobeapiplatform/adobe-action-nodejs-v12:3.0.22
   

2. Installer Visual Studio Code

3. Installer Node.js 10 ou version ultérieure

4. Installez les modules npm requis et les plug-ins 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.

Installer Visual Studio Code

Microsoft Visual Studio Code est utilisé à des fins de développement et de débogage des programmes de travail Assets Compute. Bien que d’autres IDE compatibles avec JavaScript puissent participer au développement du programme de travail, seul Visual Studio Code permet de déboguer le programme de travail Assets Compute.

Ce tutoriel utilise Visual Studio Code afin d’offrir la meilleure expérience de développement et tirer pleinement parti d’Asset Compute.

Installer Docker Desktop

Téléchargez et installez la dernière version stable de Docker Desktop, nécessaire pour tester et déboguer localement des projets Assets Compute.

Une fois Docker Desktop installé, lancez l’application 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 et développeuses Windows doivent s’assurer d’utiliser des conteneurs Linux pour les images ci-dessus. Suivez la procédure d’utilisation des conteneurs Linux dans la section Documentation de Docker pour Windows.

Installer Node.js (et npm)

Les programmes de travail Assets Compute sont basés sur Node.js et nécessitent donc Node.js 10 ou version ultérieure (et npm) pour le développement et la création.

• Installez Node.js (et npm) comme pour le développement AEM traditionnel.

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

Installez l’interface de ligne de commande d’Adobe I/O, ou aio, qui est un module npm de ligne de commande (CLI) et facilite l’utilisation et l’interaction avec les technologies d’Adobe I/O. Il permet de générer et de développer localement des programmes de travail Assets Compute personnalisés.

$ npm install -g @adobe/aio-cli@7.1.0

L’interface de ligne de commande d’Adobe I/O version 7.1.0 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.

Installer le plug-in Asset Compute d’interface de ligne de commande d’Adobe I/O

Plug-in Asset Compute d’interface de 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 de débogage Apache OpenWhisk pour faciliter le débogage local des programmes de travail Assets Compute.

Visual Studio Code 1.48.x ou version ultérieure est requis pour exécuter wskdebug.

$ 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 programmes de travail Assets Compute.

$ npm install -g ngrok --unsafe-perm=true