Umgebungsvariablen in Cloud Manager environment-variables
Standardumgebungsvariablen können über Cloud Manager konfiguriert und verwaltet werden. Sie werden für die Laufzeitumgebung bereitgestellt und können in OSGi-Konfigurationen verwendet werden.
Umgebungsvariablen können umgebungsspezifische Werte oder Umgebungsgeheimnisse sein. Dies ist davon abhängig, was geändert wird.
Informationen zu Umgebungsvariablen overview
Umgebungsvariablen bieten Benutzenden von AEM as a Cloud Service zahlreiche Vorteile, darunter die Folgenden:
- Sie ermöglichen es, das Verhalten Ihres Codes und Ihres Programms je nach Kontext und Umgebung zu variieren. Beispielsweise können sie verwendet werden, um in der Entwicklungsumgebung andere Konfigurationen als in der Produktions- oder Staging-Umgebung zu ermöglichen, um kostspielige Fehler zu vermeiden.
- Sie müssen nur einmal konfiguriert und eingerichtet werden und können bei Bedarf aktualisiert und gelöscht werden.
- Ihre Werte können jederzeit aktualisiert werden und werden sofort wirksam, ohne dass Code-Änderungen oder -Bereitstellungen erforderlich sind.
- Sie können Code von der Konfiguration trennen und die Notwendigkeit beseitigen, vertrauliche Informationen in die Versionskontrolle einzubeziehen.
- Sie verbessern die Sicherheit des AEM as a Cloud Service-Programms, da sie sich außerhalb des Codes befinden.
Zu den typischen Anwendungsfällen für die Verwendung von Umgebungsvariablen zählen die Folgenden:
- Verbinden des AEM-Programms mit verschiedenen externen Endpunkten
- Verwenden einer Referenz beim Speichern von Kennwörtern (also nicht direkt die Code-Basis)
- Vorhandensein mehrerer Entwicklungsumgebungen in einem Programm, wobei sich einige Konfigurationen von einer Umgebung zur nächsten unterscheiden
Hinzufügen einer Umgebungsvariablen add-variables
Wenn Sie mehrere Variablen hinzufügen möchten, empfiehlt Adobe, die erste Variable hinzuzufügen und dann im Dialogfeld Umgebungskonfiguration die Schaltfläche
Um Umgebungsvariablen hinzufügen, aktualisieren oder löschen zu können, müssen Sie Mitglied der Rolle Bereitstellungs-Manager sein.
So fügen Sie eine Umgebungsvariable hinzu:
-
Melden Sie sich unter my.cloudmanager.adobe.com bei Cloud Manager an und wählen Sie die entsprechende Organisation aus.
-
Wählen Sie in der Konsole Meine Programme das Programm aus, das Sie verwalten möchten.
-
Klicken Sie im Seitenmenü auf Umgebungen.
-
Wählen Sie auf der Seite Umgebungen eine Zeile in der Tabelle aus, die die Umgebung enthält, für die Sie eine Umgebungsvariable hinzufügen möchten.
-
Klicken Sie auf der Seite mit den Umgebungsdetails auf die Registerkarte Konfiguration.
-
Klicken Sie auf
Wenn Sie zum ersten Mal eine Umgebungsvariable hinzufügen, klicken Sie in der Mitte der Seite auf Konfiguration hinzufügen. -
Geben Sie im Dialogfeld Umgebungskonfiguration die Details in die erste Zeile der Tabelle ein.
table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 Feld Beschreibung Name Ein eindeutiger Name der Konfigurationsvariablen. Er identifiziert die spezifische Variable, die in der Umgebung verwendet wird, und muss den folgenden Namenskonventionen entsprechen:
- Variablen dürfen nur alphanumerische Zeichen und einen Unterstrich (
_
) enthalten. - Pro Umgebung sind maximal 200 Variablen zulässig.
- Jeder Name darf maximal 100 Zeichen lang sein.
Wert Der Wert, den die Variable enthält. Angewendeter Schritt Wählen Sie den Dienst aus, für den die Variable gilt. Wählen Sie Alle aus, damit die Variable auf alle Dienste angewendet wird.
- Alle
- Autor
- Veröffentlichen
- Vorschau
Typ Legen Sie fest, ob die Variable eine normale Variable oder ein Geheimnis sein soll. - Variablen dürfen nur alphanumerische Zeichen und einen Unterstrich (
-
Klicken Sie auf
Fügen Sie nach Bedarf weitere Variablen hinzu.
-
Klicken Sie auf Speichern.
Oben rechts in der Tabelle wird ein Wartekreisel mit dem Status Aktualisierung läuft angezeigt. Links von neu hinzugefügten Variablen wird ebenfalls ein Wartekreisel angezeigt. Diese Status zeigen an, dass die Umgebung mit der Konfiguration aktualisiert wird. Nach Abschluss ist die neue Umgebungsvariable in der Tabelle sichtbar.
Aktualisieren einer Umgebungsvariablen update-variables
Nachdem Sie Umgebungsvariablen erstellt haben, können Sie sie mit
Wenn mehrere Variablen aktualisiert werden sollen, empfiehlt Adobe, das Dialogfeld Umgebungskonfiguration zu verwenden, um alle erforderlichen Variablen gleichzeitig zu aktualisieren, bevor Sie auf Speichern klicken. Auf diese Weise können Sie sie mit nur einer Aktualisierung zur Umgebung hinzufügen.
So aktualisieren Sie eine Umgebungsvariable:
-
Melden Sie sich unter my.cloudmanager.adobe.com bei Cloud Manager an und wählen Sie die entsprechende Organisation aus.
-
Wählen Sie in der Konsole Meine Programme das Programm aus, das Sie verwalten möchten.
-
Klicken Sie im Seitenmenü auf Umgebungen.
-
Wählen Sie auf der Seite Umgebungen eine Zeile in der Tabelle aus, die die Umgebung enthält, für die eine Variable aktualisiert werden soll.
-
Klicken Sie auf der Seite mit den Umgebungsdetails auf die Registerkarte Konfiguration.
-
Klicken Sie auf
-
Klicken Sie im Dialogfeld Umgebungskonfiguration auf
-
Klicken Sie im Dropdown-Menü auf Bearbeiten.
-
Aktualisieren Sie den Wert der Umgebungsvariablen nach Bedarf.
Beim Bearbeiten von Geheimnissen kann der jeweilige Wert nur aktualisiert, aber nicht angezeigt werden. -
Führen Sie einen der folgenden Schritte aus:
- Klicken Sie auf
- Klicken Sie auf
- Klicken Sie auf
-
Klicken Sie auf Speichern.
Oben rechts in der Tabelle wird ein Wartekreisel mit dem Status Aktualisierung läuft angezeigt. Links von aktualisierten Variablen wird ebenfalls ein Wartekreisel angezeigt. Diese Status zeigen an, dass die Umgebung mit der Konfiguration aktualisiert wird. Nach Abschluss ist die aktualisierte Umgebungsvariable in der Tabelle sichtbar.
Löschen einer Umgebungsvariablen delete-env-variable
- Melden Sie sich unter my.cloudmanager.adobe.com bei Cloud Manager an und wählen Sie die entsprechende Organisation aus.
- Wählen Sie in der Konsole Meine Programme das Programm aus, das Sie verwalten möchten.
- Klicken Sie im Seitenmenü auf Umgebungen.
- Wählen Sie auf der Seite Umgebungen eine Zeile in der Tabelle aus, die die Umgebung enthält, für die eine Variable aktualisiert werden soll.
- Klicken Sie auf der Seite mit den Umgebungsdetails auf die Registerkarte Konfiguration.
- Klicken Sie auf
- Klicken Sie im Dialogfeld Umgebungskonfiguration auf
- Klicken Sie im Dropdown-Menü auf Löschen, um die Variable umgehend zu entfernen.
- Klicken Sie auf Speichern.
Verwendung von Umgebungsvariablen using
Umgebungsvariablen können Ihre pom.xml
-Konfigurationen sicherer und flexibler machen. So müssen beispielsweise Passwörter nicht fest kodiert werden, und Ihre Konfiguration kann auf der Grundlage der Werte in Umgebungsvariablen angepasst werden.
Sie können wie folgt auf Umgebungsvariablen und Geheimnisse über XML zugreifen:
${env.VARIABLE_NAME}
Ein Beispiel für die Verwendung beider Arten von Variablen in einer Datei pom.xml
finden Sie unter Einrichten eines Projekts.
Weitere Informationen finden Sie in der offiziellen Maven-Dokumentation.
Verfügbarkeit von Umgebungsvariablen availability
Umgebungsvariablen können an mehreren Stellen wie folgt verwendet werden:
Im Dispatcher können nur reguläre Umgebungsvariablen verwendet werden.
- Geheimnisse können nicht verwendet werden.
- Umgebungsvariablen können nicht in
IfDefine
-Anweisungen verwendet werden. - Validieren Sie die Verwendung von Umgebungsvariablen lokal im Dispatcher, bevor Sie sie bereitstellen.