Configurare l’ambiente di sviluppo locale
I progetti di Asset compute di Adobe non possono essere integrati con il runtime AEM locale fornito dall’SDK dell’AEM e sono sviluppati utilizzando una propria catena di strumenti, separata da quella richiesta dalle applicazioni AEM basate sull’archetipo di progetto Maven dell’AEM.
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 -
Installare i moduli npm richiesti e i plug-in CLI di Adobe I/O 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 è utilizzato per lo sviluppo e il debug di 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 l'estensione di Asset Compute.
Installa Docker Desktop docker
Scarica e installa l'ultimo Docker Desktop stabile, necessario per testare e debug progetti di 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 avviene per 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 localmente processi di lavoro Asset Compute personalizzati.
$ npm install -g @adobe/aio-cli
Installare il plug-in di Asset compute CLI Adobe I/O aio-asset-compute
Il plug-in di Asset compute CLI Adobe I/O
$ 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 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 Asset Compute.
$ npm install -g ngrok --unsafe-perm=true