配置环境变量

如果您设置了环境变量，那么这些变量将被注入容器并可供代码访问。环境变量设置为键值对。

预留名称

容器运行时合同中定义的环境变量会预留给系统，不得设置。需特别指出的是，PORT 环境变量会由 Cloud Run 注入容器内部，您不应自行对其进行设置。

环境变量数量上限

请注意，您可以为每个 Cloud Run 作业的每个容器最多设置 1000 个环境变量。

所需的角色

如需获得配置 Cloud Run 作业所需的权限，请让管理员向您授予作业的以下 IAM 角色：

Cloud Run Developer (roles/run.developer) - Cloud Run 作业
Service Account User (roles/iam.serviceAccountUser) - 服务身份

如需查看与 Cloud Run 关联的 IAM 角色和权限的列表，请参阅 Cloud Run IAM 角色和 Cloud Run IAM 权限。如果您的 Cloud Run 作业与 Google Cloud API（例如 Cloud 客户端库）进行交互，请参阅服务身份配置指南。如需详细了解如何授予角色，请参阅部署权限和管理访问权限。

设置环境变量

如需为 Cloud Run 作业设置环境变量，请执行以下操作：

控制台

在 Google Cloud 控制台中，进入 Cloud Run 作业页面：

转到 Cloud Run
点击部署容器，然后选择作业以填写初始作业设置页面。如果要配置现有作业，请点击作业，然后点击修改。
点击容器、变量和 Secret、连接、安全性以展开作业属性页面。
点击变量标签页。
- 执行以下操作：
  - 如果要添加变量，请点击添加变量，然后在名称和值文本框中分别指定您想要使用的变量名称及其值。
  - 如果要更改变量的值，请将值文本框中的当前值替换为所需的值。
  - 如果要移除一个或多个环境变量，请将光标悬停在待移除变量对应的值文本框的左侧，以显示垃圾箱图标，然后点击该图标。
点击创建或更新。

gcloud

使用 gcloud run jobs update 命令设置、更新或移除现有服务的环境变量。您可以根据需要使用以下任意标志：

--set-env-vars
--update-env-vars
--remove-env-vars

--clear-env-vars

您可以在创建作业或更新作业时指定环境变量：

gcloud run jobs create JOB_NAME --image IMAGE_URL --update-env-vars KEY1=VALUE1,KEY2=VALUE2

gcloud run jobs update JOB_NAME --update-env-vars KEY1=VALUE1,KEY2=VALUE2

将 JOB_NAME 替换为作业的名称。
将 KEY1=VALUE1,KEY2=VALUE2 替换为所需变量名称及其值的英文逗号分隔列表。
将 IMAGE_URL 替换为对容器映像的引用，例如 us-docker.pkg.dev/cloudrun/container/job:latest。

YAML

如果您要创建新的作业，请跳过此步骤。如果您要更新现有作业，请下载其 YAML 配置：
```
gcloud run jobs describe JOB_NAME --format export > job.yaml
```

更新 env 下的 name 和 value 属性，如 containers: 下所示：

apiVersion: run.googleapis.com/v1
kind: Job
metadata:
  name: JOB
spec:
  template:
    spec:
      template:
        spec:
          containers:
          - image: IMAGE
            env:
            - name: KEY-1
              value: VALUE-1
            - name: KEY-N
              value: VALUE-N

将 KEY-1、VALUE-1 替换为环境变量和值。（可选）根据需要添加更多的变量和值。

您还可以指定更多配置，例如环境变量或内存限制。

更新现有作业配置：
```
gcloud run jobs replace job.yaml
```

设置多个环境变量

如果您有太多环境变量，这些变量无法以 KEY1=VALUE1,KEY2=VALUE2 格式轻松列出，则可以选择多次重复列出上述标志：

   [...]
   --set-env-vars "KEY1=VALUE1" \
   --set-env-vars "KEY2=VALUE2" \
   --set-env-vars "KEY3=VALUE3"

转义英文逗号字符

由于英文逗号字符 , 用于分隔环境变量，因此，如果您的环境变量包含英文逗号字符作为值，则您需要将这些分隔符进行转义，方法是，指定其他分隔符（例如 @）：

--set-env-vars "^@^KEY1=value1,value2,value3@KEY2=..."

在容器中设置默认环境变量

您可以使用 Dockerfile 中的 ENV 语句设置环境变量的默认值：

ENV KEY1=VALUE1,KEY2=VALUE2

优先顺序：容器变量与服务或作业变量

如果您在容器中设置默认环境变量，并在 Cloud Run 服务或作业上设置具有相同名称的环境变量，则该服务上设置的值优先。

查看环境变量设置

如需查看 Cloud Run 作业的当前环境变量设置，请按照以下所述操作：

控制台

在 Google Cloud 控制台中，进入 Cloud Run 作业页面：

转到 Cloud Run 作业
点击相关作业以打开作业详情页面。
点击配置标签页。
在配置详细信息中找到环境变量设置。

gcloud

使用以下命令：
```
gcloud run jobs describe JOB_NAME
```
在返回的配置中找到环境变量设置。