Configurare il manifest.yml

manifest.yml, che si trova nella directory principale del progetto Asset Compute, descrive tutti i processi di lavoro di questo progetto da distribuire.

Definizione lavoratore predefinita

I processi di lavoro sono definiti come voci di azioni Adobe I/O Runtime in actions e sono costituiti da un set di configurazioni.

I processi di lavoro che accedono ad altre integrazioni Adobe I/O devono impostare la proprietà annotations -> require-adobe-auth su true in quanto espone le credenziali Adobe I/O del processo di lavoro tramite l'oggetto params.auth. Questa operazione è in genere necessaria quando il lavoratore effettua una chiamata alle API di Adobe I/O, come Adobe Photoshop o Lightroom, e può essere attivata per ogni lavoratore.

packages:
  __APP_PACKAGE__:
    license: Apache-2.0
    actions: # the array of workers, since we have a single worker there is only one entry beneath actions
      worker: # the auto-generated worker definition
        function: actions/worker/index.js # the entry point to the worker
        web: 'yes'  # as our worker is invoked over HTTP from AEM Author service
        runtime: 'nodejs:12' # the target nodejs runtime (only 10 and 12 are supported)
        limits:
          concurrency: 10
        annotations:
          require-adobe-auth: true # set to true, to pass through Adobe I/O access token/client id via params.auth in the worker, typically required when the worker calls out to Adobe I/O APIs such as the Adobe Photoshop, or Lightroom.

Definire i limiti

Ogni lavoratore può configurare i limiti per il proprio contesto di esecuzione in Adobe I/O Runtime. Questi valori devono essere regolati in modo da fornire al lavoratore un dimensionamento ottimale, in base al volume, al tasso e al tipo di risorse che calcolerà, nonché al tipo di lavoro svolto.

Rivedi le linee guida per il dimensionamento di Adobe prima di impostare i limiti. I processi di lavoro di Asset Compute possono esaurire la memoria durante l’elaborazione delle risorse, causando l’interruzione dell’esecuzione di Adobe I/O Runtime, in modo da garantire che il processo di lavoro venga ridimensionato in modo appropriato per gestire tutte le risorse candidate.

packages:
  __APP_PACKAGE__:
    license: Apache-2.0
    actions:
      worker:
        function: actions/worker/index.js
        web: 'yes'
        runtime: 'nodejs:12'
        limits: # Allows for the tuning of the worker's performance
          timeout: 60000 # timeout in milliseconds (1 minute)
          memorySize: 512 # memory allocated in MB; if the worker offloads heavy computational work to other Web services this number can be reduced
          concurrency: 10 # adjust based on expected concurrent processing and timeout
        annotations:
          require-adobe-auth: true

Il manifesto finito.yml

L'aspetto finale di manifest.yml è il seguente:

packages:
  __APP_PACKAGE__:
    license: Apache-2.0
    actions:
      worker:
        function: actions/worker/index.js
        web: 'yes'
        runtime: 'nodejs:12'
        limits:
          timeout: 60000 # in ms
          memorySize: 512 # in MB
          concurrency: 10
        annotations:
          require-adobe-auth: true

manifest.yml su Github

Il .manifest.yml finale è disponibile su Github all'indirizzo:

Convalida del manifesto.yml

Una volta aggiornato l'Asset Compute manifest.yml generato, eseguire lo strumento di sviluppo locale e verificare che inizi correttamente con le impostazioni manifest.yml aggiornate.

Per avviare Asset Compute Development Tool per il progetto Asset Compute:

Risoluzione di problemi