Variabili di ambiente in Cloud Manager environment-variables
È possibile configurare e gestire le variabili di ambiente standard tramite Cloud Manager. Vengono fornite all’ambiente di runtime e possono essere utilizzate nelle configurazioni OSGi.
Le variabili di ambiente possono essere valori specifici dell’ambiente o segreti dell’ambiente, in base alle modifiche apportate.
Informazioni sulle variabili di ambiente overview
Le variabili di ambiente offrono diversi vantaggi per gli utenti di AEM as a Cloud Service, tra cui:
- Consentono di modificare il comportamento del codice e dell’applicazione in base al contesto e all’ambiente. Ad esempio, possono essere utilizzati per abilitare diverse configurazioni nell’ambiente di sviluppo rispetto agli ambienti di produzione o di staging per evitare costosi errori.
- Devono essere configurate e configurate una sola volta e possono essere aggiornate ed eliminate quando necessario.
- I loro valori possono essere aggiornati in qualsiasi momento ed avere effetto immediato senza richiedere modifiche o implementazioni del codice.
- Possono separare il codice dalla configurazione e rimuovere il necessario per includere informazioni sensibili nel controllo della versione.
- Migliorano la sicurezza delle applicazioni AEM as a Cloud Service perché esistono al di fuori della base di codice.
I casi d’uso tipici per l’utilizzo delle variabili di ambiente includono:
- Collegamento dell’applicazione AEM a diversi endpoint esterni.
- Utilizzo di un riferimento durante l’archiviazione delle password anziché memorizzarle direttamente nella base di codice.
- In un programma sono presenti più ambienti di sviluppo e alcune configurazioni differiscono da un ambiente all’altro.
Aggiungere una variabile di ambiente add-variables
Se desideri aggiungere più variabili, Adobe consiglia di aggiungere la prima variabile e quindi di utilizzare l’icona
Per aggiungere, aggiornare o eliminare variabili di ambiente, è necessario essere membri del ruolo Responsabile della distribuzione.
Per aggiungere una variabile di ambiente:
-
Accedi a Cloud Manager all’indirizzo my.cloudmanager.adobe.com e seleziona l’organizzazione appropriata.
-
Nella console Programmi selezionare quello che si desidera gestire.
-
Dal menu laterale, fai clic su Ambienti.
-
Nella pagina Ambienti selezionare una riga della tabella contenente l’ambiente per il quale si desidera aggiungere una variabile di ambiente.
-
Nella pagina dei dettagli dell’ambiente fare clic sulla scheda Configurazione.
-
Fai clic su
Se stai aggiungendo una variabile di ambiente per la prima volta, fai clic su Aggiungi configurazione al centro della pagina.
-
Nella finestra di dialogo Configurazione ambiente, immettere i dettagli nella prima riga della tabella.
table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 Campo Descrizione Nome Nome univoco della variabile di configurazione. Identifica la variabile specifica utilizzata nell’ambiente. Deve rispettare le seguenti convenzioni di denominazione:
- Le variabili possono contenere solo caratteri alfanumerici e il carattere di sottolineatura (
_). - Esiste un limite di 200 variabili per ambiente.
- Ogni nome non può contenere più di 100 caratteri.
Valore Valore contenuto nella variabile. Passaggio applicato Seleziona il servizio a cui si applica la variabile. Selezionare Tutti per applicare la variabile a tutti i servizi.
- Tutti
- Authoring
- Pubblica
- Anteprima
Tipo Seleziona se la variabile è normale o segreta. 
- Le variabili possono contenere solo caratteri alfanumerici e il carattere di sottolineatura (
-
Fai clic sull’icona
Aggiungi ulteriori variabili in base alle esigenze.
-
Fai clic su Salva.
Nell’angolo superiore destro della tabella viene visualizzato un rotatore con stato Aggiornamento. A sinistra delle variabili appena aggiunte viene visualizzato anche un rotatore. Questi stati indicano che l’ambiente è in fase di aggiornamento con la configurazione. Al termine dell’operazione, la nuova variabile di ambiente è visibile nella tabella.
Aggiornare una variabile di ambiente update-variables
Dopo aver creato le variabili di ambiente, è possibile aggiornarle utilizzando
Se si desidera aggiornare più variabili, Adobe consiglia di utilizzare la finestra di dialogo Configurazione ambiente per aggiornare tutte le variabili necessarie contemporaneamente prima di fare clic su Salva. Questo approccio consente di aggiornarli con un singolo aggiornamento dell’ambiente.
Per aggiornare una variabile di ambiente:
-
Accedi a Cloud Manager all’indirizzo my.cloudmanager.adobe.com e seleziona l’organizzazione appropriata.
-
Nella console Programmi selezionare quello che si desidera gestire.
-
Dal menu laterale, fai clic su Ambienti.
-
Nella pagina Ambienti selezionare una riga della tabella contenente l’ambiente per il quale si desidera aggiornare una variabile.
-
Nella pagina dei dettagli dell’ambiente fare clic sulla scheda Configurazione.
-
Fai clic su
-
Nella finestra di dialogo Configurazione ambiente, fai clic su
-
Nel menu a discesa, fare clic su Modifica.
-
Se necessario, aggiorna il valore della variabile di ambiente.
Quando si modifica un segreto, il valore può essere solo aggiornato e non visualizzato.
-
Effettua una delle seguenti operazioni:
- Fai clic su
- Fai clic sull’icona
- Fai clic su
-
Fai clic su Salva.
Nell’angolo superiore destro della tabella viene visualizzato un rotatore con stato Aggiornamento. A sinistra di qualsiasi variabile aggiornata viene visualizzato anche un rotatore. Questi stati indicano che l’ambiente è in fase di aggiornamento con la configurazione. Al termine, la variabile di ambiente aggiornata è visibile nella tabella.
Eliminare una variabile di ambiente delete-env-variable
- Accedi a Cloud Manager all’indirizzo my.cloudmanager.adobe.com e seleziona l’organizzazione appropriata.
- Nella console Programmi selezionare quello che si desidera gestire.
- Dal menu laterale, fai clic su Ambienti.
- Nella pagina Ambienti selezionare una riga della tabella contenente l’ambiente per il quale si desidera aggiornare una variabile.
- Nella pagina dei dettagli dell’ambiente fare clic sulla scheda Configurazione.
- Fai clic su
- Nella finestra di dialogo Configurazione ambiente, fai clic su
- Nel menu a discesa, fare clic su Elimina per rimuovere immediatamente la variabile.
- Fai clic su Salva.
Utilizzo delle variabili di ambiente using
Le variabili di ambiente possono aumentare sicurezza e flessibilità delle configurazioni pom.xml. Ad esempio, le password non richiedono valori hardcoded e la configurazione può adattarsi ai valori delle variabili di ambiente.
Puoi accedere alle variabili di ambiente e ai segreti tramite XML come segue:
${env.VARIABLE_NAME}
Per un esempio di utilizzo di entrambi i tipi di variabili in un file pom.xml, vedere Configurazione del progetto.
Per ulteriori informazioni, consulta anche la documentazione Maven ufficiale.
Disponibilità delle variabili di ambiente availability
Le variabili di ambiente possono essere utilizzate in diverse posizioni, come segue:
Solo le variabili di ambiente normali possono essere utilizzate con il Dispatcher.
- I segreti non possono essere utilizzati.
- Le variabili di ambiente non possono essere utilizzate in
IfDefinedirettive. - Convalida l’utilizzo di variabili di ambiente con il Dispatcher localmente prima della distribuzione.