Estensibilità dei microservizi Asset Compute

I microservizi Asset Compute di AEM as a Cloud Service supportano lo sviluppo e l’implementazione di processi di lavoro personalizzati che consentono di leggere e manipolare i dati binari delle risorse memorizzate in AEM, solitamente per creare rappresentazioni personalizzate delle risorse.

Mentre in AEM 6.x i processi di flusso di lavoro personalizzati di AEM venivano utilizzati per leggere, trasformare e riscrivere le rappresentazioni delle risorse, nei processi di lavoro di AEM as a Cloud Service Asset Compute questa esigenza è soddisfatta.

Come procedere

Questo tutorial illustra la creazione di un semplice processo di lavoro Asset Compute che crea il rendering di una risorsa ritagliando la risorsa originale in un cerchio e applicando contrasto e luminosità configurabili. Anche se il worker è 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 correttamente per l’estensione dei processi di lavoro di Asset Compute e quali servizi e account devono essere predisposti e configurati e quale software deve essere installato localmente 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 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 Asset Compute, che contengono uno o più processi di lavoro Asset Compute, vengono generati utilizzando l’interfaccia CLI interattiva di Adobe I/O. I progetti 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 Asset Compute contengono manifesti che definiscono tutti i processi di lavoro Asset Compute all’interno del progetto, nonché le risorse disponibili per l’implementazione in Adobe I/O Runtime.

Sviluppa un lavoratore

Lo sviluppo di un processo di lavoro Asset Compute è fondamentale per l’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

Asset Compute Development Tool 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 testare i processi di lavoro Asset Compute personalizzati per avere la certezza di funzionare ed eseguire il debug dei processi di lavoro Asset Compute per comprendere e risolvere i problemi relativi all’esecuzione del codice personalizzato.

Eseguire il test di un lavoratore

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 di Asset Compute forniscono diversi livelli di debug, dall'output tradizionale console.log(..) 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

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

Integrare i processi di lavoro tramite Profili elaborazione AEM

Una volta implementati in Adobe I/O Runtime, i processi di lavoro di 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 diverse risorse di Adobe che forniscono ulteriori informazioni e utili API e SDK per lo sviluppo dei processi di lavoro di Asset Compute.

Documentazione

API e SDK