此页面由 Cloud Translation API 翻译。

创建并运行使用存储卷的作业

本文档介绍了如何创建和运行使用一个或多个外部存储卷外部存储选项包括新的或现有的永久性磁盘、新的本地 SSD、现有的 Cloud Storage 存储分区和现有的网络文件系统 (NFS)，例如 Filestore 文件共享。

无论您是添加外部存储卷，用于某个作业的 Compute Engine 虚拟机有一个启动磁盘，该磁盘提供存储空间获取作业的操作系统 (OS) 映像和说明。如需了解如何为作业配置启动磁盘，请参阅请改为参阅虚拟机操作系统环境概览。

准备工作

如果您以前没有使用过 Batch，请参阅 Batch 使用入门并通过填写针对项目和用户的前提条件。
如需获取创建作业所需的权限，请让管理员向您授予以下 IAM 角色：
- Batch Job Editor (roles/batch.jobsEditor) 针对项目
- Service Account User (roles/iam.serviceAccountUser) 服务账号用户针对作业的服务账号，该账号默认为默认 Compute Engine 服务账号
- 创建使用 Cloud Storage 存储桶的作业： Storage Object Viewer (roles/storage.objectViewer) 针对存储桶
如需详细了解如何授予角色，请参阅管理访问权限。

您也可以通过自定义角色或其他预定义角色来获取所需的权限。

创建使用存储卷的作业

作业可以使用以下一种或多种类型的存储卷更多信息所有类型的存储卷和差异和限制，请参阅 Compute Engine 虚拟机存储方案。

Persistent Disk：可用区级或区域级永久性块存储
本地 SSD：高性能、瞬时块存储
Cloud Storage 存储桶：经济实惠的对象存储
网络文件系统 (NFS)：基于网络文件系统协议的分布式文件系统，例如， Filestore 文件共享、它是托管在 Google Cloud 上的

您可以通过添加存储卷来允许作业使用每个存储卷并指定其装载路径 (mountPath) 运行容器如需了解如何创建使用存储卷的作业，请参阅以下一个或多个部分：

使用永久性磁盘
使用本地 SSD
使用 Cloud Storage 存储桶
使用网络文件系统

使用永久性磁盘

使用永久性磁盘的作业存在以下限制：

所有永久性磁盘：查看适用于所有永久性磁盘的限制。

新的永久性磁盘与现有的永久性磁盘：作业中的每个永久性磁盘都可以新建（在作业中定义和创建）或现有（已经在项目中创建并在作业中指定）。要使用永久性磁盘它需要格式化并装载到这些虚拟机必须与永久性磁盘位于同一位置。批量装载作业中包含的任何永久性磁盘，格式化任何新的永久性磁盘，但您必须格式化并卸载任何您希望作业使用的现有永久性磁盘

受支持的地理位置选项格式选项和装载选项新永久性磁盘和现有永久性磁盘之间会有所不同，具体说明如下表：

新的永久性磁盘现有永久性磁盘

格式选项

	新的永久性磁盘	现有永久性磁盘
格式选项	永久性磁盘会自动格式化 `ext4` 文件系统。	您必须将永久性磁盘格式化使用 `ext4` 文件系统然后再将其用于工作
装载选项	支持所有选项。	支持除写入以外的所有选项。原因如下：限制多写入者模式。您必须分离永久性磁盘从其挂接的任何虚拟机获取，然后再将其用于某项作业。
位置选项	您只能创建地区永久性磁盘。您可以为作业选择任何位置。磁盘是在项目运行所在的可用区中创建的。	您可以选择地区和区域永久性磁盘。您必须设置任务的位置（或者，如果指定，则仅设置任务的允许的位置）设置为仅包含作业所有磁盘。例如，对于地区永久性磁盘，作业的 location 必须是磁盘的可用区；永久性磁盘作业的位置必须是磁盘所在的区域，或者，如果指定可用区时，区域永久性磁盘所在的位置。

永久性磁盘会自动格式化 ext4 文件系统。

您必须将永久性磁盘格式化使用 ext4 文件系统 然后再将其用于工作

装载选项

支持所有选项。

支持除写入以外的所有选项。原因如下：限制多写入者模式。

您必须分离永久性磁盘 从其挂接的任何虚拟机获取，然后再将其用于某项作业。

位置选项

您只能创建地区永久性磁盘。

您可以为作业选择任何位置。磁盘是在项目运行所在的可用区中创建的。

您可以选择地区和区域永久性磁盘。

您必须设置任务的位置（或者，如果指定，则仅设置任务的允许的位置）设置为仅包含作业所有磁盘。例如，对于地区永久性磁盘，作业的 location 必须是磁盘的可用区；永久性磁盘作业的位置必须是磁盘所在的区域，或者，如果指定可用区时，区域永久性磁盘所在的位置。

实例模板：如果您想要在创建此作业时使用虚拟机实例模板，您必须在实例中为此作业挂接所有永久性磁盘模板。否则，如果您不想使用实例模板，则必须直接在作业定义中挂接任何永久性磁盘。

您可以使用 Google Cloud 控制台、gcloud CLI、Batch API Go、Java、Node.js、Python 或 C++。

控制台

以下示例使用 Google Cloud 控制台创建了一个作业运行一个脚本，从位于 us-central1-a 可用区中。示例脚本假定作业有一个现有的地区永久性磁盘，该磁盘包含一个名为 example.txt（位于根目录下）。

可选：创建示例地区永久性磁盘

如果要创建可用区永久性磁盘运行示例脚本，请在创建作业之前执行以下操作：

将名为 example-disk 的新空白永久性磁盘挂接到以下位置的 Linux 虚拟机： us-central1-a 可用区，然后在虚拟机上运行命令以格式化和装载磁盘。有关说明，请参阅向虚拟机添加永久性磁盘。

暂时不要断开与虚拟机的连接。
如需在永久性磁盘上创建 example.txt，请运行以下命令命令：
1. 要将当前工作目录更改为永久性磁盘，请输入以下命令：
```
cd VM_MOUNT_PATH
```
  将 VM_MOUNT_PATH 替换为将永久性磁盘装载到此虚拟机的目录例如 /mnt/disks/example-disk。
2. 按 Enter 键。
3. 如需创建并定义名为 example.txt 的文件，请执行以下操作：输入以下命令：
```
cat > example.txt
```
4. 按 Enter 键。
5. 输入文件的内容。例如，输入 Hello world!。
6. 如需保存文件，请按 Ctrl+D（在 macOS 上，按 Command+D）。
完成操作后，您可以断开与虚拟机的连接。
从虚拟机分离永久性磁盘。
- 如果您不再需要该虚拟机，可以删除虚拟机会自动分离永久性磁盘
- 否则，请分离永久性磁盘。有关说明，请参阅分离和重新挂接启动磁盘然后分离 example-disk 永久性磁盘，而不是虚拟机的启动磁盘

创建一个使用现有地区永久性磁盘的作业

如需创建作业来使用现有可用区级永久性磁盘（通过 Google Cloud 控制台中，请执行以下操作：

在 Google Cloud 控制台中，前往作业列表页面。

转到作业列表
点击创建。通过此时会打开创建批量作业页面。在左侧窗格中， 作业详情页面处于选中状态。
配置作业详情页面：
1. 可选：在作业名称字段中，自定义作业名称。
  
  例如，输入 example-disk-job。
2. 配置任务详情部分：
  1. 在新建可运行对象窗口中，添加至少一个脚本或容器。
    
    例如，要运行输出文件内容的名为 example.txt 且位于根目录下的文件永久性磁盘的快照，请执行以下操作：
    1. 选中脚本复选框。系统会显示一个文本框。
    2. 在文本框中，输入以下脚本：
```
echo "Here is the content of the example.txt file in the persistent disk."
cat MOUNT_PATH/example.txt
```
      将 MOUNT_PATH 替换为您计划将永久性磁盘装载到例如 /mnt/disks/example-disk。
    3. 点击完成。
  2. 在任务计数字段中，为此作业。
    
    例如，输入 1（默认值）。
  3. 在并行数量字段中，输入同时运行
    
    例如，输入 1（默认值）。
配置资源规范页面：
1. 在左侧窗格中，点击资源规范。系统随即会打开资源规范页面。
2. 选择此作业的位置。如需使用现有的地区永久性磁盘，作业的虚拟机必须位于同一可用区
  1. 在区域字段中，选择一个区域。
    
    例如，如需使用可用区级永久性磁盘，选择 us-central1 (Iowa)（默认）。
  2. 在可用区字段中，选择一个可用区。
    
    例如，选择 us-central1-a (Iowa)。
配置其他配置页面：
1. 在左侧窗格中，点击其他配置。系统会打开其他配置页面。
2. 对于您要装载到的每个现有地区永久性磁盘执行以下操作：
  1. 在存储卷部分中，点击添加新卷。系统随即会显示新建卷窗口。
  2. 在新建卷窗口中，执行以下操作：
    1. 在卷类型部分中，选择 Persistent Disk（默认）。
    2. 在磁盘列表中，选择一个要装载到的现有可用区级永久性磁盘此作业。磁盘必须位于用作此作业的可用区
      
      例如，选择现有的可用区级永久性磁盘该文件位于 us-central1-a 可用区，其中包含文件 example.txt。
    3. 可选：如果要重命名此可用区级永久性磁盘，执行以下操作：
      1. 选择自定义设备名称。
      2. 在设备名称字段中，为您的磁盘。
    4. 在装载路径字段中，输入装载路径（MOUNT_PATH）永久性磁盘：
      
      例如，输入以下内容：
```
/mnt/disks/EXISTING_PERSISTENT_DISK_NAME
```
      替换 EXISTING_PERSISTENT_DISK_NAME 替换为磁盘的名称。如果您重命名了地区永久性磁盘，请使用新名称。
      
      例如，将 EXISTING_PERSISTENT_DISK_NAME： example-disk.
    5. 点击完成。
可选：配置此职位的其他字段。
可选：如需查看作业配置，请在左侧窗格中点击预览。
点击创建。

作业详情页面会显示您创建的作业。

gcloud

以下示例使用 gcloud CLI 创建了一个作业挂接并装载现有的永久性磁盘和新的永久性磁盘。该作业包含 3 个任务，每个任务都会运行一个脚本，以在新的名为 output_task_TASK_INDEX.txt 的永久性磁盘其中 TASK_INDEX 是各项任务的索引：0、1， 2.

要通过 gcloud CLI，请使用 gcloud batch jobs submit 命令。在作业的 JSON 配置文件中，指定永久性磁盘的 instances 字段，并在 volumes 字段中装载永久性磁盘。

创建一个 JSON 文件。

如果您没有为此作业使用实例模板，创建一个包含以下内容的 JSON 文件：

{
    "allocationPolicy": {
        "instances": [
            {
                "policy": {
                    "disks": [
                        {
                            "deviceName": "EXISTING_PERSISTENT_DISK_NAME",
                            "existingDisk": "projects/PROJECT_ID/EXISTING_PERSISTENT_DISK_LOCATION/disks/EXISTING_PERSISTENT_DISK_NAME"
                        },
                        {
                            "newDisk": {
                                "sizeGb": NEW_PERSISTENT_DISK_SIZE,
                                "type": "NEW_PERSISTENT_DISK_TYPE"
                            },
                            "deviceName": "NEW_PERSISTENT_DISK_NAME"
                        }
                    ]
                }
            }
        ],
        "location": {
            "allowedLocations": [
                "EXISTING_PERSISTENT_DISK_LOCATION"
            ]
        }
    },
    "taskGroups": [
        {
            "taskSpec": {
                "runnables": [
                    {
                        "script": {
                            "text": "echo Hello world from task ${BATCH_TASK_INDEX}. >> /mnt/disks/NEW_PERSISTENT_DISK_NAME/output_task_${BATCH_TASK_INDEX}.txt"
                        }
                    }
                ],
                "volumes": [
                    {
                        "deviceName": "NEW_PERSISTENT_DISK_NAME",
                        "mountPath": "/mnt/disks/NEW_PERSISTENT_DISK_NAME",
                        "mountOptions": "rw,async"
                    },
                    {

                        "deviceName": "EXISTING_PERSISTENT_DISK_NAME",
                        "mountPath": "/mnt/disks/EXISTING_PERSISTENT_DISK_NAME"
                    }
                ]
            },
            "taskCount":3
        }
    ],
    "logsPolicy": {
        "destination": "CLOUD_LOGGING"
    }
}

替换以下内容：

PROJECT_ID：项目 ID 项目名称
EXISTING_PERSISTENT_DISK_NAME：名称现有永久性磁盘的快照
EXISTING_PERSISTENT_DISK_LOCATION：现有永久性磁盘的位置对于每个现有可用区则作业的位置必须是该磁盘所在的可用区；用于每个现有的区域永久性磁盘，那么作业的位置必须可以是磁盘的区域；如果指定了可用区，则为可用区永久性磁盘所在的两个特定可用区。如果您没有指定任何现有的您可以选择任何位置详细了解 allowedLocations 字段。
NEW_PERSISTENT_DISK_SIZE：新永久性磁盘（以 GB 为单位）。通过允许的尺寸取决于永久性磁盘的类型，但最小值通常为 10 GB (10)，最大值通常为 64 TB (64000)。
NEW_PERSISTENT_DISK_TYPE：磁盘类型（即 pd-standard、pd-balanced、 pd-ssd 或 pd-extreme。非启动磁盘的默认磁盘类型永久性磁盘为 pd-standard。
NEW_PERSISTENT_DISK_NAME：名称新的永久性磁盘的快照

如果您为此作业使用虚拟机实例模板按照上文所述创建 JSON 文件，但需要将 instances 个字段替换为以下内容：
```
"instances": [
    {
        "instanceTemplate": "INSTANCE_TEMPLATE_NAME"
    }
],
```
其中 INSTANCE_TEMPLATE_NAME 是名称此作业的实例模板的映像对于使用永久性磁盘，此实例模板必须定义并挂接作业使用的永久性磁盘在本示例中该模板必须定义并挂接名为 NEW_PERSISTENT_DISK_NAME和并将名称为 EXISTING_PERSISTENT_DISK_NAME.

运行以下命令：
```
gcloud batch jobs submit JOB_NAME \
  --location LOCATION \
  --config JSON_CONFIGURATION_FILE
```
替换以下内容：
- JOB_NAME：作业的名称。
- LOCATION：位置作业的组成部分。
- JSON_CONFIGURATION_FILE：JSON 路径该文件包含作业的配置详情。

API

以下示例使用 Batch API 创建作业用于挂接和装载现有的永久性磁盘和磁盘。该作业包含 3 个任务，每个任务都会运行一个脚本，以在新的名为“存储分区”的 output_task_TASK_INDEX.txt，其中 TASK_INDEX 是每个任务的索引：0、1 和 2。

要通过批处理 API，请使用 jobs.create 方法。在请求中指定永久性磁盘的 instances 字段，并在 volumes 字段中装载永久性磁盘。

如果您未对此作业使用实例模板，请执行以下操作：请求：

POST https://batch.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/jobs?job_id=JOB_NAME

{
    "allocationPolicy": {
        "instances": [
            {
                "policy": {
                    "disks": [
                        {
                            "deviceName": "EXISTING_PERSISTENT_DISK_NAME",
                            "existingDisk": "projects/PROJECT_ID/EXISTING_PERSISTENT_DISK_LOCATION/disks/EXISTING_PERSISTENT_DISK_NAME"
                        },
                        {
                            "newDisk": {
                                "sizeGb": NEW_PERSISTENT_DISK_SIZE,
                                "type": "NEW_PERSISTENT_DISK_TYPE"
                            },
                            "deviceName": "NEW_PERSISTENT_DISK_NAME"
                        }
                    ]
                }
            }
        ],
        "location": {
            "allowedLocations": [
                "EXISTING_PERSISTENT_DISK_LOCATION"
            ]
        }
    },
    "taskGroups": [
        {
            "taskSpec": {
                "runnables": [
                    {
                        "script": {
                            "text": "echo Hello world from task ${BATCH_TASK_INDEX}. >> /mnt/disks/NEW_PERSISTENT_DISK_NAME/output_task_${BATCH_TASK_INDEX}.txt"
                        }
                    }
                ],
                "volumes": [
                    {
                        "deviceName": "NEW_PERSISTENT_DISK_NAME",
                        "mountPath": "/mnt/disks/NEW_PERSISTENT_DISK_NAME",
                        "mountOptions": "rw,async"
                    },
                    {

                        "deviceName": "EXISTING_PERSISTENT_DISK_NAME",
                        "mountPath": "/mnt/disks/EXISTING_PERSISTENT_DISK_NAME"
                    }
                ]
            },
            "taskCount":3
        }
    ],
    "logsPolicy": {
        "destination": "CLOUD_LOGGING"
    }
}

替换以下内容：

PROJECT_ID：项目 ID 项目名称
LOCATION：位置作业的组成部分。
JOB_NAME：作业的名称。
EXISTING_PERSISTENT_DISK_NAME：名称现有永久性磁盘的快照
EXISTING_PERSISTENT_DISK_LOCATION：现有永久性磁盘的位置对于每个现有可用区则作业的位置必须是该磁盘所在的可用区；用于每个现有的区域永久性磁盘，那么作业的位置必须可以是磁盘的区域；如果指定了可用区，则为可用区永久性磁盘所在的两个特定可用区。如果您没有指定任何现有的您可以选择任何位置详细了解 allowedLocations 字段。
NEW_PERSISTENT_DISK_SIZE：新永久性磁盘（以 GB 为单位）。通过允许的尺寸取决于永久性磁盘的类型，但最小值通常为 10 GB (10)，最大值通常为 64 TB (64000)。
NEW_PERSISTENT_DISK_TYPE：磁盘类型（即 pd-standard、pd-balanced、 pd-ssd 或 pd-extreme。非启动磁盘的默认磁盘类型永久性磁盘为 pd-standard。
NEW_PERSISTENT_DISK_NAME：名称新的永久性磁盘的快照

如果您为此作业使用虚拟机实例模板按照上文所述创建 JSON 文件，但需要将 instances 个字段替换为以下内容：
```
"instances": [
    {
        "instanceTemplate": "INSTANCE_TEMPLATE_NAME"
    }
],
...
```
其中 INSTANCE_TEMPLATE_NAME 是名称此作业的实例模板的映像对于使用永久性磁盘，此实例模板必须定义并挂接作业使用的永久性磁盘在本示例中该模板必须定义并挂接名为 NEW_PERSISTENT_DISK_NAME和并将名称为 EXISTING_PERSISTENT_DISK_NAME.

Go

创建使用新作业或现有作业的 Batch 作业永久性磁盘 Go 版 Cloud 客户端库，请使用 CreateJob 函数包括：

如需将永久性磁盘挂接到虚拟机，以便执行某项作业，包含以下其中一项： <ph type="x-smartling-placeholder">
- 如果您没有为此作业使用虚拟机实例模板，添加 AllocationPolicy_AttachedDisk 类型。
- 如果要为此作业使用虚拟机实例模板，添加 AllocationPolicy_InstancePolicyOrTemplate_InstanceTemplate 类型。
要将永久性磁盘装载到作业中，请使用 Volume 类型（具有 Volume_DeviceName 类型）和 MountPath 字段。对于新的永久性磁盘，还可以使用 MountOptions 字段以启用写入。

如需查看类似用例的代码示例，请参阅使用 Cloud Storage 存储桶。

Java

创建使用新作业或现有作业的 Batch 作业永久性磁盘 Java 版 Cloud 客户端库，请使用 CreateJobRequest 类包括：

如需将永久性磁盘挂接到虚拟机，以便执行某项作业，包含以下其中一项： <ph type="x-smartling-placeholder">
- 如果您没有为此作业使用虚拟机实例模板，添加 setDisks 方法。
- 如果要为此作业使用虚拟机实例模板，添加 setInstanceTemplate 方法。
要将永久性磁盘装载到作业中，请使用 Volume 类使用 setDeviceName 方法和 setMountPath 方法。对于新的永久性磁盘，还可以使用 setMountOptions 方法即可启用写入功能。

如需查看类似用例的代码示例，请参阅使用 Cloud Storage 存储桶。

Node.js

创建使用新作业或现有作业的 Batch 作业永久性磁盘 Node.js 版 Cloud 客户端库，请使用 createJob 方法包括：

如需将永久性磁盘挂接到虚拟机，以便执行某项作业，包含以下其中一项： <ph type="x-smartling-placeholder">
- 如果您没有为此作业使用虚拟机实例模板，添加 AllocationPolicy.AttachedDisk 类。
- 如果要为此作业使用虚拟机实例模板，添加 instanceTemplate 属性。
要将永久性磁盘装载到作业中，请使用 Volume 类（通过 deviceName 属性）和 mountPath 属性。对于新的永久性磁盘，还可以使用 mountOptions 属性即可启用写入功能。

如需查看类似用例的代码示例，请参阅使用 Cloud Storage 存储桶。

Python

创建使用新作业或现有作业的 Batch 作业永久性磁盘 Python 版 Cloud 客户端库，请使用 CreateJob 函数包括：

如需将永久性磁盘挂接到虚拟机，以便执行某项作业，包含以下其中一项： <ph type="x-smartling-placeholder">
- 如果您没有为此作业使用虚拟机实例模板，添加 AttachedDisk 类。
- 如果要为此作业使用虚拟机实例模板，请添加 instance_template 属性。
要将永久性磁盘装载到作业中，请使用 Volume 类具有 device_name 属性和 mount_path 属性。对于新的永久性磁盘，还可以使用 mount_options 属性以启用写入。

如需查看类似用例的代码示例，请参阅使用 Cloud Storage 存储桶。

C++

创建使用新作业或现有作业的 Batch 作业永久性磁盘 C++ 版 Cloud 客户端库，请使用 CreateJob 函数包括：

如需将永久性磁盘挂接到虚拟机，以便执行某项作业，包含以下其中一项： <ph type="x-smartling-placeholder">
- 如果您没有为此作业使用虚拟机实例模板，请使用 set_remote_path 方法。
- 如果要为此作业使用虚拟机实例模板，请使用 set_instance_template 方法结合使用。
如需将永久性磁盘装载到作业，请使用 volumes 字段和 deviceName 和 mountPath 字段。对于新的永久性磁盘使用 mountOptions 字段启用写入。

如需查看类似用例的代码示例，请参阅使用 Cloud Storage 存储桶。

使用本地 SSD

使用本地 SSD 的作业具有以下限制：

所有本地 SSD。查看针对所有本地 SSD 的限制。
实例模板：在创建此作业时指定虚拟机实例模板，您必须将此作业的所有永久性磁盘挂接到实例模板。如果您不想使用某个实例您必须将任何永久性磁盘直接挂接到作业定义。

您可以使用 gcloud CLI 或 Batch API。以下示例介绍了如何创建作业，该作业可创建、附加和会装载一个本地 SSD此作业还包含 3 项任务让每个虚拟机运行一个脚本，在本地固态硬盘 (SSD) 中创建一个名为 output_task_TASK_INDEX.txt，其中 TASK_INDEX 是每个任务的索引： 0、1 和 2。

gcloud

如需创建使用本地 SSD 的作业，请使用 gcloud CLI，请使用 gcloud batch jobs submit 命令。在作业的 JSON 配置文件中，创建并挂接本地 SSD instances 字段，并在 volumes 字段中装载本地 SSD。

创建一个 JSON 文件。

如果您没有为此作业使用实例模板，创建一个包含以下内容的 JSON 文件：

{
    "allocationPolicy": {
        "instances": [
            {
                "policy": {
                    "machineType": MACHINE_TYPE,
                    "disks": [
                        {
                            "newDisk": {
                                "sizeGb": LOCAL_SSD_SIZE,
                                "type": "local-ssd"
                            },
                            "deviceName": "LOCAL_SSD_NAME"
                        }
                    ]
                }
            }
        ]
    },
    "taskGroups": [
        {
            "taskSpec": {
                "runnables": [
                    {
                        "script": {
                            "text": "echo Hello world from task ${BATCH_TASK_INDEX}. >> /mnt/disks/LOCAL_SSD_NAME/output_task_${BATCH_TASK_INDEX}.txt"
                        }
                    }
                ],
                "volumes": [
                    {
                        "deviceName": "LOCAL_SSD_NAME",
                        "mountPath": "/mnt/disks/LOCAL_SSD_NAME",
                        "mountOptions": "rw,async"
                    }
                ]
            },
            "taskCount":3
        }
    ],
    "logsPolicy": {
        "destination": "CLOUD_LOGGING"
    }
}

替换以下内容：

MACHINE_TYPE：机器类型可以是预定义或自定义、虚拟机数量通过允许的本地 SSD 数量取决于作业虚拟机的机器类型。
LOCAL_SSD_NAME：名称为此作业创建的本地 SSD 的位置。
LOCAL_SSD_SIZE：所有本地 SSD 以 GB 为单位。每个本地 SSD 为 375 GB，此值必须是 375 GB 的倍数。对于例如，对于 2 个本地 SSD，请将此值设置为 750 GB。

如果您为此作业使用虚拟机实例模板按照上文所述创建 JSON 文件，但需要将 instances 个字段替换为以下内容：
```
"instances": [
    {
        "instanceTemplate": "INSTANCE_TEMPLATE_NAME"
    }
],
```
其中 INSTANCE_TEMPLATE_NAME 是名称此作业的实例模板的映像对于使用此实例模板必须定义并挂接您希望作业使用的本地 SSD。在本示例中该模板必须定义并挂接名为 LOCAL_SSD_NAME.

运行以下命令：
```
gcloud batch jobs submit JOB_NAME \
  --location LOCATION \
  --config JSON_CONFIGURATION_FILE
```
替换以下内容：
- JOB_NAME：作业的名称。
- LOCATION：位置作业的组成部分。
- JSON_CONFIGURATION_FILE：JSON 路径该文件包含作业的配置详情。

API

如需创建使用本地 SSD 的作业，请使用批处理 API，请使用 jobs.create 方法。在请求中，创建本地 SSD 并将其挂接到 instances 字段，并在 volumes 字段中装载本地 SSD。

如果您未对此作业使用实例模板，请执行以下操作：请求：

POST https://batch.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/jobs?job_id=JOB_NAME

{
    "allocationPolicy": {
        "instances": [
            {
                "policy": {
                    "machineType": MACHINE_TYPE,
                    "disks": [
                        {
                            "newDisk": {
                                "sizeGb": LOCAL_SSD_SIZE,
                                "type": "local-ssd"
                            },
                            "deviceName": "LOCAL_SSD_NAME"
                        }
                    ]
                }
            }
        ]
    },
    "taskGroups": [
        {
            "taskSpec": {
                "runnables": [
                    {
                        "script": {
                            "text": "echo Hello world from task ${BATCH_TASK_INDEX}. >> /mnt/disks/LOCAL_SSD_NAME/output_task_${BATCH_TASK_INDEX}.txt"
                        }
                    }
                ],
                "volumes": [
                    {
                        "deviceName": "LOCAL_SSD_NAME",
                        "mountPath": "/mnt/disks/LOCAL_SSD_NAME",
                        "mountOptions": "rw,async"
                    }
                ]
            },
            "taskCount":3
        }
    ],
    "logsPolicy": {
        "destination": "CLOUD_LOGGING"
    }
}

替换以下内容：

PROJECT_ID：项目 ID 项目名称
LOCATION：位置作业的组成部分。
JOB_NAME：作业的名称。
MACHINE_TYPE：机器类型可以是预定义或自定义、虚拟机数量通过允许的本地 SSD 数量取决于作业虚拟机的机器类型。
LOCAL_SSD_NAME：名称为此作业创建的本地 SSD 的位置。
LOCAL_SSD_SIZE：所有本地 SSD 以 GB 为单位。每个本地 SSD 为 375 GB，此值必须是 375 GB 的倍数。对于例如，对于 2 个本地 SSD，请将此值设置为 750 GB。

如果您为此作业使用虚拟机实例模板按照上文所述创建 JSON 文件，但需要将 instances 个字段替换为以下内容：
```
"instances": [
    {
        "instanceTemplate": "INSTANCE_TEMPLATE_NAME"
    }
],
...
```
其中 INSTANCE_TEMPLATE_NAME 是名称此作业的实例模板的映像对于使用此实例模板必须定义并挂接您希望作业使用的本地 SSD。在本示例中该模板必须定义并挂接名为 LOCAL_SSD_NAME.

使用 Cloud Storage 存储桶

如需创建使用现有 Cloud Storage 存储桶的作业，请执行以下操作：选择以下方法之一：

推荐做法：指定创建存储桶，如本部分所示。在作业运行时该存储桶会使用 Cloud Storage FUSE。
使用可以直接访问使用 gsutil 命令行工具创建 Cloud Storage 存储桶，或适用于 Cloud Storage API 的客户端库。要了解如何访问 Cloud Storage 存储桶，请参阅 Compute Engine 文档，了解对 Cloud Storage 存储分区执行数据读写操作。

在创建使用存储桶的作业之前，请先创建一个存储桶，或指定现有存储桶如需了解详情，请参阅创建存储分区并列出存储分区。

您可以使用 Google Cloud 控制台、gcloud CLI、Batch API、Go、 Java、Node.js、Python 或 C++。

以下示例介绍了如何创建将 Cloud Storage 存储桶。该作业还包含 3 个任务，每个创建一个脚本，用于在名为 output_task_TASK_INDEX.txt 其中，TASK_INDEX 是每个任务的索引： 0、1 和 2。

控制台

如需创建使用 Cloud Storage 存储桶的作业，您需要 Google Cloud 控制台中，请执行以下操作：

在 Google Cloud 控制台中，前往作业列表页面。

转到作业列表
点击创建。通过此时会打开创建批量作业页面。在左侧窗格中， 作业详情页面处于选中状态。
配置作业详情页面：
1. 可选：在作业名称字段中，自定义作业名称。
  
  例如，输入 example-bucket-job。
2. 配置任务详情部分：
  1. 在新建可运行对象窗口中，添加至少一个脚本或容器。
    
    例如，执行以下操作：
    1. 选中脚本复选框。系统会显示一个文本框。
    2. 在文本框中，输入以下脚本：
```
echo Hello world from task ${BATCH_TASK_INDEX}. >> MOUNT_PATH/output_task_${BATCH_TASK_INDEX}.txt
```
      将 MOUNT_PATH 替换为装载路径，此作业的可运行对象用来访问现有的 Cloud Storage 存储桶路径必须以 “/mnt/disks/”，后跟一个目录或路径。例如，如果您想使用存储桶（目录为 my-bucket），请将 /mnt/disks/my-bucket 的装载路径。
    3. 点击完成。
  2. 在任务计数字段中，为此作业。
    
    例如，输入 3。
  3. 在并行数量字段中，输入同时运行
    
    例如，输入 1（默认值）。
配置其他配置页面：
1. 在左侧窗格中，点击其他配置。系统会打开其他配置页面。
2. 对于您要装载到的每个 Cloud Storage 存储桶执行以下操作：
  1. 在存储卷部分中，点击添加新卷。系统随即会显示新建卷窗口。
  2. 在新建卷窗口中，执行以下操作：
    1. 在卷类型部分，选择 Cloud Storage 存储桶。
    2. 在存储分区名称字段中，输入现有存储桶
      
      例如，输入您在此它们是可以运行的
    3. 在装载路径字段中，输入存储桶 (MOUNT_PATH) 。
    4. 点击完成。
可选：配置此职位的其他字段。
可选：如需查看作业配置，请在左侧窗格中点击预览。
点击创建。

作业详情页面会显示您创建的作业。

gcloud

如需创建使用 Cloud Storage 存储桶的作业，您需要 gcloud CLI，请使用 gcloud batch jobs submit 命令。在作业的 JSON 配置文件中，将存储桶装载到 volumes 字段。

例如，如需创建一个将文件输出到 Cloud Storage 的作业，请执行以下操作：

使用以下内容创建 JSON 文件：

{
    "taskGroups": [
        {
            "taskSpec": {
                "runnables": [
                    {
                        "script": {
                            "text": "echo Hello world from task ${BATCH_TASK_INDEX}. >> MOUNT_PATH/output_task_${BATCH_TASK_INDEX}.txt"
                        }
                    }
                ],
                "volumes": [
                    {
                        "gcs": {
                            "remotePath": "BUCKET_PATH"
                        },
                        "mountPath": "MOUNT_PATH"
                    }
                ]
            },
            "taskCount": 3
        }
    ],
    "logsPolicy": {
        "destination": "CLOUD_LOGGING"
    }
}

替换以下内容：

BUCKET_PATH：存储桶目录的路径该名称必须以存储桶。例如，对于名为 BUCKET_NAME，路径 BUCKET_NAME 表示根目录存储桶的名称和路径 BUCKET_NAME/subdirectory 表示 subdirectory 子目录。
MOUNT_PATH：作业的装载路径 Runnable 用于访问此存储桶。路径必须以 /mnt/disks/，后跟您选择的目录或路径。对于例如，如果您想使用名称为 my-bucket 时，请将装载路径设置为 /mnt/disks/my-bucket。

运行以下命令：
```
gcloud batch jobs submit JOB_NAME \
  --location LOCATION \
  --config JSON_CONFIGURATION_FILE
```
替换以下内容：
- JOB_NAME：作业的名称。
- LOCATION：位置作业的组成部分。
- JSON_CONFIGURATION_FILE：JSON 路径该文件包含作业的配置详情。

API

如需创建使用 Cloud Storage 存储桶的作业，您需要批处理 API，请使用 jobs.create 方法并在 volumes 字段中装载该存储桶。

POST https://batch.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/jobs?job_id=JOB_NAME

{
    "taskGroups": [
        {
            "taskSpec": {
                "runnables": [
                    {
                        "script": {
                            "text": "echo Hello world from task ${BATCH_TASK_INDEX}. >> MOUNT_PATH/output_task_${BATCH_TASK_INDEX}.txt"
                        }
                    }
                ],
                "volumes": [
                    {
                        "gcs": {
                            "remotePath": "BUCKET_PATH"
                        },
                        "mountPath": "MOUNT_PATH"
                    }
                ]
            },
            "taskCount": 3
        }
    ],
    "logsPolicy": {
            "destination": "CLOUD_LOGGING"
    }
}

替换以下内容：

PROJECT_ID：项目 ID 项目名称
LOCATION：位置作业的组成部分。
JOB_NAME：作业的名称。
BUCKET_PATH：存储桶目录的路径该名称必须以存储桶例如，对于名为 BUCKET_NAME，路径 BUCKET_NAME 表示根存储桶的目录和路径 BUCKET_NAME/subdirectory 表示 subdirectory 子目录。
MOUNT_PATH：作业的装载路径 Runnable 用于访问此存储桶。路径必须以 /mnt/disks/，后跟您选择的目录或路径。例如，如果您希望以 my-bucket 目录中，请将装载路径设置为 /mnt/disks/my-bucket.