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:

    code language-none
    $ 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:

    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

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 docker

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) node-js

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 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 ed è 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 Adobe I/O CLI Asset compute

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

Installare wskdebug 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 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
recommendation-more-help
4859a77c-7971-4ac9-8f5c-4260823c6f69