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 una serie di vantaggi per gli utenti di AEM as a Cloud Service, ad esempio:

  • 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 impostate una sola volta e possono essere aggiornate ed eliminate secondo necessità.
  • I valori delle variabili possono essere aggiornati in qualsiasi momento e avere effetto immediato senza la necessità di alcuna modifica o distribuzione del codice.
  • Possono separare il codice dalla configurazione e rimuovere il necessario per includere informazioni sensibili nel controllo della versione.
  • Migliorano la sicurezza dell’applicazione AEM as a Cloud Service poiché si trovano all’esterno del 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é direttamente nella base di codice
  • Quando in un programma sono presenti più ambienti di sviluppo e alcune configurazioni differiscono tra i vari ambienti

Aggiungere una variabile di ambiente add-variables

Se desideri aggiungere più variabili, l'Adobe consiglia di aggiungere la prima variabile, quindi di utilizzare l'icona Aggiungi Aggiungi nella finestra di dialogo Configurazione ambiente per aggiungere altre variabili. Questo metodo consente di aggiungerli all’ambiente con un solo aggiornamento.

Per aggiungere, aggiornare o eliminare variabili di ambiente, è necessario essere membri del ruolo Responsabile della distribuzione.

Per aggiungere una variabile di ambiente:

  1. Accedi a Cloud Manager all’indirizzo my.cloudmanager.adobe.com e seleziona l’organizzazione appropriata.

  2. Nella console Programmi selezionare quello che si desidera gestire.

  3. Dal menu laterale, fai clic su Ambienti.

  4. Nella pagina Ambienti selezionare una riga della tabella contenente l'ambiente per il quale si desidera aggiungere una variabile di ambiente.

  5. Nella pagina dei dettagli dell'ambiente fare clic sulla scheda Configurazione.

  6. Fai clic su Aggiungi/Aggiorna - Icona Aggiungi cerchio Aggiungi/Aggiorna.
    Se stai aggiungendo una variabile di ambiente per la prima volta, fai clic su Aggiungi configurazione al centro della pagina.

    Scheda Configurazione

  7. 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
    • Autore
    • Publish
    • Anteprima
    Tipo Seleziona se la variabile è normale o segreta.

    Aggiunta di una variabile

  8. Fai clic sull'icona Aggiungi Aggiungi.

    Aggiungi ulteriori variabili in base alle esigenze.

  9. 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.

Aggiornamento delle variabili

Aggiornare una variabile di ambiente update-variables

Dopo aver creato le variabili di ambiente, è possibile aggiornarle utilizzando Aggiungi/Aggiorna - Icona Aggiungi cerchio Aggiungi/Aggiorna per aprire la finestra di dialogo Configurazione ambiente.

Adobe Se si desidera aggiornare più variabili, si consiglia di utilizzare la finestra di dialogo Configurazione ambiente per aggiornare tutte le variabili necessarie contemporaneamente prima di fare clic su Salva. In questo modo è possibile aggiungerle all’ambiente con un unico aggiornamento.

Per aggiornare una variabile di ambiente:

  1. Accedi a Cloud Manager all’indirizzo my.cloudmanager.adobe.com e seleziona l’organizzazione appropriata.

  2. Nella console Programmi selezionare quello che si desidera gestire.

  3. Dal menu laterale, fai clic su Ambienti.

  4. Nella pagina Ambienti selezionare una riga della tabella contenente l'ambiente per il quale si desidera aggiornare una variabile.

  5. Nella pagina dei dettagli dell'ambiente fare clic sulla scheda Configurazione.

  6. Fai clic su Aggiungi/Aggiorna - Icona Aggiungi cerchio Aggiungi/Aggiorna.

  7. Nella finestra di dialogo Configurazione ambiente, fai clic su Puntini di sospensione - Icona Altro nell'ultima colonna della riga della variabile che desideri modificare.

  8. Nel menu a discesa, fare clic su Modifica.

    Modifica o elimina variabile

  9. Se necessario, aggiorna il valore della variabile di ambiente.
    Quando si modifica un segreto, il valore può essere solo aggiornato e non visualizzato.

    Modifica della variabile

  10. Effettua una delle operazioni seguenti:

    • Fai clic su Applica - icona segno di spunta per applicare la modifica.
    • Fai clic sull'icona Annulla per annullare la modifica.
  11. 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

  1. Accedi a Cloud Manager all’indirizzo my.cloudmanager.adobe.com e seleziona l’organizzazione appropriata.
  2. Nella console Programmi selezionare quello che si desidera gestire.
  3. Dal menu laterale, fai clic su Ambienti.
  4. Nella pagina Ambienti selezionare una riga della tabella contenente l'ambiente per il quale si desidera aggiornare una variabile.
  5. Nella pagina dei dettagli dell'ambiente fare clic sulla scheda Configurazione.
  6. Fai clic su Aggiungi/Aggiorna - Icona Aggiungi cerchio Aggiungi/Aggiorna.
  7. Nella finestra di dialogo Configurazione ambiente, fai clic su Puntini di sospensione - Icona Altro nell'ultima colonna della riga della variabile che desideri modificare.
  8. Nel menu a discesa, fare clic su Elimina per rimuovere immediatamente la variabile.
  9. 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, non è necessario che le password siano hardcoded e la configurazione può essere adattata in base ai valori contenuti nelle variabili di ambiente.

Puoi accedere alle variabili di ambiente e ai segreti tramite XML nel modo seguente:

${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:

Dove è possibile utilizzare le variabili di ambiente
Descrizione
Authoring, Anteprima e Pubblicazione
Negli ambienti di authoring, anteprima e pubblicazione è possibile utilizzare sia le normali variabili di ambiente che i segreti.
Dispatcher

Solo le normali variabili di ambiente possono essere utilizzate con Dispatcher.

  • I segreti non possono essere utilizzati.
  • Le variabili di ambiente non possono essere utilizzate in IfDefine direttive.
  • Convalida l’utilizzo di variabili di ambiente con il Dispatcher localmente prima della distribuzione.
Configurazioni OSGi
Sia le normali variabili di ambiente che i segreti possono essere utilizzati nelle configurazioni OSGi.
Variabili delle pipeline
Oltre alle variabili di ambiente, sono presenti anche variabili di pipeline, che vengono esposte durante la fase di creazione. Ulteriori informazioni sulle variabili della pipeline in Ambiente di compilazione.
recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab