Implementare in Adobe I/O Runtime
I progetti Asset Compute e i relativi processi di lavoro devono essere distribuiti in Adobe I/O Runtime tramite Adobe I/O CLI, affinché possa essere utilizzato da AEM as a Cloud Service.
Durante la distribuzione in Adobe I/O Runtime per l’utilizzo da parte dei servizi AEM as a Cloud Service Author sono necessarie solo due variabili di ambiente:
AIO_runtime_namespace
punti a cui distribuire App Builder WorkspaceAIO_runtime_auth
sono le credenziali di autenticazione dell'area di lavoro App Builder
Le altre variabili standard definite nel file .env
vengono fornite in modo implicito da AEM as a Cloud Service quando richiama il processo di lavoro Asset Compute.
Area di lavoro sviluppo
Poiché il progetto è stato generato utilizzando aio app init
utilizzando l'area di lavoro Development
, AIO_runtime_namespace
viene impostato automaticamente su 81368-wkndaemassetcompute-development
con AIO_runtime_auth
corrispondente nel file .env
locale. Se nella directory utilizzata per il comando di distribuzione è presente un file .env
, vengono utilizzati i relativi valori, a meno che non vengano sostituiti tramite un'esportazione della variabile a livello di sistema operativo, ovvero nel modo in cui vengono indirizzate le aree di lavoro stage e produzione.
Per distribuire nell'area di lavoro, definire nel file .env
dei progetti:
- Apri la riga di comando nella directory principale del progetto di Asset compute
- Esegui il comando
aio app deploy
- Eseguire il comando
aio app get-url
per ottenere l'URL del processo di lavoro da utilizzare nel profilo di elaborazione di AEM as a Cloud Service per fare riferimento a questo processo di lavoro Asset compute personalizzato. Se il progetto contiene più lavoratori, vengono elencati gli URL discreti per ciascun lavoratore.
Se gli ambienti di sviluppo locali e gli ambienti di sviluppo AEM as a Cloud Service utilizzano distribuzioni Asset Compute separate, le distribuzioni in AEM as a Cloud Service Dev possono essere gestite nello stesso modo delle distribuzioni di staging e produzione.
Aree di lavoro di staging e produzione stage-and-production
La distribuzione nelle aree di lavoro di staging e produzione viene in genere eseguita dal sistema CI/CD scelto. Il progetto di Asset compute deve essere distribuito in modo discreto in ogni Workspace (Stage e poi Produzione).
L'impostazione delle variabili di ambiente vere sostituisce i valori per le variabili con lo stesso nome in .env
.
L’approccio generale, in genere automatizzato da un sistema CI/CD, per la distribuzione negli ambienti di staging e produzione è il seguente:
- Verificare che il modulo npm CLI Adobe I/O e il plug-in Asset Compute siano installati
- Consulta il progetto di Asset compute da distribuire da Git
- Imposta le variabili di ambiente con i valori corrispondenti all’area di lavoro di destinazione (Stage o Produzione)
- Le due variabili richieste sono
AIO_runtime_namespace
eAIO_runtime_auth
e vengono ottenute per area di lavoro in Adobe I/O Developer Console tramite la funzione Scarica tutto di Workspace.
- Le due variabili richieste sono
I valori di queste chiavi possono essere impostati eseguendo i comandi di esportazione dalla riga di comando:
$ export AIO_runtime_namespace=81368-wkndaemassetcompute-stage
$ export AIO_runtime_auth=27100f9f-2676-4cce-b73d-b3fb6bac47d1:0tDu307W6MboQf5VWB1BAK0RHp8xWqSy1CQc3lKe7f63o3aNtAu0Y3nAmN56502W
Se i processi di lavoro Asset compute richiedono altre variabili, ad esempio l’archiviazione cloud, queste devono essere esportate anche come variabili di ambiente.
- Una volta impostate tutte le variabili di ambiente per la distribuzione nell’area di lavoro di destinazione, esegui il comando deploy:
aio app deploy
- Gli URL del lavoratore a cui fa riferimento il profilo di elaborazione di AEM as a Cloud Service sono disponibili anche tramite:
aio app get-url
.
Se la versione del progetto di Asset compute cambia, anche gli URL del lavoratore cambiano in modo da riflettere la nuova versione e l’URL dovrà essere aggiornato nei Profili di elaborazione.
Provisioning API di Workspace workspace-api-provisioning
Quando il progetto App Builder nell'Adobe I/O è stato configurato per supportare lo sviluppo locale, è stata creata una nuova area di lavoro Sviluppo e sono state aggiunte API Asset compute, Eventi di I/O e API Gestione eventi I/O.
Le API Asset Compute, I/O Events e I/O Events Management vengono aggiunte in modo esplicito solo alle aree di lavoro utilizzate per lo sviluppo locale. Le aree di lavoro che si integrano (esclusivamente) con gli ambienti AEM as a Cloud Service non richiedono l'aggiunta esplicita di queste API, in quanto sono rese naturalmente disponibili per AEM as a Cloud Service.