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 欄位 說明 名稱 設定變數的唯一名稱。 它會識別環境中使用的特定變數。 它必須遵循以下命名慣例:
- 變數只能包含英數字元和底線(
_
)。 - 每個環境有200個變數的限制。
- 每個名稱不得超過100個字元。
值 變數儲存的值。 套用的步驟 選取要套用變數的服務。 選取 全部 以將變數套用至所有服務。
- 全部
- 作者
- Publish
- 預覽
類型 選取變數是普通或秘密。 - 變數只能包含英數字元和底線(
-
按一下「 新增。
視需要新增其他變數。
-
按一下「儲存」。
狀態為 正在更新 的進度環會顯示在表格的右上角。 任何新新增的變數左側也會出現旋轉圖示。 這些狀態表示正在使用設定更新環境。 完成後,新的環境變數會顯示在表格中。
更新環境變數 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 驗證您所使用的環境變數。