使用环境变量

如果您设置了环境变量，那么这些变量将被注入容器并可供代码访问。环境变量设置为键值对。例如，假设您正在运行一项服务，该服务在环境中读取 LOGGING_VERBOSE: true 时会启用额外的日志记录。在这种情况下，您需要将环境变量键值对设置为 LOGGING_VERBOSE=true。以下部分显示了确切的命令或界面。

预留名称

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

在服务上设置环境变量

任何配置更改都会导致系统创建新的修订版本。后续修订版本也将自动采用此配置设置，除非您进行了明确更新。

您可以在创建新服务或部署新修订版本时使用 Cloud Console、gcloud 命令行或 YAML 文件设置环境变量：

控制台

  1. 转到 Cloud Run

  2. 如果您是要配置一个新服务来作为部署目标，请点击创建服务。如果您要配置现有服务，请点击该服务，然后点击修改和部署新的修订版本。

  3. 在“高级设置”下，点击变量。

    图片

  4. 执行以下操作：

    • 如果要添加变量，请点击添加变量，然后在名称和值文本框中分别指定您想要使用的变量名称及其值。
    • 如果要更改变量的值，请将值文本框中的当前值替换为所需的值。
    • 如果要移除一个或多个环境变量，请将光标悬停在待移除变量对应的值文本框的左侧，以显示垃圾箱图标，然后点击该图标。

  5. 点击创建或部署。

命令行

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

您可以在部署服务时指定环境变量，也可以在创建服务后更新环境变量：

gcloud run deploy [SERVICE] --image IMAGE_URL --update-env-vars KEY1=VALUE1,KEY2=VALUE2

gcloud run services update SERVICE --update-env-vars KEY1=VALUE1,KEY2=VALUE2
  • 将 SERVICE 替换为服务的名称。
  • 将 KEY1=VALUE1,KEY2=VALUE2 替换为所需变量名称及其值的英文逗号分隔列表。
  • 将 IMAGE_URL 替换为对容器映像的引用，例如 gcr.io/myproject/my-image:latest。

如果您有太多环境变量，这些变量无法以 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=..."

YAML

您可以使用 gcloud run services describe --format export 命令下载并查看现有服务配置，该命令会生成清理后的 YAML 格式的结果。然后，您可以使用 gcloud beta run services replace 命令修改下述字段并上传修改后的 YAML。请务必仅修改记录的字段。

  1. 如需查看和下载配置，请运行以下命令：

    gcloud run services describe SERVICE --format export > service.yaml

  2. 更新 containers: 下 env 特性下的 name 和 value 特性：

    apiVersion: serving.knative.dev/v1
kind: Service
metadata:
  name: SERVICE
spec:
  template:
    spec:
      containers:
      - env:
        - name: KEY-1
          value: VALUE-1
        - name: KEY-N
          value: VALUE-N

    替换

    • 将 SERVICE 替换为您的 Cloud Run 服务的名称
    • 将 KEY-1、VALUE-1 替换为环境变量和值。（可选）根据需要添加更多的变量和值。

  3. 使用以下命令将服务替换为其新配置：

    gcloud beta run services replace service.yaml

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

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

ENV KEY1=VALUE1,KEY2=VALUE2

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

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

查看环境变量设置

如需查看服务的当前环境变量设置，请执行以下操作：

控制台

  1. 转到 Cloud Run

  2. 点击您感兴趣的服务以打开“服务详细信息”页面。

  3. 点击修订版本标签页。

  4. 在右侧的详细信息面板中，“变量”标签页下列出了环境变量设置。

命令行

  1. 使用以下命令：

    gcloud run services describe SERVICE

  2. 在返回的配置中找到环境变量设置。