Oracle Cloud Infrastructure - Dokumentation

Joblauf starten

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

Die Joberstellung legt die Infrastruktur und das eigentliche Anwendungsfallartefakt fest, aber der Joblauf führt den Job tatsächlich mit den angegebenen Parametern aus. Jobläufe stellen die angegebene Infrastruktur bereit, führen das Jobartefakt aus und heben das Provisioning der verwendeten Ressourcen auf und zerstören sie, wenn der Joblauf beendet ist.

    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 den Job aus.
    4. (Optional) Geben Sie einen eindeutigen Namen für den Joblauf ein (maximal 255 Zeichen). Wenn Sie keinen Namen angeben, wird automatisch ein Name generiert.

      Beispiel: jobrun20210808222435.

    5. (Optional) Um Logging zu verwenden, wählen Sie Auswählen aus, und stellen Sie sicher, dass Logging aktivieren ausgewählt ist.
      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.

      3. Wählen Sie Auswählen aus, um zur Erstellungsseite für den Joblauf zurückzukehren.
    6. (Optional) Überschreiben Sie die Konfiguration "Eigenen Container verwenden", die beim Erstellen des Jobs definiert wurde, mit den 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.
    7. (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.

    8. (Optional) Wählen Sie Erweiterte Optionen anzeigen aus, um dem Joblauf Tags hinzuzufügen.
    9. (Optional) Fügen Sie im Abschnitt Tags dem <resourceType> mindestens ein Tag hinzu. Wenn Sie über Berechtigungen zum Erstellen einer Ressource verfügen, sind Sie auch berechtigt, Freiformtags auf diese Ressource anzuwenden. Um ein definiertes Tag anzuwenden, müssen Sie über die Berechtigungen verfügen, den Tag-Namespace zu verwenden. Weitere Informationen zu Tagging finden Sie unter Ressourcentags. Wenn Sie nicht sicher sind, ob Sie Tags anwenden sollen, überspringen Sie diese Option, oder fragen Sie einen Administrator. Sie können Tags später anwenden.
    10. 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.