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 di variabili dall'ambiente padre.

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 nel file .magento.env.yaml nell'ambiente di integrazione. Tutti gli ambienti che si diramano dall’ambiente di integrazione ereditano tali valori. Per informazioni dettagliate sulla configurazione dell'ambiente tramite il file .magento.env.yaml, vedere Configurazione della distribuzione.

CLI

Per impostare le variabili utilizzando Cloud CLI:

  • Variabili specifiche per il progetto - Per impostare lo stesso valore per tutti gli 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 dell'ambiente - Per impostare un valore univoco per un ambiente specifico. Queste variabili sono disponibili in fase di runtime e vengono ereditate dagli ambienti figlio. Specificare l'ambiente nel comando utilizzando l'opzione -e.

    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 sul lato destro della navigazione del progetto.

    Configura progetto {width="36"}

  2. Per impostare una variabile a livello di progetto, in Impostazioni progetto fare clic su Variabili.

    Variabili progetto

  3. Per impostare una variabile a livello di ambiente, nell'elenco Ambienti selezionare un ambiente e fare clic sulla scheda Variables.

    Scheda Variabili di ambiente

  4. Fare clic su 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. Fare clic su Create variable.

note caution
CAUTION
L'impostazione delle variabili specifiche dell'ambiente in Cloud Console ridistribuisce automaticamente l'ambiente.

Visibilità

È possibile limitare la visibilità di una variabile durante la compilazione o il runtime utilizzando il comando --visible-<build|runtime>. 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: disabilita l'ereditarietà per gli ambienti figlio. Questo è utile per impostare valori di sola produzione sul ramo master e consentire 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 in 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