Erweiterbarkeit von asset compute-Microservices

AEM Asset compute-Microservices von Cloud Service unterstützen die Entwicklung und Bereitstellung von benutzerdefinierten Sekundären, die zum Lesen und Bearbeiten von Binärdaten von in AEM gespeicherten Assets verwendet werden, um meist benutzerdefinierte Asset-Ausgabedarstellungen zu erstellen.

Während in AEM 6.x benutzerdefinierte AEM-Workflow-Prozesse zum Lesen, Transformieren und Zurückschreiben von Asset-Ausgabedarstellungen verwendet wurden, erfüllen AEM als Cloud Service-Asset compute-Sekundäre diese Anforderung.

Was Sie tun werden

Dieses Tutorial führt Sie durch die Erstellung eines einfachen Asset compute-Sekundärs, der eine Asset-Ausgabedarstellung erstellt, indem das Original-Asset auf einen Kreis zugeschnitten und konfigurierbarer Kontrast und Helligkeit angewendet wird. Obwohl der Worker selbst grundlegend ist, nutzt dieses Tutorial es, um das Erstellen, Entwickeln und Bereitstellen eines benutzerdefinierten Asset compute-Sekundärs für die Verwendung mit AEM als Cloud Service zu untersuchen.

Ziele

  1. Bereitstellung und Einrichtung der erforderlichen Konten und Dienste zum Erstellen und Bereitstellen eines Asset compute Worker
  2. Erstellen und Konfigurieren eines Asset compute-Projekts
  3. Entwickeln eines Asset compute Sekundärs, der eine benutzerdefinierte Ausgabedarstellung generiert
  4. Schreiben von Tests für und Erfahren Sie, wie Sie den benutzerdefinierten Asset compute Worker debuggen
  5. Stellen Sie den Asset compute Worker bereit und integrieren Sie ihn AEM als Cloud Service-Autorendienst über Verarbeitungsprofile

Setup

Erfahren Sie, wie Sie sich ordnungsgemäß auf die Erweiterung von Asset compute-Workern vorbereiten und verstehen, welche Dienste und Konten bereitgestellt und konfiguriert werden müssen, sowie Software, die für die Entwicklung lokal installiert wird.

Konto- und Dienstbereitstellung

Die folgenden Konten und Dienste erfordern die Bereitstellung und den Zugriff auf , um das Tutorial, AEM als Cloud Service-Entwicklungsumgebung oder Sandbox-Programm, abzuschließen und auf Adobe Project Firefly und Microsoft Azure Blob Storage zuzugreifen.

Lokale Entwicklungsumgebung

Die lokale Entwicklung von Asset compute-Projekten erfordert ein spezifisches Entwickler-Tool-Set, das sich von der herkömmlichen AEM-Entwicklung unterscheidet, darunter: Microsoft Visual Studio Code, Docker Desktop, Node.js und unterstützende npm-Module.

Adobe Project Firefly

asset compute-Projekte sind speziell definierte Adobe Project Firefly-Projekte und erfordern daher Zugriff auf Adobe Project Firefly in der Adobe Developer Console, um sie einzurichten und bereitzustellen.

Entwickeln

Erfahren Sie, wie Sie ein Asset compute-Projekt erstellen und konfigurieren und dann einen benutzerdefinierten Worker entwickeln, der eine maßgeschneiderte Asset-Ausgabedarstellung generiert.

Neues Asset compute-Projekt erstellen

asset compute-Projekte, die einen oder mehrere Asset compute-Sekundäre enthalten, werden mithilfe der interaktiven Adobe I/O-CLI generiert. asset compute-Projekte sind speziell strukturierte Adobe Project Firefly-Projekte, die wiederum Node.js-Projekte sind.

Umgebungsvariablen konfigurieren

Umgebungsvariablen werden in der .env-Datei für die lokale Entwicklung gepflegt und zur Bereitstellung von Anmeldeinformationen für die Adobe I/O und Cloud-Speicher verwendet, die für die lokale Entwicklung erforderlich sind.

Konfigurieren von manifest.yml

asset compute-Projekte enthalten Manifeste, die alle im Projekt enthaltenen Asset compute-Sekundäre definieren, sowie Informationen darüber, welche Ressourcen ihnen zur Ausführung zur Verfügung stehen, wenn sie in Adobe I/O Runtime bereitgestellt werden.

Entwickeln eines Sekundärs

Die Entwicklung eines Asset compute Worker bildet den Kern der Erweiterung von Asset compute-Microservices, da der Worker den benutzerdefinierten Code enthält, der die Generierung der resultierenden Asset-Ausgabedarstellung generiert oder orchestriert.

Verwenden des Asset compute-Entwicklungstools

Das Asset compute Development Tool bietet eine lokale Web-Bibliothek für die Bereitstellung, Ausführung und Vorschau von Worker-generierten Ausgabedarstellungen, die eine schnelle und iterative Asset compute Worker-Entwicklung unterstützen.

Testen und Debuggen

Erfahren Sie, wie Sie benutzerdefinierte Asset compute-Sekundäre testen, um sich auf ihren Betrieb zu verlassen, und Asset compute-Sekundäre debuggen können, um zu verstehen und Fehler bei der Ausführung des benutzerspezifischen Codes zu beheben.

Worker testen

asset compute bietet ein Test-Framework für die Erstellung von Test-Suites für Mitarbeiter, mit dem Tests definiert werden, die sicherstellen, dass das richtige Verhalten einfach ist.

Debuggen eines Sekundärs

asset compute-Sekundäre bieten verschiedene Debugging-Ebenen, von der herkömmlichen console.log(..)-Ausgabe bis hin zu Integrationen mit VS-Code und wskdebug, sodass Entwickler während der Ausführung in Echtzeit den Worker-Code durchlaufen können.

Bereitstellen von

Erfahren Sie, wie Sie benutzerdefinierte Asset compute-Sekundäre in AEM as a Cloud Service integrieren können, indem Sie sie zuerst in Adobe I/O Runtime bereitstellen und dann über die Verarbeitungsprofile von AEM Assets von AEM as a Cloud Service Author aufrufen.

Bereitstellen in Adobe I/O Runtime

asset compute-Sekundäre müssen in Adobe I/O Runtime bereitgestellt werden, damit sie mit AEM als Cloud Service verwendet werden können.

Integration von Workern über AEM Verarbeitungsprofile

Nach der Bereitstellung in Adobe I/O Runtime können Asset compute-Sekundäre in AEM als Cloud Service über Asset-Verarbeitungsprofile registriert werden. Verarbeitungsprofile werden wiederum auf Asset-Ordner angewendet, die auf die darin enthaltenen Assets angewendet werden.

Erweitert

In diesen gekürzten Tutorials werden fortgeschrittene Anwendungsfälle behandelt, die auf den in den vorherigen Kapiteln gewonnenen Erkenntnissen aufbauen.

Codebase auf Github

Die Codebase des Tutorials ist auf Github unter folgender Adresse verfügbar:

Der Quellcode enthält nicht die erforderlichen .env- oder config.json-Dateien. Diese müssen mithilfe Ihrer Konten und Dienste-Informationen hinzugefügt und konfiguriert werden.

Zusätzliche Ressourcen

Im Folgenden finden Sie verschiedene Adoben-Ressourcen, die weitere Informationen und nützliche APIs und SDKs für die Entwicklung von Asset compute-Workern bereitstellen.

Dokumentation

APIs und SDKs

Auf dieser Seite