Cloud Manager中的環境變數 environment-variables

可以透過 Cloud Manager 設定和管理標準環境變數。它們提供給執行階段環境並且可以在OSGi設定中使用。

環境變數可以是特定環境的值或環境密碼,具體取決於變更的內容。

關於環境變數 overview

環境變數為AEM as a Cloud Service的使用者提供了許多好處,如下所示:

  • 環境變數可讓您的程式碼和應用程式的行為根據內容和環境而變化。例如,與生產或預備環境相比,環境變數可用於在開發環境中啟用不同的設定,以避免代價高昂的錯誤。
  • 環境變數只需要設定一次,並且可以在必要時更新和刪除。
  • 環境變數的值可以隨時更新並立即生效,無需任何程式碼變更或部署。
  • 環境變數可以將程式碼與設定分開,也無須在版本控制中包含敏感資訊。
  • 環境變數提高了 AEM as a Cloud Service 應用程式的安全性,因為它們位於程式碼之外。

使用環境變數的典型使用案例包括:

  • 連接您的 AEM 應用程式與不同的外部端點
  • 在儲存密碼時使用參考而不是直接在程式碼庫中儲存
  • 當一個計畫中存在多個開發環境,且環境間的部分設定不同時

新增環境變數 add-variables

如果要新增多個變數,Adobe建議您新增第一個變數,然後在​ 環境組態 ​對話方塊中使用 新增圖示 新增 ​來新增其他變數。 此方法表示只要更新一次環境,即可新增這些變數。

若要新增、更新或刪除環境變數,您必須是​部署管理員 ​角色的成員。

若要新增環境變數:

  1. my.cloudmanager.adobe.com 登入 Cloud Manager 並選取適當的組織。

  2. 在​ 我的程式 ​主控台上,選取您要管理的程式。

  3. 從側邊功能表,按一下​ 環境

  4. 在​ 環境 ​頁面上,選取包含您想要新增環境變數之環境的表格列。

  5. 在環境的詳細資訊頁面上,按一下「設定」標籤。

  6. 按一下 新增/更新 — 新增圓形圖示 新增/更新
    如果您是第一次新增環境變數,請按一下頁面中央的[新增組態]

    設定索引標籤

  7. 在​ 環境組態 ​對話方塊中,在表格的第一列輸入詳細資料。

    table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2
    欄位 說明
    名稱

    設定變數的唯一名稱。 它會識別環境中使用的特定變數。 它必須遵循以下命名慣例:

    • 變數只能包含英數字元和底線(_)。
    • 每個環境有200個變數的限制。
    • 每個名稱不得超過100個字元。
    變數儲存的值。
    套用的步驟

    選取要套用變數的服務。 選取​ 全部 ​以將變數套用至所有服務。

    • 全部
    • 作者
    • Publish
    • 預覽
    類型 選取變數是普通或秘密。

    新增變數

  8. 按一下「 新增」圖示 新增

    視需要新增其他變數。

  9. 按一下「儲存」。

    狀態為​ 正在更新 ​的進度環會顯示在表格的右上角。 任何新新增的變數左側也會出現旋轉圖示。 這些狀態表示正在使用設定更新環境。 完成後,新的環境變數會顯示在表格中。

更新變數

更新環境變數 update-variables

建立環境變數後,您可以使用 新增/更新 — 新增圓形圖示 新增/更新 ​來更新變數,以開啟​ 環境設定 ​對話方塊。

如果要更新多個變數,Adobe建議您使用​ 環境組態 ​對話方塊,在按一下​ 儲存 ​之前一次更新所有必要的變數。 這樣,只要更新環境一次即可新增這些變數。

若要更新環境變數:

  1. my.cloudmanager.adobe.com 登入 Cloud Manager 並選取適當的組織。

  2. 在​ 我的程式 ​主控台上,選取您要管理的程式。

  3. 從側邊功能表,按一下​ 環境

  4. 在​ 環境 ​頁面上,選取有您要更新變數之環境的資料表列。

  5. 在環境的詳細資訊頁面上,按一下「設定」標籤。

  6. 按一下 新增/更新 — 新增圓形圖示 新增/更新

  7. 在​ 環境組態 ​對話方塊中,在您要變更之變數列的最後一欄按一下 省略符號 — 更多圖示

  8. 在下拉式功能表中,按一下​ 編輯

    編輯或刪除變數

  9. 視需要更新環境變數的值。
    編輯密碼時,只能更新值,不能檢視。

    編輯變數

  10. 執行下列任一項作業:

    • 按一下 套用 — 勾選圖示 以套用變更。
    • 按一下 復原圖示 以復原變更。
  11. 按一下「儲存」。

    狀態為​ 正在更新 ​的進度環會顯示在表格的右上角。 旋轉圖也會出現在任何已更新變數的左側。 這些狀態表示正在使用設定更新環境。 完成後,更新的環境變數會顯示在表格中。

刪除環境變數 delete-env-variable

  1. my.cloudmanager.adobe.com 登入 Cloud Manager 並選取適當的組織。
  2. 在​ 我的程式 ​主控台上,選取您要管理的程式。
  3. 從側邊功能表,按一下​ 環境
  4. 在​ 環境 ​頁面上,選取有您要更新變數之環境的資料表列。
  5. 在環境的詳細資訊頁面上,按一下「設定」標籤。
  6. 按一下 新增/更新 — 新增圓形圖示 新增/更新
  7. 在​ 環境組態 ​對話方塊中,在您要變更之變數列的最後一欄按一下 省略符號 — 更多圖示
  8. 在下拉式功能表中,按一下​ 刪除 ​以立即移除變數。
  9. 按一下「儲存」。

使用環境變數 using

環境變數可讓您的 pom.xml 設定更加安全和靈活。例如,密碼不需要硬式編碼,您的設定可以根據環境變數中的值進行調整。

您可以透過XML存取環境變數和秘密,如下所示:

${env.VARIABLE_NAME}

請參閱設定專案,以取得如何在pom.xml檔案中使用這兩種型別變數的範例。

如需詳細資訊,另請參閱正式Maven檔案

環境變數的可用性 availability

環境變數可以用在幾個地方,如下所示:

可在其中使用環境變數的位置
說明
編寫、預覽和發佈
一般環境變數和密碼均可用於編寫、預覽和發佈環境。
Dispatcher

只有一般環境變數可搭配Dispatcher使用。

  • 不能使用密碼。
  • 環境變數不能在IfDefine指令中使用。
  • 在部署之前,請透過本機使用 Dispatcher 驗證您所使用的環境變數。
OSGi 設定
一般環境變數和秘密都可以在OSGi設定中使用。
管道變數
除了環境變數,還有管道變數會在建置階段顯示。深入瞭解組建環境中的管道變數。
recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab