Variablenebenen
Projektvariablen gelten für alle Umgebungen innerhalb des Projekts. Umgebungsvariablen gelten für eine bestimmte Umgebung oder Verzweigung. Eine Umgebung übernimmt Variablendefinitionen aus der übergeordneten Umgebung.
Sie können einen übernommenen Wert überschreiben, indem Sie die Variable speziell für die Umgebung definieren. Um beispielsweise Variablen für die Entwicklung festzulegen, definieren Sie die Variablenwerte in der Datei .magento.env.yaml in der Integrationsumgebung. Diese Werte werden von allen in der Integrationsumgebung verzweigten Umgebungen übernommen. Weitere Informationen zum Konfigurieren Ihrer Umgebung mit der Datei .magento.env.yaml finden Sie unter Bereitstellungskonfiguration .
So legen Sie Variablen mithilfe der Cloud CLI fest:
-
Projektspezifische Variablen - Um denselben Wert für alle Umgebungen in Ihrem Projekt festzulegen. Diese Variablen sind beim Erstellen und zur Laufzeit in allen Umgebungen verfügbar.
code language-bash magento-cloud variable:create --level project --name <variable-name> --value <variable-value> -
Umgebungsspezifische Variablen - Um einen eindeutigen Wert für eine spezifische -Umgebung festzulegen. Diese Variablen sind zur Laufzeit verfügbar und werden von untergeordneten Umgebungen übernommen. Geben Sie die Umgebung in Ihrem Befehl mit der Option
-ean.code language-bash magento-cloud variable:create --level environment --name <variable-name> --value <variable-value>
Nachdem Sie projektspezifische Variablen festgelegt haben, müssen Sie die Remote-Umgebung manuell neu bereitstellen, damit die Änderung wirksam wird. Übergeben Sie die neuen Zusagen, um eine Neuimplementierung Trigger.
So legen Sie Variablen mithilfe desCloud Console fest:
-
Klicken Sie im Ordner "Cloud Console"auf das Konfigurationssymbol auf der rechten Seite der Projektnavigation.
-
Um eine Variable auf Projektebene festzulegen, klicken Sie unter Projekteinstellungen auf Variablen.
-
Um eine Umgebungsvariable festzulegen, wählen Sie in der Liste Umgebungen eine Umgebung aus und klicken Sie auf die Registerkarte Variables .
-
Klicken Sie auf Create variable.
-
Geben Sie einen Namen und einen Wert für die Variable an. Wählen Sie aus den Optionen aus:
- Zur Laufzeit verfügbar
- Verfügbar während der Buildzeit
- JSON-Wert
- Sensitive Variable (Wert in der Konsole ausgeblendet und CLI-Antworten)
- Vererbbar (untergeordnete Umgebungen können Variablen auf Umgebungsebene übernehmen)
-
Klicken Sie auf Create variable.
| note caution |
|---|
| CAUTION |
| Durch das Festlegen umgebungsspezifischer Variablen in Cloud Console wird die Umgebung automatisch erneut bereitgestellt. |
Sichtbarkeit
Mit dem Befehl --visible-<build|runtime> können Sie die Sichtbarkeit einer Variablen während der Build- oder Laufzeitumgebung einschränken. Außerdem gibt es Optionen zum Festlegen von Vererbung und Empfindlichkeit.
Verwenden Sie die folgenden Optionen, um zu verhindern, dass eine Variable angezeigt oder vererbt wird:
--inheritable false- Deaktiviert die Vererbung für untergeordnete Umgebungen. Dies ist nützlich, um reine Produktionswerte für die Verzweigungmasterfestzulegen und allen anderen Umgebungen die Verwendung einer Variablen auf Projektebene mit demselben Namen zu ermöglichen.--sensitive true- markiert die Variable als nicht lesbar im Cloud Console. Sie können die Variable nicht in der Benutzeroberfläche anzeigen. Sie können die Variable jedoch wie jede andere Variable auch im Anwendungscontainer anzeigen.
Im Folgenden wird ein spezieller Fall veranschaulicht, um zu verhindern, dass eine Variable gesehen oder vererbt wird. Sie können diese Optionen nur in der CLI angeben. Dieser Fall bezieht sich nicht auf alle verfügbaren Umgebungsvariablen.
magento-cloud variable:create --name <variable-name> --value <variable-value> --inheritable false --sensitive true
Überprüfen von Variablenebenen und -werten
Mithilfe der Cloud-CLI können Sie eine Liste der vorhandenen Variablen anzeigen.
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 |
+----------------------------+-------------+-------------------------------------------+