Miljövariabler i Cloud Manager environment-variables
Standardmiljövariabler kan konfigureras och hanteras via Cloud Manager. De tillhandahålls körtidsmiljön och kan användas i OSGi-konfigurationer.
Miljövariabler kan vara antingen miljöspecifika värden eller miljöhemligheter, baserat på vad som ändras.
Om miljövariabler overview
Miljövariabler ger en mängd fördelar för användare av AEM as a Cloud Service, till exempel följande:
- De gör att beteendet i koden och programmet kan variera beroende på sammanhang och miljö. De kan till exempel användas för att aktivera olika konfigurationer i utvecklingsmiljön jämfört med produktions- eller scenmiljöerna för att undvika kostsamma misstag.
- De behöver bara konfigureras och konfigureras en gång och kan uppdateras och tas bort vid behov.
- Deras värden kan uppdateras när som helst och börja gälla omedelbart utan att kodändringar eller -distributioner behövs.
- De kan skilja kod från konfiguration och ta bort behovet av att inkludera känslig information i versionskontrollen.
- De förbättrar säkerheten i AEM as a Cloud Service eftersom de finns utanför koden.
Exempel på vanliga användningsområden för miljövariabler är:
- Ansluta AEM med olika externa slutpunkter
- Använda en referens när du lagrar lösenord i stället för direkt i kodbasen
- När det finns flera utvecklingsmiljöer i ett program och en del konfigurationer skiljer sig från en miljö till nästa
Lägg till en miljövariabel add-variables
Om du vill lägga till flera variabler rekommenderar Adobe att du lägger till den första variabeln och sedan använder du Lägg till i dialogrutan Miljökonfiguration för att lägga till ytterligare variabler. Den här metoden innebär att du kan lägga till dem med en uppdatering i miljön.
Om du vill lägga till, uppdatera eller ta bort miljövariabler måste du vara medlem i rollen Distributionshanteraren.
Så här lägger du till en miljövariabel:
-
Logga in på Cloud Manager på my.cloudmanager.adobe.com och välj lämplig organisation.
-
På konsolen Mina program väljer du den du vill hantera.
-
Klicka på Miljö på sidomenyn.
-
På sidan Miljö väljer du en rad i tabellen som innehåller den miljö som du vill lägga till en miljövariabel för.
-
Klicka på fliken Konfiguration på miljöns detaljsida.
-
Klicka på Lägg till/uppdatera.
Om du lägger till en miljövariabel för första gången klickar du på Lägg till konfiguration mitt på sidan. -
Ange informationen på tabellens första rad i dialogrutan Miljökonfiguration.
table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 Fält Beskrivning Namn Ett unikt namn på konfigurationsvariabeln. Den identifierar den specifika variabeln som används i miljön. Den måste följa följande namngivningskonventioner:
- Variabler får bara innehålla alfanumeriska tecken och understreck (
_
). - Det finns en gräns på 200 variabler per miljö.
- Varje namn får innehålla högst 100 tecken.
Värde Värdet som variabeln innehåller. Steget används Välj vilken tjänst variabeln gäller för. Markera Alla om du vill att variabeln ska användas för alla tjänster.
- Alla
- Författare
- Publish
- Förhandsgranska
Typ Välj om variabeln är normal eller en hemlighet. - Variabler får bara innehålla alfanumeriska tecken och understreck (
-
Klicka på Lägg till.
Lägg till ytterligare variabler efter behov.
-
Klicka på Spara.
En rotationsruta med statusen Uppdatering visas i tabellens övre högra hörn. En snurra visas också till vänster om nya variabler som du har lagt till. Dessa statusvärden anger att miljön uppdateras med konfigurationen. När du är klar visas den nya systemvariabeln i tabellen.
Uppdatera en miljövariabel update-variables
När du har skapat miljövariabler kan du uppdatera dem med ikonen Lägg till/uppdatera för att öppna dialogrutan Miljökonfiguration.
Om du vill uppdatera flera variabler rekommenderar Adobe att du använder dialogrutan Miljökonfiguration för att uppdatera alla nödvändiga variabler samtidigt innan du klickar på Spara. På så sätt kan du lägga till dem med en uppdatering i miljön.
Så här uppdaterar du en miljövariabel:
-
Logga in på Cloud Manager på my.cloudmanager.adobe.com och välj lämplig organisation.
-
På konsolen Mina program väljer du den du vill hantera.
-
Klicka på Miljö på sidomenyn.
-
På sidan Miljö väljer du en rad i tabellen som innehåller den miljö som du vill uppdatera en variabel för.
-
Klicka på fliken Konfiguration på miljöns detaljsida.
-
Klicka på Lägg till/uppdatera.
-
I dialogrutan Miljökonfiguration klickar du på ikonen i den sista kolumnen i raden i variabeln som du vill ändra.
-
Klicka på Redigera i listrutan.
-
Uppdatera vid behov miljövariabelns värde.
När du redigerar en hemlighet kan värdet bara uppdateras, inte visas. -
Gör något av följande:
- Klicka på för att tillämpa ändringen.
- Klicka på om du vill ångra ändringen.
-
Klicka på Spara.
En rotationsruta med statusen Uppdatering visas i tabellens övre högra hörn. En snurra visas också till vänster om alla uppdaterade variabler. Dessa statusvärden anger att miljön uppdateras med konfigurationen. När du är klar visas den uppdaterade systemvariabeln i tabellen.
Ta bort en miljövariabel delete-env-variable
- Logga in på Cloud Manager på my.cloudmanager.adobe.com och välj lämplig organisation.
- På konsolen Mina program väljer du den du vill hantera.
- Klicka på Miljö på sidomenyn.
- På sidan Miljö väljer du en rad i tabellen som innehåller den miljö som du vill uppdatera en variabel för.
- Klicka på fliken Konfiguration på miljöns detaljsida.
- Klicka på Lägg till/uppdatera.
- I dialogrutan Miljökonfiguration klickar du på ikonen i den sista kolumnen i raden i variabeln som du vill ändra.
- Klicka på Ta bort i listrutan om du vill ta bort variabeln direkt.
- Klicka på Spara.
Användning av miljövariabler using
Miljövariabler kan göra dina pom.xml
-konfigurationer säkrare och mer flexibla. Lösenord behöver till exempel inte vara hårdkodade och konfigurationen kan anpassas baserat på värdena i miljövariablerna.
Du kan komma åt miljövariabler och hemligheter via XML på följande sätt:
${env.VARIABLE_NAME}
Se Konfigurera projekt för ett exempel på hur du använder båda typer av variabler i en pom.xml
-fil.
Mer information finns även i den officiella dokumentationen för Maven.
Tillgänglighet för miljövariabler availability
Miljövariabler kan användas på flera ställen enligt följande:
Endast reguljära miljövariabler kan användas med Dispatcher.
- Hemligheter kan inte användas.
- Miljövariabler kan inte användas i
IfDefine
-direktiv. - Verifiera din användning av miljövariabler med Dispatcher lokalt innan du distribuerar.