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.

  1. Installa Docker Desktop e richiama le immagini Docker richieste:

    $ docker pull openwhisk/action-nodejs-v12:latest
$ docker pull adobeapiplatform/adobe-action-nodejs-v12:3.0.22

  2. Installare Visual Studio Code

  3. Installare Node.js 10+

  4. Installare i moduli npm richiesti e i plug-in CLI di Adobe I/O dalla riga di comando:

    $ npm i -g @adobe/aio-cli@7.1.0 @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

Codice Microsoft Visual Studio viene utilizzato per lo sviluppo e il debug di processi di lavoro Asset compute. Mentre altri IDE compatibile con JavaScript può essere utilizzato per sviluppare il processo di lavoro, solo Visual Studio Code può essere integrato debug lavoratore Asset compute.

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

Scarica e installa la versione più recente Docker Desktop, in quanto è necessario per test e debug Asset compute di progetti locali.

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 in Documentazione di Docker per Windows.

Installare Node.js (e npm)

I lavoratori Asset compute sono Node.jse quindi richiedono Node.js 10+ (e npm) per lo sviluppo e la generazione.

Installare Adobe I/O CLI

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 ed è utilizzato sia per generare che per sviluppare localmente processi di lavoro Asset compute personalizzati.

$ npm install -g @adobe/aio-cli@7.1.0

È richiesto Adobe I/O CLI versione 7.1.0. Le versioni successive di Adobe I/O CLI non sono al momento supportate.

Installare il plug-in di Asset compute CLI Adobe I/O

Il Plug-in Adobe I/O CLI Asset compute

$ aio plugins:install @adobe/aio-cli-plugin-asset-compute

Installare wskdebug

Scarica e installa Debug Apache OpenWhisk modulo npm per facilitare il debug locale dei processi di lavoro Asset compute.

Visual Studio Code 1.48.x+ è richiesto per wskdebug al lavoro.

$ npm install -g @openwhisk/wskdebug

Installa ngrok

Scarica e installa ngrok modulo 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

In questa pagina