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.
-
Batchjob-Bearbeiter (
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 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 Zoneus-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: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
.Drücken Sie
Enter
.Geben Sie den folgenden Befehl ein, um eine Datei mit dem Namen
example.txt
zu erstellen und zu definieren:cat > example.txt
Drücken Sie
Enter
.Geben Sie den Inhalt der Datei ein. Geben Sie beispielsweise
Hello world!
ein.Drücken Sie zum Speichern der Datei
Ctrl+D
(oderCommand+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.
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:
Optional: Passen Sie im Feld Jobname den Jobnamen an.
Geben Sie beispielsweise
example-disk-job
ein.Konfigurieren Sie den Bereich Aufgabendetails:
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:Klicken Sie das Kästchen Script an. Ein Textfeld wird angezeigt.
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
.Klicken Sie auf Fertig.
Geben Sie im Feld Aufgabenanzahl die Anzahl der Tasks für diesen Job ein.
Geben Sie beispielsweise
1
(Standard) ein.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:
Klicken Sie im linken Bereich auf Ressourcenspezifikationen. Die Seite Ressourcenspezifikationen wird geöffnet.
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.
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.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:
Klicken Sie im linken Bereich auf Zusätzliche Konfigurationen. Die Seite Zusätzliche Konfigurationen wird geöffnet.
Führen Sie für jeden vorhandenen zonalen nichtflüchtigen Speicher, den Sie für diesen Job bereitstellen möchten, die folgenden Schritte aus:
Klicken Sie im Abschnitt Speicher-Volume auf Neues Volume hinzufügen. Das Fenster Neues Volume wird angezeigt.
Führen Sie im Fenster Neues Volume die folgenden Schritte aus:
Wählen Sie im Abschnitt Volume-Typ die Option Nichtflüchtiger Speicher (Standardeinstellung) aus.
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 Dateiexample.txt
enthält.Optional: Wenn Sie diesen zonalen nichtflüchtigen Speicher umbenennen möchten, gehen Sie so vor:
Wählen Sie Gerätenamen anpassen aus.
Geben Sie im Feld Gerätename den neuen Namen für das Laufwerk ein.
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
.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 SpeichersEXISTING_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 FeldallowedLocations
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, entwederpd-standard
,pd-balanced
,pd-ssd
oderpd-extreme
. Für Batchjobs ist der Standardwertpd-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 NamenNEW_PERSISTENT_DISK_NAME
definieren und anhängen sowie einen vorhandenen nichtflüchtigen Speicher mit dem NamenEXISTING_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 SpeichersEXISTING_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 FeldallowedLocations
.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, entwederpd-standard
,pd-balanced
,pd-ssd
oderpd-extreme
. Für Batchjobs ist der Standardwertpd-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 NamenNEW_PERSISTENT_DISK_NAME
definieren und anhängen sowie einen vorhandenen nichtflüchtigen Speicher mit dem NamenEXISTING_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.
- Wenn Sie keine VM-Instanzvorlage für diesen Job verwenden, fügen Sie den Typ
- Verwenden Sie zum Bereitstellen des nichtflüchtigen Speichers für den Job den Typ
Volume
mit dem TypVolume_DeviceName
und dem FeldMountPath
. Verwenden Sie für neue nichtflüchtige Speicher auch das FeldMountOptions
, um das Schreiben zu aktivieren.
Ein Codebeispiel für einen ähnlichen Anwendungsfall finden Sie unter Cloud Storage-Bucket verwenden.
Java
Zum Erstellen eines Batchjobs, der neue oder vorhandene nichtflüchtige Speicher mit den Cloud-Clientbibliotheken für Java verwendet, verwenden Sie die Klasse CreateJobRequest
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 für diesen Job keine VM-Instanzvorlage verwenden, fügen Sie die Methode
setDisks
ein. - Wenn Sie eine VM-Instanzvorlage für diesen Job verwenden, fügen Sie die Methode
setInstanceTemplate
ein.
- Wenn Sie für diesen Job keine VM-Instanzvorlage verwenden, fügen Sie die Methode
- Verwenden Sie zum Bereitstellen des nichtflüchtigen Speichers für den Job die Klasse
Volume
mit der MethodesetDeviceName
und der MethodesetMountPath
. Verwenden Sie für neue nichtflüchtige Speicher auch die MethodesetMountOptions
, um das Schreiben zu aktivieren.
Ein Codebeispiel für einen ähnlichen Anwendungsfall finden Sie unter Cloud Storage-Bucket verwenden.
Node.js
Um einen Batchjob zu erstellen, der neue oder vorhandene nichtflüchtige Speicher mithilfe der Cloud-Clientbibliotheken für Node.js verwendet, verwenden Sie die Methode 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 die Klasse
AllocationPolicy.AttachedDisk
ein. - Wenn Sie eine VM-Instanzvorlage für diesen Job verwenden, fügen Sie das Attribut
instanceTemplate
ein.
- Wenn Sie keine VM-Instanzvorlage für diesen Job verwenden, fügen Sie die Klasse
- Verwenden Sie zum Bereitstellen des nichtflüchtigen Speichers für den Job die Klasse
Volume
mit den AttributendeviceName
undmountPath
. Verwenden Sie für neue nichtflüchtige Speicher auch das AttributmountOptions
, um das Schreiben zu aktivieren.
Ein Codebeispiel für einen ähnlichen Anwendungsfall finden Sie unter Cloud Storage-Bucket verwenden.
Python
Zum Erstellen eines Batch-Jobs, der neue oder vorhandene nichtflüchtige Speicher mit den Cloud-Clientbibliotheken für Python verwendet, verwenden Sie die CreateJob
-Funktion 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 die Klasse
AttachedDisk
ein. - Wenn Sie eine VM-Instanzvorlage für diesen Job verwenden, fügen Sie das Attribut
instance_template
hinzu.
- Wenn Sie keine VM-Instanzvorlage für diesen Job verwenden, fügen Sie die Klasse
- Wenn Sie nichtflüchtige Speicher für den Job bereitstellen möchten, verwenden Sie die Klasse
Volume
mit den Attributendevice_name
undmount_path
. Verwenden Sie für neue nichtflüchtige Speicher auch das Attributmount_options
, um das Schreiben zu aktivieren.
Ein Codebeispiel für einen ähnlichen Anwendungsfall finden Sie unter Cloud Storage-Bucket verwenden.
C++
Um einen Batchjob zu erstellen, der neue oder vorhandene nichtflüchtige Speicher mithilfe der Cloud-Clientbibliotheken für C++ 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 für diesen Job keine VM-Instanzvorlage verwenden, verwenden Sie die Methode
set_remote_path
. - Wenn Sie eine VM-Instanzvorlage für diesen Job verwenden, nutzen Sie die Methode
set_instance_template
.
- Wenn Sie für diesen Job keine VM-Instanzvorlage verwenden, verwenden Sie die Methode
- Verwenden Sie das Feld
volumes
mit den FelderndeviceName
undmountPath
, um den nichtflüchtigen Speicher für den Job bereitzustellen. Verwenden Sie für neue nichtflüchtige Speicher auch das FeldmountOptions
, um das Schreiben zu aktivieren.
Ein Codebeispiel für einen ähnlichen Anwendungsfall finden Sie unter Cloud Storage-Bucket verwenden.
Lokale SSD verwenden
Für einen Job, der lokale SSDs verwendet, gelten die folgenden Einschränkungen:
- Alle lokalen SSDs: Sehen Sie sich die Einschränkungen für alle lokalen SSDs an.
- Instanzvorlagen: Wenn Sie beim Erstellen dieses Jobs eine VM-Instanzvorlage angeben möchten, müssen Sie für diesen Job in der Instanzvorlage alle nichtflüchtigen Speicher 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 mit einer lokalen SSD über die gcloud CLI oder Batch API erstellen.
Im folgenden Beispiel wird beschrieben, wie Sie einen Job erstellen, bei dem eine lokale SSD erstellt, angehängt und bereitgestellt wird. Der Job hat außerdem drei Aufgaben, die jeweils ein Skript zum Erstellen einer Datei auf der lokalen SSD mit dem Namen output_task_TASK_INDEX.txt
ausführen, wobei TASK_INDEX
der Index der einzelnen Aufgaben ist: 0
, 1
und 2
.
gcloud
Verwenden Sie den Befehl gcloud batch jobs submit
, um über die gcloud CLI einen Job zu erstellen, der lokale SSDs verwendet.
Erstellen Sie in der JSON-Konfigurationsdatei des Jobs die lokalen SSDs im Feld instances
und hängen Sie sie an. Stellen Sie die lokalen SSDs 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": { "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" } }
Ersetzen Sie Folgendes:
MACHINE_TYPE
: der Maschinentyp der VMs des Jobs, der vordefiniert oder benutzerdefiniert sein kann. Die zulässige Anzahl lokaler SSDs hängt vom Maschinentyp für die VMs des Jobs ab.LOCAL_SSD_NAME
: der Name einer lokalen SSD, die für diesen Job erstellt wurde.LOCAL_SSD_SIZE
: die Größe aller lokalen SSDs in GB. Jede lokale SSD ist 375 GB groß, sodass dieser Wert ein Vielfaches von375
GB sein muss. Legen Sie beispielsweise bei 2 lokalen SSDs diesen Wert auf750
GB fest.
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 lokale SSDs verwendet, müssen in dieser Instanzvorlage die lokalen SSDs definiert und angehängt werden, die der Job verwenden soll. Für dieses Beispiel muss in der Vorlage eine lokale SSD mit dem NamenLOCAL_SSD_NAME
definiert und angehängt werden.
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
Verwenden Sie die Methode jobs.create
, um mit der Batch API einen Job zu erstellen, der lokale SSDs verwendet.
Erstellen Sie in der Anfrage die lokalen SSDs im Feld instances
und hängen Sie sie an. Stellen Sie die lokalen SSDs 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": { "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" } }
Ersetzen Sie Folgendes:
PROJECT_ID
: die Projekt-ID Ihres Projekts.LOCATION
: der Standort des Jobs.JOB_NAME
: der Name des Jobs.MACHINE_TYPE
: der Maschinentyp der VMs des Jobs, der vordefiniert oder benutzerdefiniert sein kann. Die zulässige Anzahl lokaler SSDs hängt vom Maschinentyp für die VMs des Jobs ab.LOCAL_SSD_NAME
: der Name einer lokalen SSD, die für diesen Job erstellt wurde.LOCAL_SSD_SIZE
: die Größe aller lokalen SSDs in GB. Jede lokale SSD ist 375 GB groß, sodass dieser Wert ein Vielfaches von375
GB sein muss. Legen Sie beispielsweise bei 2 lokalen SSDs diesen Wert auf750
GB fest.
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 lokale SSDs verwendet, müssen in dieser Instanzvorlage die lokalen SSDs definiert und angehängt werden, die der Job verwenden soll. Für dieses Beispiel muss in der Vorlage eine lokale SSD mit dem NamenLOCAL_SSD_NAME
definiert und angehängt werden.
Cloud Storage-Bucket verwenden
Wählen Sie eine der folgenden Methoden aus, um einen Job zu erstellen, der einen vorhandenen Cloud Storage-Bucket verwendet:
- Empfohlen: Stellen Sie einen Bucket direkt auf den VMs des Jobs bereit. Geben Sie dazu den Bucket in der Definition des Jobs an, wie in diesem Abschnitt gezeigt. Bei der Ausführung des Jobs wird der Bucket mit Cloud Storage FUSE automatisch auf den VMs für den Job bereitgestellt.
- Erstellen Sie einen Job mit Aufgaben, die direkt auf einen Cloud Storage-Bucket zugreifen. Verwenden Sie dazu das
gsutil
-Befehlszeilentool oder die Clientbibliotheken für die Cloud Storage API. Informationen zum direkten Zugriff auf einen Cloud Storage-Bucket von einer VM aus finden Sie in der Compute Engine-Dokumentation unter Daten in Cloud Storage-Buckets schreiben und lesen.
Erstellen Sie vor dem Erstellen eines Jobs, der einen Bucket verwendet, einen Bucket oder identifizieren Sie einen vorhandenen Bucket. Weitere Informationen finden Sie unter Buckets erstellen und Buckets auflisten.
Sie können einen Job erstellen, der einen Cloud Storage-Bucket verwendet, und zwar mit der Google Cloud Console, der gcloud CLI, der Batch API, Go, Java, Node.js, Python oder C++.
Im folgenden Beispiel wird beschrieben, wie Sie einen Job erstellen, der einen Cloud Storage-Bucket bereitstellt. Der Job enthält außerdem drei Aufgaben, die jeweils ein Skript zum Erstellen einer Datei im Bucket output_task_TASK_INDEX.txt
ausführen, wobei TASK_INDEX
der Index der einzelnen Aufgaben ist: 0
, 1
und 2
.
Console
So erstellen Sie mit der Google Cloud Console einen Job, der einen Cloud Storage-Bucket verwendet:
Rufen Sie in der Google Cloud Console die Seite Jobliste auf.
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:
Optional: Passen Sie im Feld Jobname den Jobnamen an.
Geben Sie beispielsweise
example-bucket-job
ein.Konfigurieren Sie den Bereich Aufgabendetails:
Fügen Sie im Fenster New runnable mindestens ein Script oder einen Container für die Ausführung dieses Jobs hinzu.
Gehen Sie beispielsweise so vor:
Klicken Sie das Kästchen Script an. Ein Textfeld wird angezeigt.
Geben Sie das folgende Skript in das Textfeld ein:
echo Hello world from task ${BATCH_TASK_INDEX}. >> MOUNT_PATH/output_task_${BATCH_TASK_INDEX}.txt
Ersetzen Sie MOUNT_PATH durch den Bereitstellungspfad, mit dem die Runnables dieses Jobs auf einen vorhandenen Cloud Storage-Bucket zugreifen. Der Pfad muss mit
/mnt/disks/
beginnen, gefolgt von einem ausgewählten Verzeichnis oder Pfad. Wenn Sie diesen Bucket beispielsweise mit einem Verzeichnis namensmy-bucket
darstellen möchten, legen Sie den Bereitstellungspfad auf/mnt/disks/my-bucket
fest.Klicken Sie auf Fertig.
Geben Sie im Feld Aufgabenanzahl die Anzahl der Tasks für diesen Job ein.
Geben Sie beispielsweise
3
ein.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 Zusätzliche Konfigurationen:
Klicken Sie im linken Bereich auf Zusätzliche Konfigurationen. Die Seite Zusätzliche Konfigurationen wird geöffnet.
Führen Sie für jeden Cloud Storage-Bucket, den Sie für diesen Job bereitstellen möchten, die folgenden Schritte aus:
Klicken Sie im Abschnitt Speicher-Volume auf Neues Volume hinzufügen. Das Fenster Neues Volume wird angezeigt.
Führen Sie im Fenster Neues Volume die folgenden Schritte aus:
Wählen Sie im Abschnitt Volume-Typ die Option Cloud Storage-Bucket aus.
Geben Sie im Feld Name des Storage-Buckets den Namen eines vorhandenen Buckets ein.
Geben Sie beispielsweise den Bucket ein, den Sie im Runnable dieses Jobs angegeben haben.
Geben Sie im Feld Bereitstellungspfad den Bereitstellungspfad des Buckets (MOUNT_PATH) ein, den Sie im Runnable angegeben haben.
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
Verwenden Sie den Befehl gcloud batch jobs submit
, um über die gcloud CLI einen Job zu erstellen, der einen Cloud Storage-Bucket verwendet.
Stellen Sie den Bucket in der JSON-Konfigurationsdatei des Jobs im Feld volumes
bereit.
So erstellen Sie beispielsweise einen Job, der Dateien an einen Cloud Storage ausgibt:
Erstellen Sie eine package.json-Datei mit folgendem Inhalt:
{ "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" } }
Ersetzen Sie Folgendes:
BUCKET_PATH
: Der Pfad des Bucket-Verzeichnisses, auf das dieser Job zugreifen soll. Der Pfad muss mit dem Namen des Buckets beginnen. Bei einem Bucket mit dem NamenBUCKET_NAME
steht beispielsweise der PfadBUCKET_NAME
für das Stammverzeichnis des Buckets und der PfadBUCKET_NAME/subdirectory
für das Unterverzeichnissubdirectory
.MOUNT_PATH
: der Bereitstellungspfad, mit dem die Runnables des Jobs auf diesen Bucket zugreifen. Der Pfad muss mit/mnt/disks/
beginnen, gefolgt von einem ausgewählten Verzeichnis oder Pfad. Wenn Sie diesen Bucket beispielsweise mit einem Verzeichnis namensmy-bucket
darstellen möchten, legen Sie den Bereitstellungspfad auf/mnt/disks/my-bucket
fest.
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
Verwenden Sie zum Erstellen eines Jobs, der einen Cloud Storage-Bucket mit der Batch API verwendet, die Methode jobs.create
und stellen Sie den Bucket im Feld volumes
bereit.
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"
}
}
Ersetzen Sie Folgendes:
PROJECT_ID
: die Projekt-ID Ihres Projekts.LOCATION
: der Standort des Jobs.JOB_NAME
: der Name des Jobs.BUCKET_PATH
: der Pfad des Bucket-Verzeichnisses, auf das dieser Job zugreifen soll. Der Pfad muss mit dem Namen des Buckets beginnen. Bei einem Bucket mit dem NamenBUCKET_NAME
steht beispielsweise der PfadBUCKET_NAME
für das Stammverzeichnis des Buckets und der PfadBUCKET_NAME/subdirectory
für das Unterverzeichnissubdirectory
.MOUNT_PATH
: der Bereitstellungspfad, mit dem die Runnables des Jobs auf diesen Bucket zugreifen. Der Pfad muss mit/mnt/disks/
beginnen, gefolgt von einem ausgewählten Verzeichnis oder Pfad. Wenn Sie diesen Bucket beispielsweise mit einem Verzeichnis namensmy-bucket
darstellen möchten, legen Sie den Bereitstellungspfad auf/mnt/disks/my-bucket
fest.
Einfach loslegen (Go)
Go
Weitere Informationen findest du in der Referenzdokumentation zur Batch Go API.
Richten Sie Standardanmeldedaten für Anwendungen ein, um sich bei Batch zu authentifizieren. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.
Java
Java
Weitere Informationen findest du in der Referenzdokumentation zur Batch Java API.
Richten Sie Standardanmeldedaten für Anwendungen ein, um sich bei Batch zu authentifizieren. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.
Node.js
Node.js
Weitere Informationen findest du in der Referenzdokumentation zur Batch Node.js API.
Richten Sie Standardanmeldedaten für Anwendungen ein, um sich bei Batch zu authentifizieren. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.
Python
Python
Weitere Informationen findest du in der Referenzdokumentation zur Batch Python API.
Richten Sie Standardanmeldedaten für Anwendungen ein, um sich bei Batch zu authentifizieren. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.
C++
C++
Weitere Informationen findest du in der Referenzdokumentation zur Batch C++ API.
Richten Sie Standardanmeldedaten für Anwendungen ein, um sich bei Batch zu authentifizieren. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.
Netzwerkdateisystem verwenden
Sie können einen Job erstellen, der ein vorhandenes Network File System (NFS) verwendet, z. B. eine Filestore-Dateifreigabe, mit der Google Cloud Console, der gcloud CLI oder der Batch API.
Achten Sie vor dem Erstellen eines Jobs, der ein NFS verwendet, dafür, dass die Firewall Ihres Netzwerks so konfiguriert ist, dass Traffic zwischen den VMs des Jobs und dem NFS zugelassen wird. Weitere Informationen finden Sie unter Firewallregeln für Filestore konfigurieren.
In diesem Beispiel wird beschrieben, wie Sie einen Job erstellen, der ein NFS angibt und bereitstellt. Der Job hat außerdem drei Aufgaben, die jeweils ein Skript zum Erstellen einer Datei im NFS mit dem Namen output_task_TASK_INDEX.txt
ausführen, wobei TASK_INDEX
der Index der einzelnen Aufgaben ist: 0
, 1
und 2
.
Console
So erstellen Sie in der Google Cloud Console einen Job, der NFS verwendet:
Rufen Sie in der Google Cloud Console die Seite Jobliste auf.
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:
Optional: Passen Sie im Feld Jobname den Jobnamen an.
Geben Sie beispielsweise
example-nfs-job
ein.Konfigurieren Sie den Bereich Aufgabendetails:
Fügen Sie im Fenster New runnable mindestens ein Script oder einen Container für die Ausführung dieses Jobs hinzu.
Gehen Sie beispielsweise so vor:
Klicken Sie das Kästchen Script an. Ein Textfeld wird angezeigt.
Geben Sie das folgende Skript in das Textfeld ein:
echo Hello world from task ${BATCH_TASK_INDEX}. >> MOUNT_PATH/output_task_${BATCH_TASK_INDEX}.txt
Ersetzen Sie MOUNT_PATH durch den Bereitstellungspfad, den das ausführbare Netzwerk des Jobs für den Zugriff auf dieses NFS verwendet. Der Pfad muss mit
/mnt/disks/
beginnen, gefolgt von einem ausgewählten Verzeichnis oder Pfad. Wenn Sie beispielsweise dieses NFS mit einem Verzeichnis namensmy-nfs
darstellen möchten, legen Sie den Bereitstellungspfad auf/mnt/disks/my-nfs
fest.Klicken Sie auf Fertig.
Geben Sie im Feld Aufgabenanzahl die Anzahl der Tasks für diesen Job ein.
Geben Sie beispielsweise
3
ein.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 Zusätzliche Konfigurationen:
Klicken Sie im linken Bereich auf Zusätzliche Konfigurationen. Die Seite Zusätzliche Konfigurationen wird geöffnet.
Führen Sie für jeden Cloud Storage-Bucket, den Sie für diesen Job bereitstellen möchten, die folgenden Schritte aus:
Klicken Sie im Abschnitt Speicher-Volume auf Neues Volume hinzufügen. Das Fenster Neues Volume wird angezeigt.
Führen Sie im Fenster Neues Volume die folgenden Schritte aus:
Wählen Sie im Abschnitt Volume-Typ die Option Netzwerkdateisystem aus.
Geben Sie im Feld Dateiserver die IP-Adresse des Servers ein, auf dem sich das NFS-Feld befindet, das Sie im Runnable dieses Jobs angegeben haben.
Wenn Ihr NFS beispielsweise eine Filestore-Dateifreigabe ist, geben Sie die IP-Adresse der Filestore-Instanz an, die Sie durch Beschreiben der Filestore-Instanz abrufen können.
Geben Sie im Feld Remote-Pfad einen Pfad ein, der auf das im vorherigen Schritt angegebene NFS zugreifen kann.
Der Pfad des NFS-Verzeichnisses muss mit einem
/
beginnen, gefolgt vom Stammverzeichnis des NFS.Geben Sie im Feld Bereitstellungspfad den Bereitstellungspfad für NFS (MOUNT_PATH) ein, den Sie im vorherigen Schritt angegeben haben.
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
Verwenden Sie den Befehl gcloud batch jobs submit
, um über die gcloud CLI einen Job zu erstellen, der NFS verwendet.
Stellen Sie in der JSON-Konfigurationsdatei des Jobs das NFS im Feld volumes
bereit.
Erstellen Sie eine package.json-Datei mit folgendem Inhalt:
{ "taskGroups": [ { "taskSpec": { "runnables": [ { "script": { "text": "echo Hello world from task ${BATCH_TASK_INDEX}. >> MOUNT_PATH/output_task_${BATCH_TASK_INDEX}.txt" } } ], "volumes": [ { "nfs": { "server": "NFS_IP_ADDRESS", "remotePath": "NFS_PATH" }, "mountPath": "MOUNT_PATH" } ] }, "taskCount": 3 } ], "logsPolicy": { "destination": "CLOUD_LOGGING" } }
Ersetzen Sie Folgendes:
NFS_IP_ADDRESS
: die IP-Adresse des NFS. Wenn Ihre NFS-Datei beispielsweise eine Filestore-Dateifreigabe ist, geben Sie die IP-Adresse der Filestore-Instanz an, die Sie durch Beschreiben der Filestore-Instanz abrufen können.NFS_PATH
: Der Pfad des NFS-Verzeichnisses, auf das dieser Job zugreifen soll. Er muss mit einem/
beginnen, gefolgt vom Stammverzeichnis des NFS. Bei einer Filestore-Dateifreigabe mit dem NamenFILE_SHARE_NAME
steht beispielsweise der Pfad/FILE_SHARE_NAME
für das Stammverzeichnis der Dateifreigabe und der Pfad/FILE_SHARE_NAME/subdirectory
für das Unterverzeichnissubdirectory
.MOUNT_PATH
: Der Bereitstellungspfad, den die Runnables des Jobs für den Zugriff auf dieses NFS verwenden. Der Pfad muss mit/mnt/disks/
beginnen, gefolgt von einem ausgewählten Verzeichnis oder Pfad. Wenn Sie beispielsweise dieses NFS mit einem Verzeichnis namensmy-nfs
darstellen möchten, legen Sie den Bereitstellungspfad auf/mnt/disks/my-nfs
fest.
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
Verwenden Sie die Methode jobs.create
und stellen Sie das NFS im Feld volumes
bereit, um mit der Batch API einen Job zu erstellen, der NFS verwendet.
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": [
{
"nfs": {
"server": "NFS_IP_ADDRESS",
"remotePath": "NFS_PATH"
},
"mountPath": "MOUNT_PATH"
}
]
},
"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.NFS_IP_ADDRESS
: die IP-Adresse des Netzwerkdateisystems. Wenn Ihre NFS-Datei beispielsweise eine Filestore-Dateifreigabe ist, geben Sie die IP-Adresse der Filestore-Instanz an, die Sie durch Beschreiben der Filestore-Instanz abrufen können.NFS_PATH
: Der Pfad des NFS-Verzeichnisses, auf das dieser Job zugreifen soll. Er muss mit einem/
beginnen, gefolgt vom Stammverzeichnis des NFS. Bei einer Filestore-Dateifreigabe mit dem NamenFILE_SHARE_NAME
steht beispielsweise der Pfad/FILE_SHARE_NAME
für das Stammverzeichnis der Dateifreigabe und der Pfad/FILE_SHARE_NAME/subdirectory
für ein Unterverzeichnis.MOUNT_PATH
: Der Bereitstellungspfad, den die Runnables des Jobs für den Zugriff auf dieses NFS verwenden. Der Pfad muss mit/mnt/disks/
beginnen, gefolgt von einem ausgewählten Verzeichnis oder Pfad. Wenn Sie beispielsweise dieses NFS mit einem Verzeichnis namensmy-nfs
darstellen möchten, legen Sie den Bereitstellungspfad auf/mnt/disks/my-nfs
fest.
Nächste Schritte
- Informationen zu Problemen beim Erstellen oder Ausführen eines Jobs finden Sie unter Fehlerbehebung.
- Aufträge und Aufgaben ansehen
- Möglichkeiten zur Joberstellung