从控制台创建环境变量

使用 Code Engine 控制台创建和更新环境变量。

您可以在控制台中创建或更新应用程序，作业或功能时定义环境变量。

准备工作

• 您必须 创建项目，并且 项目 必须处于 active 状态。
• 确定是要创建字面值环境变量，还是要创建引用现有私钥或 configmap 的环境变量。 如果您希望环境变量完全引用现有私钥或 configmap，或者引用现有私钥或 configmap 中的各个密钥，那么该私钥或 configmap 必须存在。 请参阅 创建私钥 或 创建 configmap 以定义私钥或 configmap，然后再继续操作。

1. 要打开对话框以在“添加环境变量”页面上定义环境变量，请完成下列其中一个选项。

   • 如果要 创建应用程序，请从“创建应用程序”页面展开 环境变量 (可选) 部分。 您可以将一个或多个环境变量添加到要创建的应用程序。 单击 添加 以打开“添加环境变量”页面。
   • 如果要 创建作业，请从“创建作业”页面展开 环境变量 (可选) 部分。 单击 添加 以打开“添加环境变量”页面。
   • 如果要 创建函数，请从“创建函数”页面展开 环境变量 (可选) 部分。 单击 添加 以打开“添加环境变量”页面。
   • 如果要更新现有工作负载以添加环境变量，请转至现有应用程序，作业或函数。 从“配置”选项卡中，单击 环境变量。 对于应用程序，作业和函数，单击 添加环境变量 以打开“添加环境变量”页面。

2. 从“添加环境变量”页面中，通过下列其中一种方式创建环境变量:

   • 要创建 文字 环境变量，请选择 Literal value，指定文字环境变量的名称，然后提供值。 请注意，Resulting definition 部分显示环境变量的名称及其值。
   • 要创建 _完全引用 configmap_的环境变量，请选择 Reference full configmap，然后选择现有 configmap。 对于此情况，所选 configmap 的所有键都将作为环境变量的一部分进行引用。 请注意，Resulting definition 部分显示 configmap 中键的名称，但不显示 configmap 中引用的键的实际值。
   • 要创建 _引用已定义 configmap 的单个键_的环境变量，请选择 Reference key in configmap，选择所需的现有 configmap，然后选择要作为环境变量的一部分引用的键。 在您选择要引用的 configmap 中的个别键后，请注意，Resulting definition 部分会在 configmap 中显示所选键的名称，但不会显示 configmap 中引用的键的实际值。
   • 要创建 _完全引用私钥_的环境变量，请选择 Reference full secret，然后选择现有私钥。 对于此情况，所选私钥的所有密钥都将作为环境变量的一部分进行引用。 请注意，Resulting definition 部分显示私钥中的密钥名称，但不显示私钥中引用的密钥的实际值。
   • 要创建 _引用已定义私钥的单个密钥_的环境变量，请选择 Reference key in secret，选择所需的现有私钥，然后选择要作为环境变量的一部分引用的密钥。 在选择要引用的私钥中的个别密钥后，请注意，Resulting definition 部分会显示私钥中所选密钥的名称，但不会显示私钥中引用的密钥的实际值。

   在控制台中，每个环境变量只能引用已定义的 configmap 或私钥的一个单独密钥。 如果需要引用 configmap 或 secret 的多个密钥，请重复这些步骤以定义另一个引用另一个密钥的环境变量。

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，它包含以下键/值对: key1=blue，key2=green 和 key3=yellow。 创建完全引用 mycolorconfigmap configmap 的环境变量，包括其所有键/值对。 请注意，Resulting definition 部分显示 configmap 中键的名称，但不显示 configmap 中引用的键的实际值。 单击“**完成 **”保存更改。
   • 单击 添加 以打开“添加环境变量”页面，并创建另一个 _引用已定义私钥的单个密钥_的环境变量。 在可以引用私钥之前，它必须存在。 对于此示例，存在名为 mynewsecret 的私钥，该私钥包含以下键/值对: newsec1=mynewsecret1，newsec2=mynewsecret2 和 newsec3=mynewsecret3。 创建引用 mynewsecret 密钥的 newsec2 密钥的环境变量。 请注意，Resulting definition 部分显示私钥中所选密钥的名称，但不显示私钥中引用的密钥的实际值。 单击“**完成 **”保存更改。
6. 单击 保存并创建 以使用新的环境变量更新应用程序。
7. 当应用程序处于 Ready 状态时，将使用环境变量更新应用程序。
8. 要测试应用程序，请单击 测试应用程序，然后单击“测试应用程序”窗格中的 发送请求。 要在网页中打开应用程序，请单击应用程序 URL。 通过此应用程序修订版，此应用程序输出 Hello World from Code Engine 并且输出包含在先前步骤中添加的环境变量的名称。

在工作负载中设置环境变量时，此操作将添加新的环境变量或覆盖现有环境变量。 如果您具有与先前定义的环境变量具有相同 _name_的环境变量，并指定与先前定义的环境变量不同的 值，那么更新后的环境变量将覆盖现有值。 例如，如果您具有名为 envvar1 且其值为 myenvar1 的已定义环境变量，并且您定义了另一个也名为 envvar1 的环境变量并将其值指定为 mynewenvvar1，那么在保存并部署更新的应用程序或保存更新的作业之后，正在运行的应用程序或作业将使用值为 mynewenvvar1 的 envvar1 环境变量。

从控制台更新环境变量

1. 要更新现有环境变量，请转至包含要更改的环境变量的应用程序，作业或函数，然后单击 环境变量 选项卡以显示环境变量表。
2. 从环境变量表中，单击要更新的环境变量。
3. 在“编辑环境变量”页面中，进行更新，然后单击 完成 以保存更改。 编辑环境变量时，可以更改 定义依据 值及其相应的必填字段。
4. 单击 保存并部署 以使用更改来部署应用程序，或者单击 保存 以使用更改来运行作业。 当应用程序或作业处于 Ready 状态时，将使用环境变量更新应用程序或作业。

使用 CLI 创建和更新环境变量

使用 Code Engine CLI 创建和管理环境变量。

使用 CLI 创建或更新应用程序，作业或功能时，可以定义环境变量。

使用 CLI 创建环境变量时，可以引用 configmap 或私钥，也可以创建字面值环境变量。 这些指示信息描述如何使用 CLI 创建和更新字面值环境变量。

有关将完整私钥和 configmap 作为环境变量引用，覆盖引用以及在 CLI 中除去引用的详细方案，请参阅 引用私钥和 configmap。

准备工作

• 设置 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 处理环境变量时，可以引用现有 configmap 或私钥，也可以使用字面值环境变量。 这些指示信息描述使用 CLI 删除字面值环境变量。

有关在 CLI 中除去对完整私钥和 configmap 的引用的详细方案，请参阅 引用私钥和 configmap。

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

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