此页面由 Cloud Translation API 翻译。

Batch 使用入门

本页面介绍了如何开始使用 Batch for Google Cloud。

概览

Batch 是一项全代管式服务，让您可以在 Google Cloud 资源上安排批处理工作负载，将其加入队列并执行。Batch 代表您预配资源和管理容量，允许批处理工作负载大规模运行。

使用 Batch，您无需配置和管理第三方作业调度器、预配和取消预配资源，也无需一次一个可用区请求资源。如需运行作业，您需要为工作负载所需的资源指定参数，然后 Batch 会获取资源并将作业加入队列等待执行。Batch 提供与其他 Google Cloud 服务的原生集成，有助于批量作业的调度、执行、存储和分析，因此您可以专注于提交作业和使用结果。

Batch 包含以下组件：

作业：一种计划程序，可在没有任何用户互动的情况下运行一组任务以完成任务，通常用于计算工作负载。例如，一个作业可以是单个 Shell 脚本，也可以是复杂的多部分计算。

具体而言，批处理作业表示由一个或多个任务以及运行这些任务的环境组成的数组。您可以将作业的程序定义为一个或多个可运行对象的序列。每个任务都会对作业的资源运行可运行对象序列。您可以将作业的任务配置为并行或依序运行。
任务：对作业的可运行对象序列执行一次。当一个作业具有多个任务时，您可以通过引用作业的可运行对象中某个任务的索引的环境变量，指定希望每个执行项如何变化。
Runnable：您定义为作业一部分的可执行脚本或容器。
资源：运行作业所需的基础架构。您至少需要指定每项任务所需的计算资源：CPU 核心、内存和（如果需要）额外的启动磁盘存储空间。或者，您还可以为作业指定其他资源选项。在作业运行期间，Batch 会自动创建和删除符合您规范的资源。

具体而言，每个批量作业都在一个区域代管式实例组 (MIG) 上运行，该实例组由一个或多个匹配的 Compute Engine 虚拟机 (VM) 实例组成，每个实例都位于其中一个包含的地区中。每个虚拟机都有专用硬件来运行 CPU 核心和内存（会影响作业性能）和启动磁盘（用于存储操作系统 (OS) 映像和运行作业的指令）。如果指定，则作业还可能包含或访问其他资源，例如 GPU 或外部存储卷。为作业预配的虚拟机数量取决于您指定的硬件要求和任务调度选项。

总而言之，利用 Batch，您可以创建并运行每个作业，这些作业会自动预配和利用执行其任务所需的资源。

如需详细了解作业行为和选项，请参阅作业创建和执行概览页面。

价格

使用 Batch 不会产生额外费用。您只需支付执行作业所需的底层资源费用。

如需详细了解与 Batch 相关的费用以及如何过滤 Cloud Billing 报告以查看 Batch 费用，请参阅价格。

限制

Batch 具有以下限制：

不能超过项目的 Batch 配额和限制。
您只能为每个作业指定一个机器类型，可以是预定义或自定义。
您无法为每个作业指定多个任务组。所有作业只有一个名为 group0 的任务组。

前提条件

如需开始使用 Batch，请完成以下前提条件：

如果您的项目以前没有使用过 Batch，请为项目启用 Batch。
为每位新用户设置 Batch。

为项目启用 Batch

如需开始在项目中使用 Batch，请执行以下操作：

在 Google Cloud Console 中的项目选择器页面上，选择或创建一个 Google Cloud 项目。

转到“项目选择器”
确保您的 Google Cloud 项目已启用结算功能。
确保您的项目已启用 Batch：
1. 使用 Google Cloud 控制台或 Google Cloud CLI 启用 Batch 的 API。
  控制台
  
  启用 Batch, Compute Engine, and Cloud Logging API。
  启用 API
  gcloud
  
  Enable the Batch, Compute Engine, and Cloud Logging APIs:
```
gcloud services enable batch.googleapis.com compute.googleapis.com logging.googleapis.com
```
2. 请确保您的项目有一个或多个服务帐号，且这些帐号具有创建和访问运行批量作业所需的资源所需的权限。
  
  重要的是，如果您希望允许任何用户在项目中创建和运行批量作业，则必须获得使用其中一个服务帐号的权限。因此，请勿选择拥有的权限超出您希望授予这些用户的权限的服务帐号。
  
  每个作业默认使用的服务帐号是 Compute Engine 默认服务帐号，但您也可以自定义作业使用的服务帐号。
  
  注意：作业默认使用 Compute Engine 默认服务帐号，该帐号默认被授予 Editor 角色 (roles/editor)。虽然此默认配置已提供以下权限，但建议不要在生产环境中使用 Editor 角色 (roles/editor)。
  
  将以下 IAM 角色授予您的项目用于批量作业的任何服务帐号。
  - 项目的批处理代理报告程序 (roles/batch.agentReporter)
  - 如需允许作业访问 Cloud Storage 存储桶：存储桶的 Storage Admin (roles/storage.admin)
  - 让作业在 Cloud Logging 中生成日志：项目的 Logs Writer (roles/logging.logWriter)
  如需详细了解如何向服务帐号授予角色，请参阅限制服务帐号和管理对服务帐号的访问权限。
3. 请确保您熟悉您项目的 Batch 服务代理：
  
  创建 Batch 作业后，系统会自动为您的项目创建具有以下名称的 Batch 服务代理（Google 代管式服务帐号）：
```
service-PROJECT_NUMBER@gcp-sa-cloudbatch.iam.gserviceaccount.com
```
  将 PROJECT_NUMBER 替换为您的项目编号。
  
  系统会自动向 Batch 服务代理授予 Google Batch Service Agent (roles/batch.serviceAgent) IAM 角色。项目若要使用 Batch，必须进行此配置。
  
  警告：请勿撤消自动授予 Batch 服务代理的角色。否则，Batch 可能无法正常运行。
  
  但是，某些用例（例如在共享 VPC 网络上运行作业）需要您向项目的 Batch 服务代理授予额外的权限。
  
  注意：Batch 服务代理用于创建所有批处理作业。因此，当主帐号创建批处理作业时，项目中有权创建 Batch 作业的任何主帐号（用户或服务帐号）都可以使用授予 Batch 服务代理的任何权限。
  如需了解详情，请参阅服务代理。

为新用户设置 Batch

如需开始以用户身份使用 Batch，请执行以下操作：

如需获取使用 Batch 所需的权限，请让管理员授予您所需的项目 IAM 角色。请参阅每项任务的文档，了解其所需的权限。

例如，如果您想通过创建基本作业来开始学习如何使用 Batch，请考虑为以下任务请求角色：
- 如需创建作业，请执行以下操作：
  - 项目的批量作业编辑器 (roles/batch.jobsEditor)
  - 对作业的服务帐号拥有的 Service Account User (roles/iam.serviceAccountUser) 权限，默认为默认 Compute Engine 服务帐号
- 列出和描述作业：项目的 Batch Job Editor (roles/batch.jobsEditor) 或 Batch Job Viewer (roles/batch.jobsViewer)
- 如需查看作业的日志，请使用项目的日志查看器 (roles/logging.viewer)
- 如需删除作业，请使用项目的 Batch Job Editor (roles/batch.jobsEditor)
如需详细了解如何授予角色，请参阅管理访问权限。
如果要将命令行示例用于 Batch，请执行以下操作来设置 Google Cloud CLI。详细了解 Google Cloud CLI 身份验证。
1. 安装 Google Cloud CLI，然后通过运行以下命令初始化 Google Cloud CLI：
```
gcloud init
```
2. 推荐：使用 gcloud config set project 命令设置默认项目：
```
gcloud config set project PROJECT_ID
```
  将 PROJECT_ID 替换为您的项目 ID。
如果您想使用 Batch 的 API 示例或客户端库示例，请参阅进行 Batch 身份验证。

获取支持

您可以在 Cloud 论坛上与社区讨论 Batch。

如果您在使用 Batch 时遇到问题，请参阅问题排查文档。

如需获取与 Batch 相关的支持或提供反馈，请使用以下资源：

如需了解 Google Cloud 的结算问题，请与结算支持团队联系。
如果您有付费的支持套餐，请直接与 Google Cloud 支持团队联系，咨询有关 Batch 的问题。

Google Cloud 提供多种支持套餐以满足不同的需要，例如全天候支持、手机支持以及技术支持经理对接。如需了解详情，请参阅 Google Cloud 支持。
如需针对 Batch 提供任何反馈或功能请求，或者在没有付费支持套餐的情况下报告 Batch 问题，请点击发送反馈按钮（您可以在每个 Batch 文档页面的开头和末尾找到该按钮）。然后，选择以下选项之一：
- 如需获取与 Batch 文档相关的反馈，请选择“文档反馈”。
- 对于有关 Batch 的所有其他反馈，请选择“产品反馈”。

后续步骤

详细了解 Batch：
- 创建和运行示例作业
- 从 Cloud Life Sciences 迁移到 Batch
详细了解如何创建作业。
了解相关的 Google Cloud 产品：
- Compute Engine
- Cloud Logging