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.
Über Umgebungsvariablen overview
Umgebungsvariablen bieten eine Vielzahl von Vorteilen für Benutzer von AEM as a Cloud Service, z. B.:
- 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.
Typische Anwendungsfälle für die Verwendung von Umgebungsvariablen sind:
- 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
Umgebungsvariable hinzufügen add-variables
Wenn Sie mehrere Variablen hinzufügen möchten, empfiehlt Adobe, die erste Variable hinzuzufügen. Verwenden Sie dann
Um Umgebungsvariablen hinzuzufügen, zu aktualisieren oder zu löschen, müssen Sie Mitglied der Rolle Bereitstellungsmanager sein.
Hinzufügen einer Umgebungsvariablen:
-
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 über die Umgebung verfügt, für die Sie eine Umgebungsvariable hinzufügen möchten.
-
Klicken Sie auf der Detailseite der Umgebung 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. Sie muss den folgenden Benennungskonventionen entsprechen:
- Variablen dürfen nur alphanumerische Zeichen und den 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 Wählen Sie aus, ob die Variable normal oder geheim ist. 
- Variablen dürfen nur alphanumerische Zeichen und den Unterstrich (
-
Klicken Sie auf das Symbol
Fügen Sie nach Bedarf weitere Variablen hinzu.
-
Klicken Sie auf Speichern.
In der rechten oberen Ecke der Tabelle wird ein Netz mit dem Status Aktualisieren angezeigt. Links von neu hinzugefügten Variablen wird auch ein Netz angezeigt. Diese Status zeigen an, dass die Umgebung mit der Konfiguration aktualisiert wird. Nach Abschluss ist die neue Umgebungsvariable in der Tabelle sichtbar.
Umgebungsvariable aktualisieren update-variables
Nachdem Sie Umgebungsvariablen erstellt haben, können Sie sie mit
Wenn Sie mehrere Variablen aktualisieren möchten, empfiehlt Adobe, dass Sie das Dialogfeld Umgebungskonfiguration verwenden, um alle erforderlichen Variablen gleichzeitig zu aktualisieren, bevor Sie auf Speichern klicken. Auf diese Weise können Sie sie mit einer Aktualisierung zur Umgebung hinzufügen.
Aktualisieren einer Umgebungsvariablen:
-
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 über die Umgebung verfügt, für die Sie eine Variable aktualisieren möchten.
-
Klicken Sie auf der Detailseite der Umgebung auf die Registerkarte Konfiguration .
-
Klicken Sie auf
-
Klicken Sie im Dialogfeld Umgebungskonfiguration in der letzten Spalte der Zeile der Variable, die Sie ändern möchten, auf das Symbol
-
Klicken Sie im Dropdown-Menü auf Bearbeiten.
-
Aktualisieren Sie den Wert der Umgebungsvariablen nach Bedarf.
Beim Bearbeiten eines Geheimnisses kann der Wert nur aktualisiert, nicht angezeigt werden.
-
Führen Sie einen der folgenden Schritte aus:
- Klicken Sie auf
- Klicken Sie auf das Symbol
- Klicken Sie auf
-
Klicken Sie auf Speichern.
In der rechten oberen Ecke der Tabelle wird ein Netz mit dem Status Aktualisieren angezeigt. Links von aktualisierten Variablen wird auch ein Netz angezeigt. Diese Status zeigen an, dass die Umgebung mit der Konfiguration aktualisiert wird. Nach Abschluss des Vorgangs ist die aktualisierte Umgebungsvariable in der Tabelle sichtbar.
Umgebungsvariable löschen 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 über die Umgebung verfügt, für die Sie eine Variable aktualisieren möchten.
- Klicken Sie auf der Detailseite der Umgebung auf die Registerkarte Konfiguration .
- Klicken Sie auf
- Klicken Sie im Dialogfeld Umgebungskonfiguration in der letzten Spalte der Zeile der Variable, die Sie ändern möchten, auf das Symbol
- Klicken Sie im Dropdown-Menü auf Löschen , um die Variable sofort 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 über XML auf Umgebungsvariablen und Geheimnisse zugreifen:
${env.VARIABLE_NAME}
Unter Einrichten des Projekts finden Sie ein Beispiel dafür, wie beide Variablentypen in einer pom.xml -Datei verwendet werden.
Weitere Informationen finden Sie in der offiziellen Maven-Dokumentation .
Verfügbarkeit von Umgebungsvariablen availability
Umgebungsvariablen können an verschiedenen Stellen wie folgt verwendet werden:
Nur normale Umgebungsvariablen können mit der Dispatcher verwendet werden.
- Geheimnisse können nicht verwendet werden.
- Umgebungsvariablen können nicht in
IfDefine-Direktiven verwendet werden. - Validieren Sie die Verwendung von Umgebungsvariablen lokal im Dispatcher, bevor Sie sie bereitstellen.