Configurare l’ambiente di sviluppo locale
I progetti Adobe Asset Compute non possono essere integrati con il runtime AEM locale fornito da AEM SDK e vengono sviluppati utilizzando una propria catena di strumenti, separata da quella richiesta dalle applicazioni AEM basate sull’archetipo del progetto AEM Maven.
Per estendere i microservizi Asset Compute, è necessario installare i seguenti strumenti nel computer di sviluppo locale.
Istruzioni di configurazione abbreviate
Di seguito sono riportate le istruzioni per l'impostazione di una griglia. I dettagli su questi strumenti di sviluppo sono descritti nelle sezioni dedicate di seguito.
-
Installa Docker Desktop e richiama le immagini Docker richieste:
code language-none $ docker pull openwhisk/action-nodejs-v12:latest $ docker pull adobeapiplatform/adobe-action-nodejs-v12:3.0.22 -
Installa i moduli npm e i plug-in CLI di Adobe I/O richiesti dalla riga di comando:
code language-none $ npm i -g @adobe/aio-cli @openwhisk/wskdebug ngrok --unsafe-perm=true \ && aio plugins:install @adobe/aio-cli-plugin-asset-compute
Per ulteriori informazioni sulle istruzioni di installazione in forma abbreviata, leggere le sezioni seguenti.
Installare Visual Studio Code vscode
Microsoft Visual Studio Code viene utilizzato per lo sviluppo e il debug dei processi di lavoro di Asset Compute. Mentre è possibile utilizzare un altro IDE🔗 compatibile con JavaScript per sviluppare il processo di lavoro, solo Visual Studio Code può essere integrato nel processo di lavoro Asset Compute debug.
Questo tutorial presuppone l'utilizzo del codice di Visual Studio in quanto fornisce la migliore esperienza di sviluppo per estendere Asset Compute.
Installa Docker Desktop docker
Scarica e installa l'ultimo Docker Desktop stabile, necessario per testare e eseguire il debug dei progetti Asset Compute localmente.
Dopo aver installato Docker Desktop, avviarlo e installare le immagini Docker seguenti dalla riga di comando:
$ docker pull openwhisk/action-nodejs-v12:latest
$ docker pull adobeapiplatform/adobe-action-nodejs-v12:3.0.22
Gli sviluppatori su computer Windows devono assicurarsi di utilizzare contenitori Linux per le immagini di cui sopra. I passaggi per passare ai contenitori Linux sono descritti nella documentazione Docker per Windows.
Installare Node.js (e npm) node-js
I processi di lavoro di Asset Compute sono basati su Node.js e pertanto richiedono Node.js 10+ (e npm) per lo sviluppo e la generazione.
- Installa Node.js (e npm) nello stesso modo in cui installa lo sviluppo AEM tradizionale.
Installare Adobe I/O CLI aio
Installare Adobe I/O CLI o aio è un modulo npm per riga di comando (CLI) che facilita l'utilizzo e l'interazione con le tecnologie Adobe I/O e viene utilizzato sia per generare che per sviluppare in locale processi di lavoro Asset Compute personalizzati.
$ npm install -g @adobe/aio-cli
Installare il plug-in Adobe I/O CLI Asset Compute aio-asset-compute
Plug-in Asset Compute di Adobe I/O CLI
$ aio plugins:install @adobe/aio-cli-plugin-asset-compute
Installare wskdebug wskdebug
Scarica e installa il modulo di debug Apache OpenWhisk npm per facilitare il debug locale dei processi di lavoro di Asset Compute.
Per il funzionamento di wskdebug è necessario Visual Studio Code 1.48.x+.
$ npm install -g @openwhisk/wskdebug
Installa ngrok ngrok
Scarica e installa il modulo ngrok npm, che fornisce accesso pubblico al computer di sviluppo locale, per facilitare il debug locale dei processi di lavoro di Asset Compute.
$ npm install -g ngrok --unsafe-perm=true