配置容器

本页面介绍如何为 Cloud Run 作业配置入口点命令和参数。

当 Cloud Run 启动容器时，它会运行映像的默认入口点命令和默认命令参数。如果要替换映像的默认入口点和命令参数，您可以使用容器配置中的 command 和 args 字段。command 字段指定容器运行的实际命令。args 字段指定传递给该命令的参数。

所需的角色

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

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

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

配置入口点和参数

如需配置作业的命令入口点和参数，请执行以下操作：

控制台

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

转到 Cloud Run
点击部署容器，然后选择作业以填写初始作业设置页面。如果要配置现有作业，请点击作业，然后点击修改。
点击容器、变量和 Secret、连接、安全性以展开作业属性页面。
点击常规标签页。
- 指定您希望容器运行的命令（如果该命令不是容器中定义的命令）；您还可以选择指定入口点命令的参数。
点击创建或更新。

gcloud

为新作业设置启动命令和参数：
```
gcloud run jobs create JOB_NAME --image IMAGE_URL --command COMMAND --args ARG1,ARG-N
```
替换
- 将 JOB_NAME 替换为作业的名称。
- 将 COMMAND 替换为启动容器的命令（如果您未使用默认命令）。
- 将 ARG1 替换为要发送到容器命令的参数，或者对多个参数使用英文逗号分隔列表。
- 将 IMAGE_URL 替换为对容器映像的引用，例如 us-docker.pkg.dev/cloudrun/container/job:latest。

为现有作业更新命令和参数，请执行以下操作：

gcloud run jobs update JOB_NAME --command COMMAND --args ARG1,ARG-N

YAML

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

更新 args: 和 command 特性：

apiVersion: run.googleapis.com/v1
kind: Job
metadata:
  name: JOB_NAME
spec:
  template:
    spec:
      template:
        spec:
          containers:
          - args:
            - 'ARG1'
            - 'ARG-N'
            command:
            - COMMAND
            image: IMAGE

替换

将 COMMAND 替换为启动容器的命令（如果您未使用默认命令）。
将 ARG1 替换为要发送到容器命令的参数。（可选）在单独的一行中指定其他参数。

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

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

如需清除您设置的任何入口点命令和参数（恢复为容器默认值），请提供空字符串，如下所示：

gcloud run jobs update JOB_NAME --command "" --args ""

在参数中使用等号或英文逗号

如果您在参数中使用等号，请使用以下格式提供这些参数：

gcloud run deploy  \
  --args="--repo-allowlist=github.com/example/example_demo"

如果参数使用英文逗号，请参阅配置环境变量以详细了解如何进行转义。

查看容器设置

如需查看 Cloud Run 作业的当前容器设置，请执行以下操作：

控制台

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

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

gcloud

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