Vorbereitende Schritte

• Verstehen Sie die Konzepte von Batch-Job-Workloads innerhalb von Code Engine. Weitere Informationen zu Batch-Aufträgen finden Sie unter Arbeitsbelastung durch Batch-Aufträge.
• Planen und wählen Sie Ihren Ansatz für die Ausführung Ihres Codes als Code Engine-Jobkomponente aus. Weitere Informationen über die zu erstellenden Typen von Code Engine Workloads finden Sie unter Planung für Code Engine.
• Sie können mit Aufträgen und Auftragsläufen auf zwei Arten arbeiten:
  • Wenn Sie die „ Code Engine “-Konsole nutzen möchten, rufen Sie die Seite Code Engine Übersicht auf.
  • Wenn Sie die Befehlszeilenschnittstelle verwenden möchten, richten Sie die Umgebung der Code Engine-Befehlszeilenschnittstelle ein.

Code Engine stellt CRD-Methoden (CRD = Custom Resource Definition) bereit. Weitere Informationen finden Sie in den Batch-CRD-Methoden.

Wie kann ich meinen Code als Code Engine-Jobkomponente ausführen?

Unabhängig davon, ob Ihr Code als Quellcode in einer lokalen Datei oder in einem „ Git “-Repository vorliegt oder ob es sich um ein Container-Image handelt, das in einer öffentlichen oder privaten Registry gespeichert ist: „ Code Engine “ bietet Ihnen eine optimierte Möglichkeit, Ihren Code als Job auszuführen.

• Wenn Sie über ein Container-Image gemäß dem Standard der Open Container Initiative(OCI) verfügen, müssen Sie beim Erstellen Ihres Jobs lediglich einen Verweis auf das Image angeben, der auf den Speicherort Ihrer Container-Registry verweist. Sie können Ihren Job auf der Grundlage von Images aus einem öffentlichen oder privaten Registry erstellen und anschließend während der Ausführung Ihres Jobs auf das referenzierte Image zugreifen.

• Wenn Sie mit Quellcode arbeiten, der sich in einem Repository unter Git befindet, können Sie den Speicherort Ihres Quellcodes angeben. Code Engine übernimmt dann in einem einzigen Schritt die Erstellung des Images aus Ihrem Quellcode und die Einrichtung des Jobs. In diesem Szenario lädt Code Engine Ihr Image in IBM Cloud® Container Registry hoch. Weitere Informationen finden Sie unter Job aus Repository-Quellcode erstellen. Wenn Sie mehr Kontrolle über den Build Ihres Image möchten, können Sie das Image mit Code Engine erstellen, bevor Sie den Job generieren und ausführen.

• Wenn Sie mit Quellcode auf einem lokalen Rechner beginnen, können Sie den Speicherort Ihres Quellcodes angeben, und Code Engine übernimmt dann mit einem einzigen CLI-Befehl die Erstellung des Images aus Ihrem Quellcode sowie die Erstellung des Jobs. In diesem Szenario lädt Code Engine Ihr Image in IBM Cloud® Container Registry hoch. Weitere Informationen finden Sie unter Job aus lokalem Quellcode über die Befehlszeilenschnittstelle erstellen. Wenn Sie mehr Kontrolle über den Build Ihres Image möchten, können Sie das Image mit Code Engine erstellen, bevor Sie den Job generieren und ausführen.

Nachdem Sie Ihren Job erstellt und ausgeführt haben, können Sie Ihren Job auch aktualisieren, indem Sie irgendeine der oben genannten Methoden ausführen, unabhängig davon, wie Sie Ihren Job erstellt oder zuvor aktualisiert haben.

Wenn Sie mit Aufträgen arbeiten, sollten Sie die folgenden wichtigen Punkte beachten.

• Im Gegensatz zu Anwendungsimages verfügen die Job-Images nicht über einen HTTP-Server.
• Das ausführbare Programm im Image muss mit dem Statuswert Null beendet werden, damit es als erfolgreich gilt.
• Das Image kann von einer öffentlichen oder privaten Image-Registry heruntergeladen werden. Weitere Informationen finden Sie unter Auf Container-Registrys zugreifen.

Wenn Sie Ihren Job ausführen, wird die neueste Version Ihres referenzierten Container-Image für die Jobausführung verwendet, sofern für das Image kein Tag angegeben ist. Wenn ein Tag für das Image angegeben wird, wird das mit Tags versehene Image für die Jobausführung verwendet.

Hinweise zur HTTP-Handhabung

Wenn Sie mit Jobs (oder Apps) arbeiten, ist es hilfreich, die grundlegende HTTP-Handhabung in Code Engine zu kennen. Siehe Hinweise zur HTTP-Handhabung

Optionen für Erstellung und Ausführung von Jobs

Hier finden Sie Informationen zu den Optionen, die Sie beim Erstellen oder Ausführen Ihres Jobs angeben können. Je nachdem, ob Sie die Konsole oder die Befehlszeilenschnittstelle verwenden, sind möglicherweise andere Optionen verfügbar.

Was ist, wenn mein Job unbegrenzt ausgeführt werden soll?

Normalerweise sind Jobs so konzipiert, dass sie einmal ausgeführt und mit einer maximalen Ausführungszeit beendet werden.

Angenommen, Sie möchten einen Datenspeicher eines anderen Anbieters ständig abfragen. Sie können eine Anwendung erstellen. Der App-Port muss jedoch offen bleiben, um HTTP-Anforderungen zu verarbeiten. Wenn Sie HTTP-Anforderungen nicht verarbeiten wollen, können Sie stattdessen einen Job erstellen, der ohne maximale Ausführungszeit und ohne Zeitlimitüberschreitung ausgeführt wird.

Mit Code Enginekönnen Sie die mode Ihres Jobs auswählen. Verwenden Sie für Jobs, für die eine maximale Ausführungszeit gilt, den Modus task für Ihre Jobs. Fehlgeschlagene Instanzen werden gemäß dem Grenzwert für Jobwiederholungen erneut gestartet. Dieser Modus ist das Standardverhalten für Jobs.

Wenn Sie einen Job erstellen möchten, der unbegrenzt ausgeführt werden kann und kein Zeitlimit hat, verwenden Sie den Modus daemon für Ihre Jobs. Fehlgeschlagene Instanzen werden automatisch unbegrenzt erneut gestartet.

Bei „ Code Engine “ zahlen Sie nur für die Ressourcen, die Sie tatsächlich nutzen. Wenn Ihr Job im Modus daemon ausgeführt wird, beachten Sie, dass der Job immer ausgeführt wird, bis Sie den Job löschen.

Weitere Informationen finden Sie unter Einen Job erstellen und ausführen, der unbegrenzt ausgeführt wird.

Hinweise zu Jobkontingenten

Wenn Sie mit Anwendungen, Funktionen und Stapeljobs arbeiten, werden diese Ressourcen im Kontext eines Code Engine-Projekts ausgeführt. Ressourcenkontingente werden pro Projekt definiert und Grenzwerte gelten für Anwendungen, Funktionen und Stapeljobs.

Weitere Informationen zu Code Engine-Grenzwerte finden Sie unter Grenzwerte und Kontingente für Code Engine.

Aufräumen nach abgeschlossenen Arbeitsgängen

Aufträge, die abgeschlossen sind, werden nach einer Woche automatisch gelöscht.

Nächste Schritte

Sind Sie nun mit den Schlüsselkonzepten für die Arbeit mit Code Engine-Jobs vertraut und bereit zum Erstellen und Ausführen von Jobs? Siehe

• Erstellen eines Jobs aus Images in einer öffentlichen Registry.
• Job aus Images in IBM Cloud Container Registry.
• Job aus Images in einer privaten Registry erstellen
• Job aus Repository-Quellcode erstellen.
• Erstellen eines Jobs aus lokalem Quellcode über die Befehlszeilenschnittstelle(CLI).
• Job ausführen.

Weitere Informationen zur Arbeit mit Aufträgen finden Sie unter

• IBM Cloud-Services mit Servicebindungen integrieren
• Arbeiten mit Umgebungsvariablen, configmaps und geheimen Schlüsseln.
• Ereigniserzeuger abonnieren.
• Fehlerbehebung für Jobs.