Oracle Cloud Infrastructure - Dokumentation

Joblauf starten

Mit Data Science-Jobläufen können Sie verschiedene Anwendungsfälle auf erstellte Jobs anwenden.

Bei der Joberstellung werden die Infrastruktur und das eigentliche Anwendungsfallartefakt festlegt, führt der Joblauf den Job jedoch mit den angegebenen Parametern durch. Jobläufe stellen die angegebene Infrastruktur bereitstellen, das Jobartefakt ausführen und dann das Provisioning der verwendeten Ressourcen aufheben und zerstören, wenn der Joblauf beendet ist.

  • Einzelknoten-Jobläufe mit der Konsole starten

    Einzelknoten-Jobläufe mit der Konsole starten

    1. Wählen Sie auf der Seite mit der Jobliste den Namen des Jobs aus, mit dem Sie arbeiten möchten. Wenn Sie Hilfe bei der Suche nach der Jobliste benötigen, finden Sie weitere Informationen unter Jobs auflisten.
    2. Wählen Sie Joblauf starten aus.
    3. (Optional) Wählen Sie ein anderes Compartment für die Jobausführung aus.
    4. (Optional) Geben Sie einen Namen für den Joblauf (maximal 255 Zeichen) ein. Wenn Sie keinen Namen angeben, wird automatisch ein Name generiert.

      Beispiel: jobrun20210808222435.

    5. (Optional) Überschreiben Sie die Standardjobkonfiguration, die beim Erstellen des Jobs definiert wurde, mit den folgenden Optionen:
      Geben Sie einen der folgenden Werte ein, oder wählen Sie sie aus:
      Benutzerdefinierter Umgebungsvariablenschlüssel

      Die Umgebungsvariablen, die den Job steuern.

      Wert

      Der Wert für den Variablenschlüssel der benutzerdefinierten Umgebung.

      Sie können Zusätzlicher benutzerdefinierter Umgebungsschlüssel auswählen, um weitere Variablen anzugeben.

      Befehlszeilenargumente

      Die Befehlszeilenargumente, die Sie zum Ausführen des Jobs verwenden möchten.

      Maximale Laufzeit (in Minuten)

      Gibt in Minuten an, wie lange der Job maximal ausgeführt werden darf. Der Service bricht den Joblauf ab, wenn die Laufzeit den angegebenen Wert überschreitet. Die maximale Laufzeit beträgt 30 Tage (43.200 Minuten). Es wird empfohlen, eine maximale Laufzeit für alle Jobläufe zu konfigurieren, um langfristige Arbeitsspeicherbelegung durch Jobläufe zu verhindern.

    6. (Optional) Geben Sie einen Wert für die maximale Laufzeit-Override (in Minuten) ein.
    7. Setzen Sie die Netzwerkressourcenkonfiguration außer Kraft, die beim Erstellen des Jobs definiert wurde.
      Der Netzwerktyp kann nicht geändert werden.
      • Wenn Standardnetzwerk konfiguriert ist, kann nichts außer Kraft gesetzt werden.
      • Wenn Benutzerdefiniertes Networking konfiguriert ist, können Sie das ausgewählte VCN und Subnetz ändern.
    8. (Optional) Ändern Sie die Compute-Ausprägung, indem Sie Ausprägung ändern auswählen. Führen Sie dann die folgenden Schritte im Bereich Compute auswählen aus.
      1. Wählen Sie einen Instanztyp aus.
      2. Wählen Sie eine Ausprägungsreihe aus.
      3. Wählen Sie eine der unterstützten Compute-Ausprägungen in der Reihe aus.
      4. Wählen Sie die Ausprägung aus, die am besten zur gewünschten Verwendung der Ressource passt.

        Wählen Sie für jede OCPU bis zu 64 GB Arbeitsspeicher und maximal 512 GB Arbeitsspeicher. Der zulässige Mindestarbeitsspeicher ist entweder 1 GB oder ein Wert, der mit der Anzahl der OCPUs übereinstimmt, je nachdem, welcher Wert größer ist.

      5. Wenn Sie burstfähige VMs verwenden, schalten Sie Burstable um.
        Wählen Sie unter Baselineauslastung pro OCPU den Prozentsatz der OCPUs aus, den Sie normalerweise verwenden möchten. Die unterstützten Werte lauten 12,5% und 50%.
      6. Wählen Sie Ausprägung auswählen aus.
    9. (Optional) Überschreiben Sie die Speicherkonfiguration.
      Geben Sie die Blockspeichermenge ein, die zwischen 50 GB und 10, 240 GB (10 TB) verwendet werden soll. Sie können den Wert in 1-GB-Inkrementen ändern.
    10. Überschreiben Sie die Umgebungskonfiguration, die beim Erstellen des Jobs definiert wurde, mit folgenden Optionen:
      1. Wählen Sie unter Umgebungskonfiguration die Option Auswählen aus. Der Bereich BYOC-Umgebung festlegen wird angezeigt.
      2. Wählen Sie unter Repository ein Repository aus der Liste. Wenn sich das Repository in einem anderen Compartment befindet, wählen Sie Compartment ändern aus.
      3. Wählen Sie unter Image ein Image aus der Liste.
      4. (Optional) Geben Sie unter Entrypoint einen Einstiegspunkt ein. Um einen weiteren hinzuzufügen, wählen Sie Parameter +Add aus.
      5. (Optional) Geben Sie in CMD eine CMD ein. Um einen weiteren hinzuzufügen, wählen Sie Parameter +Add aus.
        Hinweis

        Verwenden Sie CMD als Argumente für ENTRYPOINT oder den einzigen Befehl, der ohne ENTRYPOINT ausgeführt wird.
      6. (Optional) Geben Sie unter Imagedigest einen Imagedigest ein.
      7. (Optional) Geben Sie unter Signatur-ID bei Verwendung der Signaturverifizierung die OCID der Imagesignatur ein. Beispiel: ocid1.containerimagesignature.oc1.iad.aaaaaaaaab....
      8. Wählen Sie Auswählen aus.
    11. (Optional) Überschreiben Sie die Loggingkonfiguration.
      1. Wählen Sie eine Loggruppe in der Liste aus. Sie können zu einem anderen Compartment wechseln, um eine Loggruppe in einem anderen Compartment als dem des Jobs anzugeben.
      2. Wählen Sie eine der folgenden Optionen aus, um alle stdout- und stderr-Meldungen zu speichern:
        Automatische Logerstellung aktivieren

        Data Science erstellt automatisch ein Log, wenn der Job gestartet wird.

        Log auswählen

        Wählen Sie das gewünschte Log aus.

    12. (Optional) Überschreiben Sie die Startprobe.
      1. Geben Sie einen Befehl ein.
      2. (Optional) Um einen weiteren Befehl hinzuzufügen, wählen Sie den Befehl +Add aus, und wiederholen Sie Schritt a.
      3. (Optional) Geben Sie einen Wert für die anfängliche Verzögerung ein (in Sekunden).
      4. (Optional) Geben Sie einen Periodenwert ein.
      5. (Optional) Geben Sie einen Wert für den Fehlerschwellenwert ein.
      6. Wählen Sie Speichern aus.
    13. (Optional) Wählen Sie Erweiterte Optionen anzeigen aus, um dem Joblauf Tags hinzuzufügen.
    14. (Optional) Fügen Sie im Abschnitt Tags dem Joblauf ein oder mehrere Tags hinzu. Wenn Sie über Berechtigungen zum Erstellen eines Joblaufs verfügen, sind Sie auch berechtigt, Freiformtags auf diesen Joblauf anzuwenden. Um ein definiertes Tag anzuwenden, benötigen Sie Die Berechtigungen zum Verwenden des Tag-Namespace. Weitere Informationen zu Tagging finden Sie unter Ressourcentags. Wenn Sie nicht sicher sind, ob Tags angewendet werden sollen, überspringen Sie diese Option, oder fragen Sie einen Administrator. Sie können Tags später anwenden.
    15. Wählen Sie Start.
    Jobausführungen mit mehreren Knoten mit der Konsole starten

    Jobausführungen mit mehreren Knoten mit der Konsole starten

    1. Wählen Sie auf der Seite "Jobliste" den Namen des Jobs aus, mit dem Sie arbeiten möchten. Wenn Sie Hilfe beim Suchen der Jobliste benötigen, lesen Sie Jobs auflisten.
    2. Wählen Sie Joblauf starten aus.
    3. (Optional) Wählen Sie ein anderes Compartment für die Jobausführung aus.
    4. (Optional) Geben Sie einen Namen für den Joblauf (maximal 255 Zeichen) ein. Wenn Sie keinen Namen angeben, wird automatisch ein Name generiert.

      Beispiel: jobrun20210808222435.

    5. (Optional) Geben Sie einen Wert für die maximale Laufzeit-Override (in Minuten) ein.
    6. Setzen Sie die Netzwerkressourcenkonfiguration außer Kraft, die beim Erstellen des Jobs definiert wurde.
      Der Netzwerktyp kann nicht geändert werden.
      • Wenn Standardnetzwerk konfiguriert ist, kann nichts außer Kraft gesetzt werden.
      • Wenn Benutzerdefiniertes Networking konfiguriert ist, können Sie das ausgewählte VCN und Subnetz ändern.
    7. (Optional) Überschreiben Sie die Knotengruppenkonfiguration, die beim Erstellen des Jobs definiert wurde.

      Die Konfigurationen jeder Knotengruppe können einzeln außer Kraft gesetzt werden, indem Sie auf das Menü Aktionen (drei Punkte) für die Knotengruppe klicken und Bearbeiten auswählen.

      1. (Optional) Überschreiben Sie die Anzahl der Replikate.
      2. (Optional) Überschreiben Sie die Mindestanzahl an Replikaten, die erfolgreich sein müssen.
      3. (Optional) Überschreiben Sie den Speicher. Geben Sie die Blockspeichermenge ein, die zwischen 50 GB und 10, 240 GB (10 TB) verwendet werden soll. Sie können den Wert in 1-GB-Inkrementen ändern.

      4. (Optional) Überschreiben Sie die Standardjobkonfiguration mit den folgenden Optionen:

        Geben Sie einen der folgenden Werte ein, oder wählen Sie einen der folgenden Werte:
        Benutzerdefinierter Umgebungsvariablenschlüssel

        Die Umgebungsvariablen, die den Job steuern.

        Wert

        Der Wert für den benutzerdefinierten Umgebungsvariablenschlüssel.

        Sie können Zusätzlicher benutzerdefinierter Umgebungsschlüssel auswählen, um weitere Variablen anzugeben.

        Befehlszeilenargumente

        Die Befehlszeilenargumente, die Sie zum Ausführen des Jobs verwenden möchten.

      5. Ändern Sie die Compute-Ausprägung, indem Sie Ausprägung ändern auswählen. Führen Sie dann die folgenden Schritte im Bereich Compute auswählen aus.
        1. Wählen Sie einen Instanztyp aus.
        2. Wählen Sie eine Ausprägungsreihe aus.
        3. Wählen Sie eine der unterstützten Compute-Ausprägungen in der Reihe aus.
        4. Wählen Sie die Ausprägung aus, die am besten zur gewünschten Verwendung der Ressource passt.

          Wählen Sie für jede OCPU bis zu 64 GB Arbeitsspeicher und maximal 512 GB Arbeitsspeicher. Der zulässige Mindestarbeitsspeicher ist entweder 1 GB oder ein Wert, der mit der Anzahl der OCPUs übereinstimmt, je nachdem, welcher Wert größer ist.

        5. Wenn Sie burstfähige VMs verwenden, schalten Sie Burstable um.
          Wählen Sie unter Baselineauslastung pro OCPU den Prozentsatz der OCPUs aus, den Sie normalerweise verwenden möchten. Die unterstützten Werte lauten 12,5% und 50%.
        6. Wählen Sie Ausprägung auswählen aus.
      6. (Optional) Überschreiben Sie die Probes-Konfiguration:
        1. Geben Sie einen Befehl ein.
        2. (Optional) Um einen weiteren Befehl hinzuzufügen, wählen Sie den Befehl +Add aus, und wiederholen Sie Schritt a.
        3. (Optional) Geben Sie einen Wert für die anfängliche Verzögerung ein (in Sekunden).
        4. (Optional) Geben Sie einen Periodenwert ein.
        5. (Optional) Geben Sie einen Wert für den Fehlerschwellenwert ein.
        6. Wählen Sie Speichern aus.
    8. (Optional) Überschreiben Sie die Loggingkonfiguration.
      1. Wählen Sie eine Loggruppe in der Liste aus. Sie können zu einem anderen Compartment wechseln, um eine Loggruppe in einem anderen Compartment als dem des Jobs anzugeben.
      2. Wählen Sie eine der folgenden Optionen aus, um alle stdout- und stderr-Nachrichten zu speichern:
        Automatische Logerstellung aktivieren

        Data Science erstellt automatisch ein Log, wenn der Job startet.

        Log auswählen

        Wählen Sie das gewünschte Log aus.

    9. (Optional) Wählen Sie Erweiterte Optionen anzeigen aus, um Tags zum Joblauf hinzuzufügen.
    10. (Optional) Fügen Sie im Abschnitt Tags dem Joblauf ein oder mehrere Tags hinzu. Wenn Sie über Berechtigungen zum Erstellen eines Joblaufs verfügen, sind Sie auch berechtigt, Freiformtags auf diesen Joblauf anzuwenden. Um ein definiertes Tag anzuwenden, benötigen Sie Die Berechtigungen zum Verwenden des Tag-Namespace. Weitere Informationen zu Tagging finden Sie unter Ressourcentags. Wenn Sie nicht sicher sind, ob Tags angewendet werden sollen, überspringen Sie diese Option, oder fragen Sie einen Administrator. Sie können Tags später anwenden.
    11. Wählen Sie Start.

  • Diese Umgebungsvariablen steuern den Job.

    Mit der Data Science-CLI können Sie Jobläufe wie in diesem Beispiel starten:

    1. Starten Sie einen Joblauf mit: 
      oci data-science job-run create \
--display-name <job_run_name> \
--compartment-id <compartment_ocid> \
--project-id <project_ocid> \
--job-id <job_ocid> \
--configuration-override-details file://<optional_job_run_configuration_override_json_file> \
--log-configuration-override-details file://<optional_job_run_logging_configuration_override_json_file>
    2. (Optional) Verwenden Sie diese JSON-Datei zum Override von Joblaufkonfigurationen, um die für den übergeordneten Job definierten Konfigurationen außer Kraft zu setzen: 
      jobEnvironmentConfigurationDetails: {
  jobEnvironmentType: "OCIR_CONTAINER",
    image: "iad.ocir.io/axoxdievda5j/odsc-byod-hello-wrld:0.1.3",
    imageDigest: "sha256",
  cmd: ["ls", "-h"],
  entrypoint: ["-l"],
    imageSignatureId: "ocid1.containerimagesignature.oc1.iad.0.ociodscdev.aaaaaaaaccutw5qdz6twjzkpgmbojdck3qotqqsbn7ph6xcumu4s32o6v5gq",
},
    jobConfigurationDetails: {
        jobType: "DEFAULT",
        environmentVariables: <envar-list-object>},
    ...
}
    3. (Optional) Verwenden Sie diese JSON-Datei zum Override von Joblauf-Loggingkonfigurationen, um die für den übergeordneten Job definierte Loggingkonfiguration außer Kraft zu setzen: 
      {
  "enableLogging": true,
  "enableAutoLogCreation": true,
  "logGroupId": "<log_group_ocid>"
}

  • Das ADS-SDK ist auch eine öffentlich verfügbare Python-Library, die Sie mit diesem Befehl installieren können:

    pip install oracle-ads

    Es stellt den Wrapper bereit, der das Starten von Jobläufen aus Notizbüchern oder auf Ihrem Clientrechner vereinfacht.

    Verwenden Sie das ADS-SDK, um Jobläufe zu starten.