從控制台建立環境變數

使用 Code Engine 主控台建立和更新環境變數。

您可以在控制台建立或更新應用程式、工作或函式時定義環境變數。

開始之前

• 您必須 建立專案，且 專案必須處於 active 狀態。
• 確定您是否要建立字面上的環境變數，或是建立引用現有 secret 或 configmap 的環境變數。 如果您希望您的環境變數完全引用現有的秘訣或配置表，或引用現有秘訣或配置表中的個別金鑰，則該秘訣或配置表必須存在。 請參閱 建立機密 或 建立配置表，在繼續之前定義您的機密或配置表。

1. 要在新增環境變數頁面中開啟對話框定義環境變數，請完成下列其中一項選擇。

   • 如果您正在 建立應用程式，請從「建立應用程式」頁面，展開環境變數 (選用) 區段。 您可以在建立的應用程式中加入一個或多個環境變數。 按一下新增，開啟新增環境變數頁面。
   • 如果您正在 建立工作，請從建立工作頁面，展開環境變數 (選用) 區段。 按一下新增，開啟新增環境變數頁面。
   • 如果您正在 建立函數，請從建立函數頁面，展開環境變數 (選用) 區段。 按一下新增，開啟新增環境變數頁面。
   • 如果您要更新現有的工作負載以新增環境變數，請前往現有的應用程式、工作或函式。 從組態索引標籤，按一下環境變數。 對於應用程式、工作和功能，按一下新增環境變數，開啟新增環境變數頁面。

2. 從新增環境變數頁面，以下列其中一種方式建立環境變數、

   • 若要建立_字面_環境變數，請選擇 Literal value，指定字面環境變數的名稱，並提供值。 注意 Resulting definition 部分顯示環境變數的名稱及其值。
   • 若要建立_完全引用 configmap 的_環境變數，請選擇 Reference full configmap，然後選擇現有的 configmap。 在這種情況下，所選 configmap 的所有按鍵都會作為環境變數的一部分被引用。 請注意 Resulting definition 區段會顯示 configmap 中鍵的名稱，但不會顯示 configmap 中引用的鍵的實際值。
   • 若要建立一個_引用已定義的 configmap 的個別 key_ 的環境變數，請選擇 Reference key in configmap，選擇您想要的現有 configmap，然後選擇要引用作為環境變數一部分的 key。 在您選取您要參考的 configmap 中的個別關鍵後，請注意 Resulting definition 區段會顯示在 configmap 中選取的關鍵名稱，但不會顯示在 configmap 中被參考的關鍵的實際值。
   • 若要建立_完全引用秘密的_環境變數，請選擇 Reference full secret，然後選擇現有的秘密。 在這種情況下，所選密碼的所有金鑰都會作為環境變數的一部分被引用。 請注意 Resulting definition 部分會顯示秘訣中金鑰的名稱，但不會顯示秘訣中引用的金鑰實際值。
   • 若要建立_引用已定義密碼的個別金鑰的_環境變數，請選擇 Reference key in secret，選取您想要的現有密碼，然後選擇要引用為環境變數一部分的金鑰。 在您選取秘密中要參考的個別金鑰後，請注意 Resulting definition 區段會顯示秘密中選取金鑰的名稱，但不會顯示秘密中參考的金鑰實際值。

   從控制台，每個環境變數只能引用一個已定義的 configmap 或 secret 的個別金鑰。 如果需要引用多個 configmap 或 secret 的 key，則重複步驟，定義另一個引用不同 key 的環境變數。

3. 按一下「完成」儲存您的變更。 此動作可將您的環境變數新增到環境變數索引標籤的表格中。 若要繼續新增環境變數，請按一下新增。

4. 使用已定義的環境變數完成應用程式、工作或函式的建立或更新。

   • 如果您正在建立工作負載，當您按一下建立時，應用程式、工作或函式會與您的環境變數一起部署。
   • 如果您要更新現有的應用程式、工作或函式以新增環境變數，請按一下儲存並部署以更新應用程式，或按一下儲存以使用新環境變數更新工作或函式。

5. 當您的應用程式、工作或函式處於 Ready 狀態時，它會更新您的環境變數。

下表說明您的環境變數資訊。

例如，讓我們建立一個應用程式，並為應用程式設定環境變數。

1. 建立應用程式 命名為 myapp，它使用 icr.io/codeengine/codeengine 影像。 這個 hello-world 應用程式包含 TARGET 環境變數，應用程式會列印 Hello ${TARGET} from Code Engine 並列印環境變數清單。 如果 TARGET 環境變數為空，則會返回 Hello World from Code Engine。
2. 前往主控台中的此應用程式。
3. 當應用程式處於 Ready 狀態時，您就可以測試您的應用程式。 按一下測試應用程式，然後按一下測試應用程式窗格中的傳送請求。 若要在網頁中開啟應用程式，請按一下應用程式 URL。 myapp 應用程式會傳回 Hello World from Code Engine 回應，並列印此應用程式所包含的環境變數。
4. 按一下環境變數標籤。
5. 建立下列環境變數。
   • 按一下新增，開啟新增環境變數頁面，並建立_字面上的_環境變數。 例如，建立一個字面上的環境變數，名稱為 literalenvvar，值為 This is my literal。 按一下「完成」儲存您的變更。
   • 按一下 [ 新增 ]，開啟 [新增環境變數] 頁面，並建立_完全引用 configmap_ 的環境變數。 在引用 configmap 之前，它必須存在。 在這個範例中，存在一個名為 mycolorconfigmap 的 configmap，其中包含以下的 key-value 對：key1=blue, key2=green，和 key3=yellow。 建立一個完全引用 mycolorconfigmap configmap 的環境變數，包括其所有的 key-value 對。 請注意 Resulting definition 區段會顯示 configmap 中鍵的名稱，但不會顯示 configmap 中引用的鍵的實際值。 按一下「完成」儲存您的變更。
   • 按一下新增，開啟新增環境變數頁面，並建立另一個環境變數，以_引用已定義秘 密的個別金鑰_。 在您引用秘密之前，它必須存在。 在這個範例中，存在一個名稱為 mynewsecret 的秘密，它包含以下的鍵值對：newsec1=mynewsecret1, newsec2=mynewsecret2，和 newsec3=mynewsecret3。 建立一個環境變數，引用 mynewsecret secret 的 newsec2 金鑰。 注意 Resulting definition 部分會顯示秘密中選擇的金鑰名稱，但不會顯示秘密中引用的金鑰實際值。 按一下「完成」儲存您的變更。
6. 按一下「儲存並建立」，以新的環境變數更新應用程式。
7. 當應用程式處於 Ready 狀態時，您的應用程式會更新環境變數。
8. 若要測試您的應用程式，請按一下測試應用程式，然後按一下測試應用程式窗格中的傳送請求。 若要在網頁中開啟應用程式，請按一下應用程式 URL。 經此應用程式改版後，此應用程式會輸出 Hello World from Code Engine，輸出內容包括環境變數的名稱，這些變數是在之前的步驟中新增的。

當您在工作負載中設定環境變數時，此動作可新增環境變數或覆寫現有的環境變數。 如果您有相同_名稱_的環境變數，但指定的_值_與先前定義的環境變數不同，則更新後的環境變數會取代現有的值。 例如，如果您定義了一個名為 envvar1 且其值為 myenvar1 的環境變數，並且定義了另一個名為 envvar1 且指定其值為 mynewenvvar1 的環境變數，那麼在您儲存並部署更新的應用程式或儲存更新的工作後，您正在執行的應用程式或工作會使用 envvar1 且其值為 mynewenvvar1 的環境變數。

從控制台更新環境變數

1. 若要更新現有的環境變數，請移至包含您要變更的環境變數的應用程式、工作或函式，然後按一下環境變數索引標籤以顯示環境變數表。
2. 從環境變數表中，按一下要更新的環境變數。
3. 從「編輯環境變數」頁面進行更新，然後按一下「完成」儲存變更。 編輯環境變數時，您可以變更 Defined by 值及其對應的必填欄位。
4. 按一下「儲存並部署」，以根據變更部署應用程式；或按一下「儲存」，以根據變更執行工作。 當您的應用程式或工作處於 Ready 狀態時，您的應用程式或工作會根據您的環境變數進行更新。

使用 CLI 建立和更新環境變數

使用 Code Engine CLI 建立和管理環境變數。

您可以在使用 CLI 建立或更新應用程式、工作或函式時定義環境變數。

使用 CLI 建立環境變數時，可以參考 configmaps 或 secrets，也可以建立字面上的環境變數。 這些說明描述使用 CLI 建立和更新字面意義環境變數。

有關在 CLI 中以環境變數引用完整機密和設定映射、覆寫引用和移除引用的詳細情形，請參閱引用 機密和設定 映射。

開始之前

• 設定您的 Code Engine CLI 環境。
• 建立並使用專案。

ibmcloud ce job update --name myjob  --env envA=AA --env envB=B

ibmcloud ce job get --name myjob

Getting job 'myjob'...
OK

Name:          myjob
[...]
Environment Variables:
    Type     Name  Value
    Literal  envA  AA
    Literal  envB  B
Image:                  icr.io/codeengine/codeengine
[...]

ibmcloud ce jobrun submit --job myjob  --name myjobrun1 --env envB=BB --env envC=C

ibmcloud ce jobrun get --name myjobrun1

[...]
Name:          myjobrun1
[...]
Job Ref:                myjob
Environment Variables:
    Type     Name  Value
    Literal  envA  AA
    Literal  envB  BB
    Literal  envC  C
Image:                  icr.io/codeengine/codeengine
[...]

Instances:
Name           Running  Status   Restarts  Age
myjobrun1-0-0  0/1      Succeeded  0         17s

從控制台刪除環境變數

1. 從控制台，移至具有您要刪除的環境變數的應用程式、工作或函式。 按一下環境變數標籤。
2. 從環境變數表中，刪除要從應用程式、工作或函式中移除的環境變數。
3. 按一下「儲存並部署」以更新應用程式，或按一下「儲存」以使用新環境變數更新工作或函式。 當您的應用程式、工作或函式處於 Ready 狀態時，它會根據您目前的環境變數進行更新。

使用 CLI 刪除環境變數

當您使用 CLI 處理環境變數時，您可以參考現有的 configmaps 或 secrets，也可以處理字面上的環境變數。 這些指示說明如何使用 CLI 刪除字面意義上的環境變數。

如需移除 CLI 中對完整機密和配置表的引用的詳細方案，請參閱 引用機密和配置表。

ibmcloud ce application update --name myapp --env-rm envA

ibmcloud ce function update --name myfunction --env-rm envA