Job mit benutzerdefinierten Bootlaufwerken erstellen und ausführen

Auf dieser Seite wird beschrieben, wie Sie die nichtflüchtigen Laufwerke anpassen, die zum Starten jeder VM-Instanz (virtuelle Maschine) verwendet werden, auf der ein Job ausgeführt wird.

Insbesondere können Sie die Größe, den Typ und/oder das VM-Betriebssystem-Image für ein Bootlaufwerk anpassen. Wenn Sie nur das VM-Betriebssystem-Image anpassen möchten, lesen Sie stattdessen den Hilfeartikel VM-Betriebssystem-Image für einen Job angeben.

Weitere Informationen zu Bootlaufwerken und zu den Zeitpunkten, zu denen sie konfiguriert werden sollten, finden Sie unter VM-Betriebssystemumgebung – Übersicht.

Hinweise

  1. Wenn Sie Batch noch nicht verwendet haben, lesen Sie den Hilfeartikel Batch-Dateien erstellen und ausführen und aktivieren Sie Batch, indem Sie die Voraussetzungen für Projekte und Nutzer erfüllen.

  2. Bitten Sie Ihren Administrator, Ihnen die folgenden IAM-Rollen zuzuweisen, um die Berechtigungen zu erhalten, die Sie zum Erstellen eines Jobs benötigen:

    Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.

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

Job mit benutzerdefiniertem Bootlaufwerk erstellen und ausführen

Sie können beim Erstellen eines Jobs ein benutzerdefiniertes Bootlaufwerk angeben. Wählen Sie dazu eine der folgenden Methoden aus:

  • Verwenden Sie eine Compute Engine-Instanzvorlage, die einen vorhandenen benutzerdefinierten Boot-Datenträger angibt. Wenn Sie beim Erstellen dieses Jobs eine VM-Instanzvorlage oder ein vorhandenes benutzerdefiniertes Bootlaufwerk verwenden möchten, führen Sie die folgenden Schritte aus:

    1. Erstellen oder identifizieren Sie ein benutzerdefiniertes Bootlaufwerk.

      Informationen zu den Anforderungen an das Bootlaufwerk für Batch finden Sie in diesem Dokument und unter VM-Betriebssystemumgebung – Übersicht. Eine Anleitung zum Erstellen eines Bootlaufwerks finden Sie in der Compute Engine-Dokumentation unter Angepasstes Bootlaufwerk erstellen.

    2. Erstellen oder identifizieren Sie eine VM-Instanzvorlage, die dieses benutzerdefinierte Bootlaufwerk enthält.

      Eine Anleitung zum Erstellen einer VM-Instanzvorlage finden Sie in der Compute Engine-Dokumentation unter Instanzvorlagen erstellen.

    3. Erstellen und ausführen Sie einen Job, der diese VM-Instanzvorlage enthält.

      Eine Anleitung zum Erstellen und Ausführen des Jobs finden Sie unter Jobressourcen mit einer VM-Instanzvorlage definieren.

  • Verwenden Sie das Feld „Bootlaufwerk“, um ein neues benutzerdefiniertes Bootlaufwerk anzugeben. Wie in der folgenden Anleitung erläutert, können Sie ein neues benutzerdefiniertes Bootlaufwerk mithilfe des Felds Bootlaufwerk (bootDisk) definieren, wenn Sie einen Job mit der gcloud CLI oder der Batch API erstellen und ausführen.

    Sie können das Bootlaufwerk insbesondere anpassen, indem Sie die Unterfelder VM-Betriebssystem-Image (image), nichtflüchtiger Speichertyp (type) und/oder Größe (sizeGb) konfigurieren. Batch legt einen Standardwert für alle diese untergeordneten Felder fest, die Sie weglassen.

gcloud

  1. Erstellen Sie eine JSON-Datei mit den Konfigurationsdetails des Jobs. Wenn Sie ein neues benutzerdefiniertes Bootlaufwerk für die VMs des Jobs angeben möchten, fügen Sie das Feld bootDisk und die untergeordneten Felder hinzu.

    Wenn Sie beispielsweise einen einfachen Script-Job erstellen möchten, der einen neuen benutzerdefinierten Boot-Datenträger verwendet, erstellen Sie eine JSON-Datei mit folgendem Inhalt:

    {
    "taskGroups": [
        {
            "taskSpec": {
                "runnables": [
                    {
                        "script": {
                            "text": "echo Hello world from task ${BATCH_TASK_INDEX}."
                        }
                    }
                ]
            },
            "taskCount": 3,
            "parallelism": 1
        }
    ],
    "allocationPolicy": {
      "instances": [
        {
          "policy": {
            "bootDisk": {
              "image": "VM_OS_IMAGE_URI",
              "type": "BOOT_DISK_TYPE",
              "sizeGb": BOOT_DISK_SIZE
            }
          }
        }
      ]
    },
    "logsPolicy": {
    "destination": "CLOUD_LOGGING"
  }
}

    Ersetzen Sie Folgendes:

    • VM_OS_IMAGE_URI: ein relativer Ressourcenname des VM-Betriebssystem-Images. Verwenden Sie eine der folgenden Optionen:

      • Geben Sie ein Batch-Betriebssystempräfix an. Wenn Sie das neueste Image eines bestimmten Batch-Betriebssystems verwenden möchten, verwenden Sie das folgende Format:

        BATCH_OS_PREFIX

        Ersetzen Sie BATCH_OS_PREFIX durch eines der Präfixe für Batch-VM-Betriebssystem-Images. batch-debian ist beispielsweise das Präfix für das Batch-Debian-Betriebssystem.

      • Geben Sie eine Image-Familie an. Wenn Sie das neueste Image aus einer bestimmten Image-Familie verwenden möchten, verwenden Sie das folgende Format:

        projects/IMAGE_PROJECT_ID/global/images/family/IMAGE_FAMILY

        Ersetzen Sie Folgendes:

        • IMAGE_PROJECT_ID: die Projekt-ID des Projekts, das das Image enthält. Geben Sie beispielsweise für alle Batch-Bilder batch-custom-image an.
        • IMAGE_FAMILY: die Image-Familie, die ein oder mehrere bestimmte Images enthält und den Typ und die Hauptversion des Betriebssystems darstellt. Wenn Sie beispielsweise alle VM-Betriebssystem-Image-Familien aus Batch aufrufen möchten, rufen Sie eine Liste der VM-Betriebssystem-Images auf.

      • Geben Sie eine Image-Version an. Wenn Sie eine bestimmte Version eines VM-Betriebssystem-Images verwenden möchten, verwenden Sie das folgende Format:

        projects/IMAGE_PROJECT_ID/global/images/IMAGE_NAME

        Ersetzen Sie Folgendes:

        • IMAGE_PROJECT_ID: die Projekt-ID des Projekts, das das Image enthält. Geben Sie beispielsweise für alle Batch-Bilder batch-custom-image an.
        • IMAGE_NAME: Der Image-Name, der eine bestimmte Version eines VM-Betriebssystem-Images darstellt. Wenn Sie beispielsweise alle Versionen von VM-Betriebssystem-Images aus Batch sehen möchten, rufen Sie eine Liste der VM-Betriebssystem-Images auf.

    • BOOT_DISK_TYPE: Der Laufwerktyp des Bootlaufwerks: pd-standard, pd-balanced, pd-ssd oder pd-extreme. Der Standardlaufwerkstyp für Bootlaufwerke ist pd-balanced.

    • BOOT_DISK_SIZE: die Größe des neuen nichtflüchtigen Bootlaufwerks in GB. Dieser Wert muss allen Anforderungen an die Größe des Bootlaufwerks entsprechen.

  2. Führen Sie den folgenden gcloud batch jobs submit-Befehl aus, um den Job zu erstellen:

    gcloud batch jobs submit JOB_NAME \
    --location LOCATION \
    --config JSON_CONFIGURATION_FILE

    Ersetzen Sie Folgendes:

    • JOB_NAME: Der Name für diesen Job.
    • LOCATION: den Speicherort für diese Aufgabe.
    • JSON_CONFIGURATION_FILE: der Pfad zur JSON-Datei mit den Konfigurationsdetails des Jobs.

API

Wenn Sie einen Job mit der Batch API erstellen möchten, verwenden Sie die Methode jobs.create und geben Sie die Konfigurationsdetails des Jobs an. Wenn Sie das VM-Betriebssystem-Image für den Job angeben möchten, fügen Sie das Feld bootDisk und die untergeordneten Felder hinzu. Wenn Sie beispielsweise einen einfachen Script-Job mit einem neuen benutzerdefinierten Bootlaufwerk erstellen möchten, stellen Sie die folgende POST-Anfrage:

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}."
                        }
                    }
                ]
            },
            "taskCount": 3,
            "parallelism": 1
        }
    ],
    "allocationPolicy": {
      "instances": [
        {
          "policy": {
            "bootDisk": {
              "image": "VM_OS_IMAGE_URI",
              "type": "BOOT_DISK_TYPE",
              "sizeGb": BOOT_DISK_SIZE
            }
          }
        }
      ]
    },
    "logsPolicy": {
    "destination": "CLOUD_LOGGING"
  }
}

Ersetzen Sie Folgendes:

  • VM_OS_IMAGE_URI: ein relativer Ressourcenname des VM-Betriebssystem-Images. Verwenden Sie eine der folgenden Optionen:

    • Geben Sie ein Batch-Betriebssystempräfix an. Wenn Sie das neueste Image eines bestimmten Batch-Betriebssystems verwenden möchten, verwenden Sie das folgende Format:

      BATCH_OS_PREFIX

      Ersetzen Sie BATCH_OS_PREFIX durch eines der Präfixe für Batch-VM-Betriebssystem-Images. batch-debian ist beispielsweise das Präfix für das Batch-Debian-Betriebssystem.

    • Geben Sie eine Image-Familie an. Wenn Sie das neueste Image aus einer bestimmten Image-Familie verwenden möchten, verwenden Sie das folgende Format:

      projects/IMAGE_PROJECT_ID/global/images/family/IMAGE_FAMILY

      Ersetzen Sie Folgendes:

      • IMAGE_PROJECT_ID: die Projekt-ID des Projekts, das das Image enthält. Geben Sie beispielsweise für alle Batch-Bilder batch-custom-image an.
      • IMAGE_FAMILY: die Image-Familie, die ein oder mehrere bestimmte Images enthält und den Typ und die Hauptversion des Betriebssystems darstellt. Wenn Sie beispielsweise alle VM-Betriebssystem-Image-Familien aus Batch aufrufen möchten, rufen Sie eine Liste der VM-Betriebssystem-Images auf.

    • Geben Sie eine Image-Version an. Wenn Sie eine bestimmte Version eines VM-Betriebssystem-Images verwenden möchten, verwenden Sie das folgende Format:

      projects/IMAGE_PROJECT_ID/global/images/IMAGE_NAME

      Ersetzen Sie Folgendes:

      • IMAGE_PROJECT_ID: die Projekt-ID des Projekts, das das Image enthält. Geben Sie beispielsweise für alle Batch-Bilder batch-custom-image an.
      • IMAGE_NAME: Der Image-Name, der eine bestimmte Version eines VM-Betriebssystem-Images darstellt. Wenn Sie beispielsweise alle Versionen von VM-Betriebssystem-Images aus Batch sehen möchten, rufen Sie eine Liste der VM-Betriebssystem-Images auf.

  • BOOT_DISK_TYPE: Der Laufwerktyp des Bootlaufwerks: pd-standard, pd-balanced, pd-ssd oder pd-extreme. Der Standardlaufwerkstyp für Bootlaufwerke ist pd-balanced.

  • BOOT_DISK_SIZE: die Größe des neuen nichtflüchtigen Bootlaufwerks in GB. Dieser Wert muss allen Anforderungen an die Größe des Bootlaufwerks entsprechen.

Nächste Schritte