Cloud Manager中的環境變數 environment-variables
可以透過 Cloud Manager 設定和管理標準環境變數。 它們提供給執行階段環境並且可以在 OSGi 設定中使用。
環境變數可以是特定環境的值或環境密碼,具體取決於變更的內容。
關於環境變數 overview
環境變數為AEM as a Cloud Service使用者提供數個好處,包括:
- 環境變數可讓您的程式碼和應用計劃的行為根據內容和環境而變化。 例如,與生產或預備環境相比,環境變數可用於在開發環境中啟用不同的設定,以避免代價高昂的錯誤。
- 它們只需要設定一次,並且可以在必要時更新和刪除。
- 它們的值可以隨時更新並立即生效,不需要變更程式碼或部署。
- 環境變數可以將程式碼與設定分開,也無須在版本控制中包含敏感資訊。
- 環境變數提高了AEM as a Cloud Service應用程式的安全性,因為它們存在於程式碼基底之外。
使用環境變數的典型使用案例包括:
- 連線您的AEM應用程式與不同的外部端點。
- 在儲存密碼時使用參考,而不是直接在程式碼庫中儲存。
- 一個計畫中存在多個開發環境,並且環境之間的某些設定不同。
新增環境變數 add-variables
若要新增多個變數,Adobe建議您新增第一個變數,然後在 環境設定 對話方塊中使用
若要新增、更新或刪除環境變數,您必須是部署管理員角色的成員。
若要新增環境變數:
-
在 my.cloudmanager.adobe.com 登入 Cloud Manager 並選取適當的組織。
-
在 我的程式 主控台上,選取您要管理的程式。
-
從側邊功能表,按一下環境。
-
在 環境 頁面上,選取包含您想要新增環境變數之環境的表格列。
-
在環境的詳細資訊頁面上,按一下「設定」標籤。
-
按一下
新增/更新。
如果您是第一次新增環境變數,請按一下頁面中央的[新增組態] 。
-
在 環境組態 對話方塊中,在表格的第一列輸入詳細資料。
table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 欄位 說明 名稱 設定變數的唯一名稱。 它會識別環境中使用的特定變數。 它必須遵循以下命名慣例:
- 變數只能包含英數字元和底線(
_)。 - 每個環境有400個變數的限制。
- 每個名稱不得超過100個字元。
值 變數儲存的值。 套用的步驟 選取要套用變數的服務。 選取 全部 以將變數套用至所有服務。
- 全部
- 製作者
- 發佈
- 預覽
類型 選取變數是普通或秘密。
- 變數只能包含英數字元和底線(
-
按一下「
新增。視需要新增其他變數。
-
按一下儲存。
狀態為 正在更新 的進度環會顯示在表格的右上角。 任何新新增的變數左側也會出現旋轉圖示。 這些狀態表示正在使用設定更新環境。 完成後,新的環境變數會顯示在表格中。
更新環境變數 update-variables
建立環境變數後,您可以使用
如果您想要更新多個變數,Adobe建議您使用 環境設定 對話方塊,在按一下 儲存 之前,一次更新所有必要的變數。 此方法可讓您透過單一環境更新來更新它們。
若要更新環境變數:
-
在 my.cloudmanager.adobe.com 登入 Cloud Manager 並選取適當的組織。
-
在 我的程式 主控台上,選取您要管理的程式。
-
從側邊功能表,按一下環境。
-
在 環境 頁面上,選取有您要更新變數之環境的資料表列。
-
在環境的詳細資訊頁面上,按一下「設定」標籤。
-
按一下
新增/更新。 -
在 環境組態 對話方塊中,在您要變更之變數列的最後一欄按一下
。 -
在下拉式功能表中,按一下編輯。
-
視需要更新環境變數的值。
編輯密碼時,只能更新值,不能檢視。
-
執行下列任一項作業:
- 按一下
以套用變更。 - 按一下
以復原變更。
- 按一下
-
按一下儲存。
狀態為 正在更新 的進度環會顯示在表格的右上角。 旋轉圖也會出現在任何已更新變數的左側。 這些狀態表示正在使用設定更新環境。 完成後,更新的環境變數會顯示在表格中。
刪除環境變數 delete-env-variable
- 在 my.cloudmanager.adobe.com 登入 Cloud Manager 並選取適當的組織。
- 在 我的程式 主控台上,選取您要管理的程式。
- 從側邊功能表,按一下環境。
- 在 環境 頁面上,選取有您要更新變數之環境的資料表列。
- 在環境的詳細資訊頁面上,按一下「設定」標籤。
- 按一下
新增/更新。 - 在 環境組態 對話方塊中,在您要變更之變數列的最後一欄按一下
。 - 在下拉式功能表中,按一下 刪除 以立即移除變數。
- 按一下儲存。
使用環境變數 using
環境變數可讓您的 pom.xml 設定更加安全和靈活。 例如,密碼不需要硬式編碼值,而且您的設定可以適應環境變數值。
您可以透過XML存取環境變數和秘密,如下所示:
${env.VARIABLE_NAME}
請參閱設定專案,以取得如何在pom.xml檔案中使用這兩種型別變數的範例。
如需詳細資訊,另請參閱正式Maven檔案。
環境變數的可用性 availability
環境變數可以用在幾個地方,如下所示:
Dispatcher 只能使用一般環境變數。
- 不能使用密碼。
- 環境變數不能在
IfDefine指令中使用。 - 在部署之前,請透過本機使用 Dispatcher 驗證您所使用的環境變數。