本页面介绍了如何开始使用 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 项目。
确保您的项目已启用 Batch:
使用 Google Cloud 控制台或 Google Cloud CLI 为 Batch 启用 API。
控制台
启用 Batch, Compute Engine, and Cloud Logging API。
gcloud
Enable the Batch, Compute Engine, and Cloud Logging APIs:
gcloud services enable batch.googleapis.com
compute.googleapis.com logging.googleapis.com 确保您的项目具有一个或多个服务帐号,这些服务帐号具有创建和访问运行 Batch 作业所需的资源所需的权限。
重要的是,如果您要允许任何用户在项目中创建和运行 Batch 作业,则必须获得使用这些服务帐号之一的权限。因此,请勿选择拥有的权限超出您要授予这些用户的服务帐号。
每个作业默认使用的服务帐号是 Compute Engine 默认服务帐号,但您也可以自定义作业使用的服务帐号。
将以下 IAM 角色授予您的项目用于批量作业的任何服务帐号。
- 项目的批量代理报告程序 (
roles/batch.agentReporter
) - 如需允许作业访问 Cloud Storage 存储桶,请拥有存储桶的 Storage Admin (
roles/storage.admin
) - 让作业在 Cloud Logging 中生成日志:项目的 Logs Writer (
roles/logging.logWriter
)
如需详细了解如何为服务帐号授予角色,请参阅限制服务帐号和管理对服务帐号的访问权限。
- 项目的批量代理报告程序 (
请确保您熟悉项目的 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,必须进行此配置。但是,某些用例(例如在共享 VPC 网络上运行作业)需要您向项目的 Batch 服务代理授予额外的权限。
如需了解详情,请参阅服务代理。
为新用户设置 Batch
要以用户身份开始使用 Batch,请执行以下操作:
如需获取使用 Batch 所需的权限,请让管理员授予您项目所需的 IAM 角色。如需了解每项任务所需的权限,请参阅每项任务的文档。
例如,如果要通过创建基本作业来着手学习如何使用 Batch,请考虑为以下任务请求角色:
- 如需创建作业,请执行以下操作:
- 项目的 Batch Job Editor (
roles/batch.jobsEditor
) - 作业的服务帐号的 Service Account User (
roles/iam.serviceAccountUser
),默认为默认 Compute Engine 服务帐号
- 项目的 Batch Job Editor (
- 列出和描述作业:使用项目的 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 身份验证。
安装 Google Cloud CLI,然后通过运行以下命令初始化 Google Cloud CLI:
gcloud init
推荐:使用
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:
详细了解如何创建作业。
了解相关的 Google Cloud 产品: