Estensibilità dei microservizi Asset compute

I microservizi di Asset compute dell’AEM come Cloud Service supportano lo sviluppo e l’implementazione di processi di lavoro personalizzati che vengono utilizzati per leggere e manipolare i dati binari delle risorse memorizzate nell’AEM, in genere per creare rappresentazioni personalizzate delle risorse.

Mentre in AEM 6.x venivano utilizzati processi di flusso di lavoro AEM personalizzati per leggere, trasformare e riscrivere le rappresentazioni delle risorse, in AEM as a Cloud Service gli Asset Compute worker soddisfano questa necessità.

Come procedere

Questo tutorial illustra la creazione di un semplice processo di lavoro in Asset compute che crea il rendering di una risorsa ritagliando la risorsa originale in un cerchio e applicando contrasto e luminosità configurabili. Sebbene il worker sia di base, questo tutorial lo utilizza per esplorare la creazione, lo sviluppo e la distribuzione di un worker Asset Compute personalizzato da utilizzare con AEM as a Cloud Service.

Obiettivi objective

Configurazione

Scopri come prepararti in modo appropriato all’estensione dei processi di lavoro per gli Asset compute e quali servizi e account devono essere predisposti e configurati e quale software deve essere installato in locale per lo sviluppo.

Provisioning di account e servizi accounts-and-services

I seguenti account e servizi richiedono il provisioning e l’accesso a per completare l’esercitazione, l’ambiente di sviluppo AEM as a Cloud Service o il programma sandbox, e accedere all’archiviazione BLOB di App Builder e Microsoft Azure.

Ambiente di sviluppo locale

Lo sviluppo locale di progetti Asset Compute richiede un set di strumenti specifico per gli sviluppatori, diverso dallo sviluppo AEM tradizionale, tra cui: Microsoft Visual Studio Code, Docker Desktop, Node.js e il supporto di moduli npm.

App Builder

I progetti di Asset compute sono progetti App Builder appositamente definiti e, per configurarli e distribuirli, hanno bisogno dell’accesso ad App Builder in Adobe Developer Console.

Sviluppa

Scopri come creare e configurare un progetto Asset Compute e quindi sviluppare un processo di lavoro personalizzato che generi una rappresentazione personalizzata delle risorse.

Crea un nuovo progetto Asset Compute

I progetti di Asset compute, che contengono uno o più processi di lavoro di Asset compute, vengono generati utilizzando l'interfaccia CLI interattiva di Adobe I/O. I progetti di Asset compute sono progetti App Builder appositamente strutturati, che a loro volta sono progetti Node.js.

Configurare le variabili di ambiente

Le variabili di ambiente vengono mantenute nel file .env per lo sviluppo locale e vengono utilizzate per fornire le credenziali di Adobe I/O e dell'archiviazione cloud richieste per lo sviluppo locale.

Configurare manifest.yml

I progetti di Asset compute contengono manifesti che definiscono tutti i processi di lavoro di Asset compute all’interno del progetto, nonché le risorse disponibili quando vengono distribuiti in Adobe I/O Runtime per l’esecuzione.

Sviluppa un lavoratore

Lo sviluppo di un processo di lavoro Asset Compute è il nucleo dell’estensione dei microservizi Asset Compute, in quanto il processo di lavoro contiene il codice personalizzato che genera, o orchestra, la generazione del rendering della risorsa risultante.

Utilizzare lo strumento di sviluppo Asset compute

Lo strumento per lo sviluppo Asset compute fornisce un Web harness locale per la distribuzione, l'esecuzione e l'anteprima delle rappresentazioni generate dai lavoratori, supportando lo sviluppo rapido e iterativo dei lavoratori Asset compute.

Test e debug

Scopri come verificare che i processi di lavoro personalizzati per gli Asset compute siano sicuri del loro funzionamento ed eseguire il debug dei processi di lavoro per gli Asset compute per comprendere e risolvere eventuali problemi relativi all’esecuzione del codice personalizzato.

Eseguire il test di un lavoratore

L’Asset compute fornisce un framework di test per la creazione di suite di test per i lavoratori, rendendo semplice la definizione di test che garantiscono un comportamento corretto.

Debug di un processo di lavoro

I processi di lavoro Asset Compute forniscono diversi livelli di debug dall'output console.log(..) tradizionale alle integrazioni con VS Code e wskdebug, consentendo agli sviluppatori di analizzare il codice del processo di lavoro durante l'esecuzione in tempo reale.

Distribuzione

Scopri come integrare i processi di lavoro Asset Compute personalizzati con AEM as a Cloud Service, distribuendoli prima in Adobe I/O Runtime e richiamandoli dall’istanza di authoring di AEM as a Cloud Service tramite i Profili di elaborazione di AEM Assets.

Implementare in Adobe I/O Runtime

Per poter essere utilizzati con AEM as a Cloud Service, i processi di lavoro Asset Compute devono essere implementati in Adobe I/O Runtime.

Integrare i lavoratori tramite i profili di elaborazione AEM

Una volta implementati in Adobe I/O Runtime, i processi di lavoro Asset Compute possono essere registrati in AEM as a Cloud Service tramite Profili elaborazione Assets. I Profili di elaborazione vengono, a loro volta, applicati alle cartelle di risorse che si applicano alle risorse in essi contenute.

Avanzate

Queste esercitazioni abbreviate affrontano casi d’uso più avanzati sulla base degli insegnamenti fondamentali stabiliti nei capitoli precedenti.

Codebase su Github

La base di codice del tutorial è disponibile su Github all’indirizzo:

Il codice sorgente non contiene i file .env o config.json richiesti. Questi devono essere aggiunti e configurati utilizzando le informazioni account e servizi.

Risorse aggiuntive

Di seguito sono riportate varie risorse di Adobe che forniscono ulteriori informazioni e utili API e SDK per lo sviluppo di lavoratori Asset compute.

Documentazione

API e SDK