Umgebungsvariablen in Cloud Manager environment-variables
Standardumgebungsvariablen können über Cloud Manager konfiguriert und verwaltet werden. Sie werden der 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 verschiedene Vorteile für AEM as a Cloud Service-Benutzende, 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 von AEM as a Cloud Service-Anwendungen, da sie außerhalb der Codebasis existieren.
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, anstatt sie direkt in der Code-Basis zu speichern.
- In einem Programm sind mehrere Entwicklungsumgebungen vorhanden, und einige Konfigurationen unterscheiden sich von einer Umgebung zur anderen.
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 hinzuzufügen, zu aktualisieren oder zu löschen, 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 Service 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. Mit diesem Ansatz können Sie sie mit einer einzigen Umgebungsaktualisierung aktualisieren.
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. Beispielsweise benötigen Passwörter keine hartcodierten Werte, und Ihre Konfiguration kann an Umgebungsvariablenwerte 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.