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.
-
Installez Docker Desktop et procédez à l’extraction des images Docker requises :
code language-none $ docker pull openwhisk/action-nodejs-v12:latest $ docker pull adobeapiplatform/adobe-action-nodejs-v12:3.0.22 -
Installez les modules npm requis et les plug-ins CLI d’Adobe I/O à partir de la ligne de commande :
code language-none $ npm i -g @adobe/aio-cli @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 vscode
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 docker
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) node-js
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 aio
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
Installer le plug-in Asset Compute d’interface de ligne de commande d’Adobe I/O aio-asset-compute
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 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 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