Job erstellen und ausführen, der Speicher-Volumes verwendet

In diesem Dokument wird erläutert, wie Sie einen Batchjob erstellen und ausführen, der ein oder mehrere externe Speicher-Volumes verwendet. Zu den externen Speicheroptionen gehören neue oder vorhandene nichtflüchtige Speicher, neue lokale SSDs, vorhandene Cloud Storage-Buckets und ein bestehendes Netzwerkdateisystem (Network File System, NFS) wie eine Filestore-Dateifreigabe.

Unabhängig davon, ob Sie externe Speicher-Volumes hinzufügen, hat jede Compute Engine-VM für einen Job ein Bootlaufwerk, das Speicher für das Betriebssystem-Image des Jobs und Anweisungen zur Verfügung stellt. Informationen zum Konfigurieren des Bootlaufwerks für einen Job finden Sie stattdessen unter VM-Betriebssystemumgebung – Übersicht.

Hinweise

Wenn Sie Batch noch nicht verwendet haben, lesen Sie Erste Schritte mit Batch. Aktivieren Sie Batch, indem Sie die Voraussetzungen für Projekte und Nutzer erfüllen.
Bitten Sie Ihren Administrator, Ihnen die folgenden IAM-Rollen zu gewähren, damit Sie die Berechtigungen erhalten, die Sie zum Erstellen eines Jobs benötigen:
- Batchjob-Bearbeiter (roles/batch.jobsEditor) für das Projekt
- Dienstkontonutzer (roles/iam.serviceAccountUser) für das Dienstkonto des Jobs, das standardmäßig das Compute Engine-Standarddienstkonto ist
- Erstellen Sie einen Job, der einen Cloud Storage-Bucket verwendet: Storage-Objekt-Betrachter (roles/storage.objectViewer) für den Bucket
Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff verwalten.

Möglicherweise können Sie die erforderlichen Berechtigungen auch über benutzerdefinierte Rollen oder andere vordefinierte Rollen erhalten.

Job erstellen, der Speicher-Volumes verwendet

Optional kann ein Job eines oder mehrere der folgenden Typen externer Speicher-Volumes verwenden. Weitere Informationen zu allen Arten von Speicher-Volumes und den jeweiligen Unterschieden und Einschränkungen finden Sie in der Dokumentation zu Compute Engine-VM-Speicheroptionen.

Nichtflüchtiger Speicher: zonaler oder regionaler nichtflüchtiger Blockspeicher
lokale SSD: Hochleistungs-Blockspeicher vorübergehend
Cloud Storage-Bucket: günstiger Objektspeicher
Netzwerkdateisystem (Network File System, NFS): verteiltes Dateisystem, das dem Network File System-Protokoll folgt, z. B. eine Filestore-Dateifreigabe, ein Hochleistungs-NFS, das in Google Cloud gehostet wird

Sie können zulassen, dass ein Job jedes Speicher-Volume verwendet, indem Sie es in die Definition des Jobs aufnehmen und den Bereitstellungspfad (mountPath) in Ihren Runnables angeben. Informationen zum Erstellen eines Jobs, der Speicher-Volumes verwendet, finden Sie in den folgenden Abschnitten:

Nichtflüchtigen Speicher verwenden
Lokale SSD verwenden
Cloud Storage-Bucket verwenden
Netzwerkdateisystem verwenden

Nichtflüchtigen Speicher verwenden

Für einen Job, der nichtflüchtige Speicher verwendet, gelten die folgenden Einschränkungen:

Alle nichtflüchtigen Speicher: Lesen Sie die Einschränkungen für alle nichtflüchtigen Speicher.

Neue und vorhandene nichtflüchtige Speicher: Jeder nichtflüchtige Speicher in einem Job kann entweder neu (im Job definiert und mit dem Job erstellt) oder bereits vorhanden sein (bereits im Projekt erstellt und im Job angegeben). Nichtflüchtige Speicher müssen formatiert und auf den VMs des Jobs bereitgestellt werden, die sich am selben Speicherort wie der nichtflüchtige Speicher befinden. Alle nichtflüchtigen Speicher, die Sie in einen Job aufnehmen, werden im Batch bereitgestellt und alle neuen nichtflüchtigen Speicher formatiert. Sie müssen jedoch alle vorhandenen nichtflüchtigen Speicher, die ein Job verwenden soll, formatieren und trennen.

Die unterstützten Standort-, Formatierungsoptionen und Bereitstellungsoptionen variieren für neue und vorhandene nichtflüchtige Speicher, wie in der folgenden Tabelle beschrieben:

Neue nichtflüchtige Speicher Vorhandene nichtflüchtige Speicher

Formatoptionen

	Neue nichtflüchtige Speicher	Vorhandene nichtflüchtige Speicher
Formatoptionen	Der nichtflüchtige Speicher wird automatisch mit einem `ext4`-Dateisystem formatiert.	Sie müssen den nichtflüchtigen Speicher formatieren, um ein `ext4`-Dateisystem zu verwenden, bevor Sie es für einen Job nutzen.
Bereitstellungsoptionen	Es werden alle Optionen unterstützt.	Alle Optionen außer Schreibvorgang werden unterstützt. Das liegt an den Einschränkungen des Modus für mehrere Autoren. Sie müssen den nichtflüchtigen Speicher von allen VMs trennen, an die er angehängt ist, bevor Sie ihn für einen Job verwenden können.
Speicherortoptionen	Sie können nur zonale nichtflüchtige Speicher erstellen. Sie können für den Job einen beliebigen Standort auswählen. Der nichtflüchtige Speicher wird in der Zone erstellt, in der Ihr Projekt ausgeführt wird.	Sie können zonale und regionale nichtflüchtige Speicher auswählen. Sie müssen als Speicherort des Jobs (oder, falls angegeben, nur die zulässigen Speicherorte) des Jobs nur Speicherorte angeben, die den gesamten nichtflüchtigen Speicher des Jobs enthalten. Bei einem zonalen nichtflüchtigen Speicher muss der Standort des Jobs beispielsweise die Zone des Laufwerks sein. Bei einem regionalen nichtflüchtigen Speicher muss der Standort des Jobs entweder die Region des Laufwerks oder – bei Angabe von Zonen – eine oder beide Zonen sein, in denen sich der regionale nichtflüchtige Speicher befindet.

Der nichtflüchtige Speicher wird automatisch mit einem ext4-Dateisystem formatiert.

Sie müssen den nichtflüchtigen Speicher formatieren, um ein ext4-Dateisystem zu verwenden, bevor Sie es für einen Job nutzen.

Bereitstellungsoptionen

Es werden alle Optionen unterstützt.

Alle Optionen außer Schreibvorgang werden unterstützt. Das liegt an den Einschränkungen des Modus für mehrere Autoren.

Sie müssen den nichtflüchtigen Speicher von allen VMs trennen, an die er angehängt ist, bevor Sie ihn für einen Job verwenden können.

Speicherortoptionen

Sie können nur zonale nichtflüchtige Speicher erstellen.

Sie können für den Job einen beliebigen Standort auswählen. Der nichtflüchtige Speicher wird in der Zone erstellt, in der Ihr Projekt ausgeführt wird.

Sie können zonale und regionale nichtflüchtige Speicher auswählen.

Sie müssen als Speicherort des Jobs (oder, falls angegeben, nur die zulässigen Speicherorte) des Jobs nur Speicherorte angeben, die den gesamten nichtflüchtigen Speicher des Jobs enthalten. Bei einem zonalen nichtflüchtigen Speicher muss der Standort des Jobs beispielsweise die Zone des Laufwerks sein. Bei einem regionalen nichtflüchtigen Speicher muss der Standort des Jobs entweder die Region des Laufwerks oder – bei Angabe von Zonen – eine oder beide Zonen sein, in denen sich der regionale nichtflüchtige Speicher befindet.

Instanzvorlagen: Wenn Sie beim Erstellen dieses Jobs eine VM-Instanzvorlage verwenden möchten, müssen Sie in der Instanzvorlage alle nichtflüchtigen Speicher für diesen Job anhängen. Wenn Sie keine Instanzvorlage verwenden möchten, müssen Sie jeden nichtflüchtigen Speicher direkt in der Jobdefinition anhängen.

Sie können einen Job erstellen, der einen nichtflüchtigen Speicher verwendet, mit der Google Cloud Console, der gcloud CLI, der Batch API, Go, Java, Node.js, Python oder C++.

Console

Im folgenden Beispiel wird mit der Google Cloud Console ein Job erstellt, der ein Skript zum Lesen einer Datei aus einem vorhandenen zonalen nichtflüchtigen Speicher in der Zone us-central1-a ausführt. Im Beispielskript wird davon ausgegangen, dass der Job einen vorhandenen zonalen nichtflüchtigen Speicher hat, der im Stammverzeichnis eine Textdatei mit dem Namen example.txt enthält.

Optional: Beispiel für einen zonalen nichtflüchtigen Speicher erstellen

Wenn Sie einen zonalen nichtflüchtigen Speicher erstellen möchten, in dem Sie das Beispielskript ausführen können, gehen Sie vor dem Job folgendermaßen vor:

Hängen Sie einen neuen, leeren nichtflüchtigen Speicher mit dem Namen example-disk an eine Linux-VM in der Zone us-central1-a an und führen Sie dann Befehle auf der VM aus, um das Laufwerk zu formatieren und bereitzustellen. Eine Anleitung dazu finden Sie unter Nichtflüchtigen Speicher zu Ihrer VM hinzufügen.

Trennen Sie die Verbindung zur VM noch nicht.
Führen Sie die folgenden Befehle auf der VM aus, um example.txt auf dem nichtflüchtigen Speicher zu erstellen:
1. Geben Sie den folgenden Befehl ein, um vom aktuellen Arbeitsverzeichnis in das Stammverzeichnis des nichtflüchtigen Speichers zu wechseln:
```
cd VM_MOUNT_PATH
```
  Ersetzen Sie VM_MOUNT_PATH durch den Pfad zu dem Verzeichnis, in dem der nichtflüchtige Speicher im vorherigen Schritt auf dieser VM bereitgestellt wurde, z. B. /mnt/disks/example-disk.
2. Drücken Sie Enter.
3. Geben Sie den folgenden Befehl ein, um eine Datei mit dem Namen example.txt zu erstellen und zu definieren:
```
cat > example.txt
```
4. Drücken Sie Enter.
5. Geben Sie den Inhalt der Datei ein. Geben Sie beispielsweise Hello world! ein.
6. Drücken Sie zum Speichern der Datei Ctrl+D (oder Command+D unter macOS).
Wenn Sie fertig sind, können Sie die Verbindung zur VM trennen.
Trennen Sie den nichtflüchtigen Speicher von der VM.
- Wenn Sie die VM nicht mehr benötigen, können Sie die VM löschen. Dadurch wird der nichtflüchtige Speicher automatisch getrennt.
- Andernfalls trennen Sie den nichtflüchtigen Speicher. Eine Anleitung finden Sie unter Bootlaufwerke trennen und neu anhängen. Außerdem sollten Sie den nichtflüchtigen Speicher example-disk anstelle des Bootlaufwerks der VM trennen.

Job erstellen, der den vorhandenen zonalen nichtflüchtigen Speicher verwendet

So erstellen Sie mit der Google Cloud Console einen Job, der vorhandene zonale nichtflüchtige Speicher verwendet:

Rufen Sie in der Google Cloud Console die Seite Jobliste auf.

Zur Jobliste
Klicken Sie auf Erstellen. Die Seite Batchjob erstellen wird geöffnet. Im linken Bereich ist die Seite Jobdetails ausgewählt.
Konfigurieren Sie die Seite Jobdetails:
1. Optional: Passen Sie im Feld Jobname den Jobnamen an.
  
  Geben Sie beispielsweise example-disk-job ein.
2. Konfigurieren Sie den Bereich Aufgabendetails:
  1. Fügen Sie im Fenster New runnable mindestens ein Script oder einen Container für die Ausführung dieses Jobs hinzu.
    
    So führen Sie beispielsweise ein Skript aus, das den Inhalt einer Datei mit dem Namen example.txt ausgibt, die sich im Stammverzeichnis des von diesem Job verwendeten nichtflüchtigen Speichers befindet:
    1. Klicken Sie das Kästchen Script an. Ein Textfeld wird angezeigt.
    2. Geben Sie das folgende Skript in das Textfeld ein:
```
echo "Here is the content of the example.txt file in the persistent disk."
cat MOUNT_PATH/example.txt
```
      Ersetzen Sie MOUNT_PATH durch den Pfad, unter dem Sie den nichtflüchtigen Speicher auf den VMs für diesen Job bereitstellen möchten, z. B. /mnt/disks/example-disk.
    3. Klicken Sie auf Fertig.
  2. Geben Sie im Feld Aufgabenanzahl die Anzahl der Tasks für diesen Job ein.
    
    Geben Sie beispielsweise 1 (Standard) ein.
  3. Geben Sie in das Feld Parallelism die Anzahl der Tasks ein, die gleichzeitig ausgeführt werden sollen.
    
    Geben Sie beispielsweise 1 (Standard) ein.
Konfigurieren Sie die Seite Ressourcenspezifikationen:
1. Klicken Sie im linken Bereich auf Ressourcenspezifikationen. Die Seite Ressourcenspezifikationen wird geöffnet.
2. Wählen Sie den Standort für diesen Job aus. Wenn Sie einen vorhandenen zonalen nichtflüchtigen Speicher verwenden möchten, müssen sich die VMs eines Jobs in derselben Zone befinden.
  1. Wählen Sie im Feld Region eine Region aus.
    
    Wenn Sie beispielsweise den zonalen nichtflüchtigen Beispielspeicher verwenden möchten, wählen Sie us-central1 (Iowa) (Standardeinstellung) aus.
  2. Wählen Sie im Feld Zone eine Zone aus.
    
    Wählen Sie beispielsweise us-central1-a (Iowa) aus.
Konfigurieren Sie die Seite Zusätzliche Konfigurationen:
1. Klicken Sie im linken Bereich auf Zusätzliche Konfigurationen. Die Seite Zusätzliche Konfigurationen wird geöffnet.
2. Führen Sie für jeden vorhandenen zonalen nichtflüchtigen Speicher, den Sie für diesen Job bereitstellen möchten, die folgenden Schritte aus:
  1. Klicken Sie im Abschnitt Speicher-Volume auf Neues Volume hinzufügen. Das Fenster Neues Volume wird angezeigt.
  2. Führen Sie im Fenster Neues Volume die folgenden Schritte aus:
    1. Wählen Sie im Abschnitt Volume-Typ die Option Nichtflüchtiger Speicher (Standardeinstellung) aus.
    2. Wählen Sie in der Liste Laufwerk einen vorhandenen zonalen nichtflüchtigen Speicher aus, den Sie für diesen Job bereitstellen möchten. Das Laufwerk muss sich in derselben Zone wie dieser Job befinden.
      
      Wählen Sie beispielsweise den vorbereiteten zonalen nichtflüchtigen Speicher aus, der sich in der Zone us-central1-a befindet und die Datei example.txt enthält.
    3. Optional: Wenn Sie diesen zonalen nichtflüchtigen Speicher umbenennen möchten, gehen Sie so vor:
      1. Wählen Sie Gerätenamen anpassen aus.
      2. Geben Sie im Feld Gerätename den neuen Namen für das Laufwerk ein.
    4. Geben Sie im Feld Bereitstellungspfad den Bereitstellungspfad (MOUNT_PATH) für den nichtflüchtigen Speicher ein:
      
      Geben Sie beispielsweise Folgendes ein:
```
/mnt/disks/EXISTING_PERSISTENT_DISK_NAME
```
      Ersetzen Sie EXISTING_PERSISTENT_DISK_NAME durch den Namen des Laufwerks. Wenn Sie den zonalen nichtflüchtigen Speicher umbenannt haben, verwenden Sie den neuen Namen.
      
      Ersetzen Sie beispielsweise EXISTING_PERSISTENT_DISK_NAME durch example-disk.
    5. Klicken Sie auf Fertig.
Optional: Konfigurieren Sie die anderen Felder für diesen Job.
Optional: Klicken Sie im linken Bereich auf Vorschau, um die Jobkonfiguration zu prüfen.
Klicken Sie auf Erstellen.

Auf der Seite Jobdetails wird der von Ihnen erstellte Job angezeigt.

gcloud

Im folgenden Beispiel wird mit der gcloud CLI ein Job erstellt, der einen vorhandenen nichtflüchtigen Speicher und einen neuen nichtflüchtigen Speicher anhängt und bereitstellt. Der Job hat drei Aufgaben, die jeweils ein Skript zum Erstellen einer Datei im neuen nichtflüchtigen Speicher output_task_TASK_INDEX.txt ausführen, wobei TASK_INDEX der Index der einzelnen Aufgaben ist: 0, 1 und 2.

Verwenden Sie den Befehl gcloud batch jobs submit, um über die gcloud CLI einen Job zu erstellen, der nichtflüchtige Speicher verwendet. Geben Sie in der JSON-Konfigurationsdatei des Jobs die nichtflüchtigen Speicher im Feld instances an und stellen Sie den nichtflüchtigen Speicher im Feld volumes bereit.

Erstellen Sie eine JSON-Datei.
- Wenn Sie keine Instanzvorlage für diesen Job verwenden, erstellen Sie eine JSON-Datei mit folgendem Inhalt:
```
{
    "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"
    }
}
```
  Ersetzen Sie Folgendes:
  - PROJECT_ID: die Projekt-ID Ihres Projekts.
  - EXISTING_PERSISTENT_DISK_NAME: durch den Namen eines vorhandenen nichtflüchtigen Speichers
  - EXISTING_PERSISTENT_DISK_LOCATION: der Speicherort eines vorhandenen nichtflüchtigen Speichers. Bei jedem vorhandenen zonalen nichtflüchtigen Speicher muss der Jobstandort die Zone des Laufwerks sein. Für jeden vorhandenen regionalen nichtflüchtigen Speicher muss der Speicherort des Jobs entweder die Region des Laufwerks oder, bei Angabe von Zonen, eine oder beide Zonen sein, in denen sich der regionale nichtflüchtige Speicher befindet. Wenn Sie keine vorhandenen nichtflüchtigen Speicher angeben, können Sie einen beliebigen Speicherort auswählen. Weitere Informationen zum Feld allowedLocations
  - NEW_PERSISTENT_DISK_SIZE: durch die Größe des neuen nichtflüchtigen Speichers in GB. Die zulässigen Größen hängen vom Typ des nichtflüchtigen Speichers ab. Die Mindestgröße beträgt jedoch häufig 10 GB (10) und die maximale Größe oft 64 TB (64000).
  - NEW_PERSISTENT_DISK_TYPE: durch den Laufwerkstyp des neuen nichtflüchtigen Speichers, entweder pd-standard, pd-balanced, pd-ssd oder pd-extreme. Für Batchjobs ist der Standardwert pd-balanced.
  - NEW_PERSISTENT_DISK_NAME: durch den Namen des neuen nichtflüchtigen Speichers.
- Wenn Sie eine VM-Instanzvorlage für diesen Job verwenden, erstellen Sie wie oben gezeigt eine JSON-Datei. Ersetzen Sie dabei das Feld instances jedoch durch Folgendes:
```
"instances": [
    {
        "instanceTemplate": "INSTANCE_TEMPLATE_NAME"
    }
],
```
  Dabei ist INSTANCE_TEMPLATE_NAME der Name der Instanzvorlage für diesen Job. Bei einem Job, der nichtflüchtige Speicher verwendet, muss diese Instanzvorlage die nichtflüchtigen Speicher definieren und anhängen, die der Job verwenden soll. Für dieses Beispiel muss die Vorlage einen neuen nichtflüchtigen Speicher mit dem Namen NEW_PERSISTENT_DISK_NAME definieren und anhängen sowie einen vorhandenen nichtflüchtigen Speicher mit dem Namen EXISTING_PERSISTENT_DISK_NAME anhängen.
Führen Sie dazu diesen Befehl aus:
```
gcloud batch jobs submit JOB_NAME \
  --location LOCATION \
  --config JSON_CONFIGURATION_FILE
```
Ersetzen Sie Folgendes:
- JOB_NAME: der Name des Jobs.
- LOCATION: der Standort des Jobs.
- JSON_CONFIGURATION_FILE: der Pfad für eine JSON-Datei mit den Konfigurationsdetails des Jobs.

API

Im folgenden Beispiel wird mit der Batch API ein Job erstellt, bei dem ein vorhandener nichtflüchtiger Speicher und ein neuer nichtflüchtiger Speicher hinzugefügt und bereitgestellt werden. Der Job hat drei Aufgaben, die jeweils ein Skript zum Erstellen einer Datei im neuen nichtflüchtigen Speicher output_task_TASK_INDEX.txt ausführen, wobei TASK_INDEX der Index der einzelnen Aufgaben ist: 0, 1 und 2.

Verwenden Sie die Methode jobs.create, um mit der Batch API einen Job zu erstellen, der nichtflüchtige Speicher verwendet. Geben Sie in der Anfrage die nichtflüchtigen Speicher im Feld instances an und stellen Sie den nichtflüchtigen Speicher im Feld volumes bereit.

Wenn Sie keine Instanzvorlage für diesen Job verwenden, stellen Sie die folgende Anfrage:

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"
    }
}

Ersetzen Sie Folgendes:

PROJECT_ID: die Projekt-ID Ihres Projekts.
LOCATION: der Standort des Jobs.
JOB_NAME: der Name des Jobs.
EXISTING_PERSISTENT_DISK_NAME: durch den Namen eines vorhandenen nichtflüchtigen Speichers
EXISTING_PERSISTENT_DISK_LOCATION: durch den Speicherort eines vorhandenen nichtflüchtigen Speichers. Bei jedem vorhandenen zonalen nichtflüchtigen Speicher muss der Standort des Jobs die Zone des Laufwerks sein. Für jeden vorhandenen regionalen nichtflüchtigen Speicher muss der Standort des Jobs entweder die Region des Laufwerks oder, bei Angabe von Zonen, eine oder beide Zonen sein, in denen sich der regionale nichtflüchtige Speicher befindet. Wenn Sie keinen vorhandenen nichtflüchtigen Speicher angeben, können Sie einen beliebigen Speicherort auswählen. Weitere Informationen zum Feld allowedLocations.
NEW_PERSISTENT_DISK_SIZE: durch die Größe des neuen nichtflüchtigen Speichers in GB. Die zulässigen Größen hängen vom Typ des nichtflüchtigen Speichers ab. Die Mindestgröße beträgt jedoch häufig 10 GB (10) und die maximale Größe oft 64 TB (64000).
NEW_PERSISTENT_DISK_TYPE: durch den Laufwerkstyp des neuen nichtflüchtigen Speichers, entweder pd-standard, pd-balanced, pd-ssd oder pd-extreme. Für Batchjobs ist der Standardwert pd-balanced.
NEW_PERSISTENT_DISK_NAME: durch den Namen des neuen nichtflüchtigen Speichers.

Wenn Sie eine VM-Instanzvorlage für diesen Job verwenden, erstellen Sie wie oben gezeigt eine JSON-Datei. Ersetzen Sie dabei das Feld instances jedoch durch Folgendes:
```
"instances": [
    {
        "instanceTemplate": "INSTANCE_TEMPLATE_NAME"
    }
],
...
```
Dabei ist INSTANCE_TEMPLATE_NAME der Name der Instanzvorlage für diesen Job. Bei einem Job, der nichtflüchtige Speicher verwendet, muss diese Instanzvorlage die nichtflüchtigen Speicher definieren und anhängen, die der Job verwenden soll. Für dieses Beispiel muss die Vorlage einen neuen nichtflüchtigen Speicher mit dem Namen NEW_PERSISTENT_DISK_NAME definieren und anhängen sowie einen vorhandenen nichtflüchtigen Speicher mit dem Namen EXISTING_PERSISTENT_DISK_NAME anhängen.

Einfach loslegen (Go)

Um einen Batchjob zu erstellen, der neue oder vorhandene nichtflüchtige Speicher mithilfe der Cloud-Clientbibliotheken für Go verwendet, verwenden Sie die Funktion CreateJob und fügen Sie Folgendes ein:

Fügen Sie zum Anhängen von nichtflüchtigem Speicher an die VMs für einen Job eine der folgenden Optionen ein:
- Wenn Sie keine VM-Instanzvorlage für diesen Job verwenden, fügen Sie den Typ AllocationPolicy_AttachedDisk ein.
- Wenn Sie eine VM-Instanzvorlage für diesen Job verwenden, fügen Sie den Typ AllocationPolicy_InstancePolicyOrTemplate_InstanceTemplate ein.
Verwenden Sie zum Bereitstellen des nichtflüchtigen Speichers für den Job den Typ Volume mit dem Typ Volume_DeviceName und dem Feld MountPath. Verwenden Sie für neue nichtflüchtige Speicher auch das Feld MountOptions, um das Schreiben zu aktivieren.