Livelli variabili

Le variabili di progetto si applicano a tutti gli ambienti all’interno del progetto. Le variabili di ambiente si applicano a un ambiente o a un ramo specifico. Un ambiente eredita definizioni delle variabili dall’ambiente principale.

Puoi sovrascrivere un valore ereditato definendo la variabile specifica per l’ambiente. Ad esempio, per impostare le variabili per lo sviluppo, definisci i valori delle variabili in .magento.env.yaml nell'ambiente di integrazione. Tutti gli ambienti che si diramano dall’ambiente di integrazione ereditano tali valori. Consulta Configurazione della distribuzione per informazioni dettagliate sulla configurazione dell’ambiente tramite .magento.env.yaml file.

CLI

Per impostare le variabili utilizzando Cloud CLI:

  • Variabili specifiche per il progetto- Per impostare lo stesso valore per tutto ambienti nel progetto. Queste variabili sono disponibili in fase di build e runtime in tutti gli ambienti.

    code language-bash
    magento-cloud variable:create --level project --name <variable-name> --value <variable-value>
    
  • Variabili specifiche per l’ambiente- Per impostare un valore univoco per un specifico ambiente. Queste variabili sono disponibili in fase di runtime e vengono ereditate dagli ambienti figlio. Specifica l’ambiente nel comando utilizzando -e opzione.

    code language-bash
    magento-cloud variable:create --level environment --name <variable-name> --value <variable-value>
    

Dopo aver impostato le variabili specifiche del progetto, è necessario ridistribuire manualmente l’ambiente remoto per rendere effettiva la modifica. Effettua il push dei nuovi commit per attivare una ridistribuzione.

Console

Per impostare le variabili utilizzandoCloud Console:

  1. In Cloud Console, fai clic sull’icona di configurazione a destra della navigazione del progetto.

    Configura progetto {width="36"}

  2. Per impostare una variabile a livello di progetto, in Impostazioni progetto click Variabili.

    Variabili del progetto

  3. Per impostare una variabile a livello di ambiente, nella Ambienti , seleziona un ambiente e fai clic su Variables scheda.

    Scheda Variabili di ambiente

  4. Clic Create variable.

  5. Immetti un nome e un valore per la variabile. Scegli tra le opzioni:

    • Disponibile durante il runtime
    • Disponibile durante la generazione
    • Valore JSON
    • Variabile sensibile (valore nascosto nella console e risposte CLI)
    • Rendi ereditabile (gli ambienti figlio possono ereditare le variabili a livello di ambiente)
  6. Clic Create variable.

note caution
CAUTION
Impostazione di variabili specifiche per l’ambiente in Cloud Console ridistribuisce automaticamente l’ambiente.

Visibilità

Puoi limitare la visibilità di una variabile durante la generazione o il runtime utilizzando --visible-<build|runtime> comando. Inoltre, sono disponibili opzioni per impostare l’ereditarietà e la riservatezza.

Per evitare che una variabile venga visualizzata o ereditata, utilizza le seguenti opzioni:

  • --inheritable false- disattiva l'ereditarietà per gli ambienti figlio. Questo è utile per impostare valori di sola produzione sulla master e consentendo a tutti gli altri ambienti di utilizzare una variabile a livello di progetto con lo stesso nome.
  • --sensitive true- contrassegna la variabile come non leggibile nel Cloud Console. Non è possibile visualizzare la variabile nell’interfaccia utente; tuttavia, è possibile visualizzare la variabile dal contenitore dell’applicazione, come qualsiasi altra variabile.

Di seguito viene illustrato un caso specifico per impedire la visualizzazione o l’ereditarietà di una variabile. È possibile specificare queste opzioni solo nella CLI. Questo caso non riguarda tutte le variabili di ambiente disponibili.

magento-cloud variable:create --name <variable-name> --value <variable-value> --inheritable false --sensitive true

Verificare livelli e valori delle variabili

Puoi visualizzare un elenco delle variabili esistenti utilizzando Cloud CLI.

magento-cloud variables
Variables on the project Project-Name (<project-id>), environment <environment-name>:
+----------------------------+-------------+-------------------------------------------+
| Name                       | Level       | Value                                     |
+----------------------------+-------------+-------------------------------------------+
| env:COMPOSER_AUTH          | project     | {                                         |
|                            |             |    "http-basic": {                        |
|                            |             |       "repo.magento.com": {               |
|                            |             |       "username":                         |
|                            |             | "<public-key>",                           |
|                            |             |       "password":                         |
|                            |             | "<private-key>"                           |
|                            |             |     }                                     |
|                            |             |   }                                       |
|                            |             | }                                         |
| ADMIN_EMAIL                | project     | admin@123.com                             |
| ADMIN_EMAIL                | environment | admin@123.com                             |
| ADMIN_PASSWORD             | environment | password                                  |
| ADMIN_URL                  | environment | admin123                                  |
| ADMIN_USERNAME             | environment | admin                                     |
| php:newrelic.license       | environment | xxxx71fb030366182117f955a22e4baf8exxxxxx  |
+----------------------------+-------------+-------------------------------------------+
recommendation-more-help
05f2f56e-ac5d-4931-8cdb-764e60e16f26