Einrichten einer lokalen Entwicklungsumgebung

Adobe Asset Compute-Projekte können nicht in die vom AEM SDK bereitgestellte lokale AEM-Laufzeit integriert werden und werden mithilfe ihrer eigenen Kette von Tools entwickelt, die sich von der für AEM-Anwendungen basierend auf dem AEM Maven-Projektarchetyp erforderlichen unterscheidet.

Um Asset Compute-Microservices zu erweitern, müssen die folgenden Tools auf dem lokalen Computer der Entwicklungsperson installiert sein.

Abgekürzte Anweisungen zur Einrichtung

Im Folgenden finden Sie eine verkürzte Anleitung zur Einrichtung. Details zu diesen Entwicklungs-Tools werden in den folgenden Abschnitten beschrieben.

  1. Installieren Sie Docker Desktop und rufen Sie die erforderlichen Docker-Bilder ab:

    code language-none
    $ docker pull openwhisk/action-nodejs-v12:latest
    $ docker pull adobeapiplatform/adobe-action-nodejs-v12:3.0.22
    
  2. Installieren Sie Visual Studio Code

  3. Installieren Sie Node.js 10+

  4. Installieren Sie die erforderlichen npm-Module und Adobe I/O-CLI-Plug-ins über die Befehlszeile:

    code language-none
    $ npm i -g @adobe/aio-cli @openwhisk/wskdebug ngrok --unsafe-perm=true \
    && aio plugins:install @adobe/aio-cli-plugin-asset-compute
    

Weitere Informationen zu den verkürzten Installationsanweisungen finden Sie in den folgenden Abschnitten.

Installieren von Visual Studio Code vscode

Microsoft Visual Studio Code wird zum Entwickeln und Debuggen von Asset Compute-Sekundären verwendet. Es kann zwar auch eine andere JavaScript-kompatible IDE zum Entwickeln des Sekundärs verwendet werden, jedoch kann nur Visual Studio Code integriert werden, um den Asset Compute-Sekundär zu debuggen.

In diesem Tutorial wird von der Verwendung von Visual Studio Code ausgegangen, da es das beste Entwicklererlebnis für die Erweiterung von Asset Compute bietet.

Installieren von Docker Desktop docker

Laden Sie die neueste, stabile Version von Docker Desktop herunter und installieren Sie sie, da dies erforderlich ist, um Asset Compute-Projekte lokal zu testen und zu debuggen.

Starten Sie Docker Desktop nach der Installation und installieren Sie die folgenden Docker-Bilder über die Befehlszeile:

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

Entwicklerinnen und Entwickler auf Windows-Computern sollten sicherstellen, dass sie Linux-Container für die oben genannten Bilder verwenden. Die Schritte zum Wechseln zu Linux-Containern werden im Abschnitt Dokumentation zu Docker für Windows beschrieben.

Installieren von Node.js (und npm) node-js

Asset Compute-Sekundäre sind Node.js-basiert und benötigen daher Node.js 10+ (und npm) zur Entwicklung und Erstellung.

Installieren von Adobe I/O CLI aio

Installieren Sie Adobe I/O-CLI oder aio. Dabei handelt es sich um ein Befehlszeilen(CLI)-NPM-Modul, das die Nutzung von und die Interaktion mit Adobe I/O-Technologien erleichtert und sowohl zum Generieren als auch zur lokalen Entwicklung benutzerdefinierter Asset Compute-Sekundäre verwendet wird.

$ npm install -g @adobe/aio-cli

Installieren des Asset Compute-Plug-ins für Adobe I/O-CLI aio-asset-compute

Das Asset Compute-Plug-in von Adobe I/O-CLI

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

Installieren von wskdebug wskdebug

Laden Sie das npm-Modul Apache OpenWhisk-debug herunter und installieren Sie es, um das lokale Debugging von Asset Compute-Sekundären zu erleichtern.

Visual Studio Code 1.48.x+ ist erforderlich, damit wskdebug funktioniert.

$ npm install -g @openwhisk/wskdebug

Installieren von ngrok ngrok

Laden Sie das npm-Modul ngrok herunter und installieren Sie es. Es bietet öffentlichen Zugriff auf Ihren lokalen Entwicklungs-Computer, um das lokale Debugging von Asset Compute-Sekundären zu erleichtern.

$ npm install -g ngrok --unsafe-perm=true
recommendation-more-help
4859a77c-7971-4ac9-8f5c-4260823c6f69