Buildkonfiguration ausführen

Nach der Erstellung einer Buildkonfiguration können Sie basierend auf dieser Buildkonfiguration eine Ausführung übergeben. Führen Sie das Build über die Konsole oder über die CLI aus.

Code Engine verfügt über Kontingente für Builds und Buildausführungen innerhalb eines Projekts. Weitere Informationen zu Code Engine-Grenzwerte finden Sie unter Grenzwerte und Kontingente für Code Engine.

Build-Läufe, die abgeschlossen sind, werden automatisch gelöscht. Wenn Ihr Build-Lauf auf einer Build-Konfiguration basiert, wird dieser Build-Lauf nach drei Stunden gelöscht, wenn der Build-Lauf erfolgreich war. Wenn der Build-Lauf nicht erfolgreich ist, wird dieser Build-Lauf nach einer Woche gelöscht.

Build in der Konsole ausführen

Rufen Sie das Code Engine-Dashboard auf.
Wählen Sie das Projekt aus, in dem Sie den Build erstellt haben.
Klicken Sie auf der Projektseite auf Image-Builds.
Wählen Sie auf der Registerkarte Image-Build den Namen des Image-Builds aus, mit dem Sie arbeiten wollen.
Im Abschnitt "Konfiguration" können Sie die Build-Konfiguration überprüfen und bei Bedarf Werte ändern.
Überprüfen Sie alle weiteren Informationen, wie z. B. das Ausgabeimage für diese Buildausführung, oder überschreiben Sie den Wert Zeitlimit.
Übergeben Sie die Buildausführung durch Klicken auf Build übergeben.

Überwachen Sie den Buildfortschritt im Abschnitt Buildausführungen.

Build für Quelle aus einem Repository (nicht lokal) über die Befehlszeilenschnittstelle ausführen

Mit dem Befehl buildrun submit können Sie in der Befehlszeilenschnittstelle eine Buildausführung übergeben, die auf einer Buildkonfiguration basiert. Dieser Befehl erfordert den Namen einer Build-Konfiguration. Weitere optionale Argumente können angegeben werden. Eine umfassende Liste der Optionen finden Sie im Abschnitt über den Befehl ibmcloud ce buildrun submit.

Im folgenden Beispiel wird ein Build mit dem Namen helloworld-build-run ausgeführt, das das Build helloworld-build verwendet.

ibmcloud ce buildrun submit --build helloworld-build --name helloworld-build-run

Beispielausgabe

Submitting build run 'helloworld-build-run'...
Run 'ibmcloud ce buildrun get -n helloworld-build-run' to check the build run status.
OK

Die folgende Tabelle vermittelt Ihnen einen Überblick über die Optionen, die in diesem Beispiel beim Befehl buildrun submit verwendet werden. Weitere Informationen zum Befehl und den zugehörigen Optionen finden Sie im Abschnitt über den Befehl ibmcloud ce buildrun submit.

Befehlsbeschreibung
Option	Beschreibung
`--build`	Der Name der Buildkonfiguration, die verwendet werden soll. Dieser Wert ist erforderlich.
`--name`	Der Name der Buildausführung. Verwenden Sie einen Namen, der innerhalb des Projekts eindeutig ist. Der Name muss mit einem alphanumerischen Kleinbuchstaben beginnen und enden. Der Name darf maximal 63 Zeichen lang sein und alphanumerische Kleinbuchstaben sowie Bindestriche (-) enthalten.

Die Buildausführungen beginnen. Mit dem Befehl ibmcloud ce buildrun get können Sie den Verarbeitungsfortschritt überwachen.

Gehen Sie beispielsweise wie folgt vor, um den Status der Buildausführung aus dem vorherigen Beispiel zu überprüfen:

ibmcloud ce buildrun get --name helloworld-build-run

Beispielausgabe

Getting build run 'helloworld-build-run'...
[...]
OK

Name:          helloworld-build-run
ID:            abcdefgh-abcd-abcd-abcd-1a2b3c4d5e6f
Project Name:  myproject
Project ID:    01234567-abcd-abcd-abcd-abcdabcd1111
Age:           21m
Created:       2021-03-14T14:50:13-05:00

Summary:  Succeeded
Status:   Succeeded
Reason:   Succeeded

Weitere Informationen zu Builds finden Sie unter Tipps zur Fehlerbehebung.

Build für die Quelle aus einem lokalen Verzeichnis (lokal) über die Befehlszeilenschnittstelle ausführen

Verwenden Sie den Befehl buildrun submit, um eine Buildausführung aus einer Buildkonfiguration mit der CLI zu übergeben, die die Quelle aus dem lokalen Verzeichnis extrahiert. Dieser Befehl erfordert den Namen einer Build-Konfiguration und den Pfad zu Ihrer lokalen Quelle. Weitere optionale Argumente können angegeben werden. Eine umfassende Liste der Optionen finden Sie im Abschnitt über den Befehl ibmcloud ce buildrun submit.

Das folgende Szenario klont die Samples für IBM Cloud Code Engine GitHub repo in ein CodeEngineLocalSample-Verzeichnis auf Ihrer lokalen Workstation.

Klonen Sie die Beispiele für IBM Cloud Code Engine GitHub repo in ein Unterverzeichnis, das auf Ihrer lokalen Workstation erstellt wird, z. B. das Unterverzeichnis CodeEngineLocalSamples. Führen Sie in diesem Verzeichnis den Befehl git clone aus, zum Beispiel
```
git clone https://github.com/IBM/CodeEngine
```
Wechseln Sie in das Verzeichnis, in dem sich Ihr Quellcode auf Ihrer Workstation befindet. Wechseln Sie beispielsweise in das Unterverzeichnis CodeEngine, in dem sich die Beispiele für Code Engine befinden.

Übergeben Sie die Buildausführung aus dem Verzeichnis, in dem sich der Quellcode befindet. Im folgenden Beispiel wird ein Build mit dem Namen buildrun-local-dockerfile ausgeführt, das die Buildkonfiguration build-local-dockerfile verwendet. Die Option --source gibt den Pfad zur Quelle auf der lokalen Workstation zum helloworld-Beispiel an.

ibmcloud ce buildrun submit --name buildrun-local-dockerfile --build build-local-dockerfile --source ./helloworld

Beispielausgabe

Getting build 'build-local-dockerfile'
Packaging files to upload from source path './helloworld' ...
Submitting build run 'buildrun-local-dockerfile'...
Run 'ibmcloud ce buildrun get -n buildrun-local-dockerfile' to check the build run status.
OK

Überwachen Sie den Fortschritt Ihrer Buildausführung mit dem Befehl ibmcloud ce buildrun get. Gehen Sie beispielsweise wie folgt vor, um den Status der Buildausführung aus dem vorherigen Beispiel zu überprüfen:

ibmcloud ce buildrun get --name helloworld-build-run

Beispielausgabe

Getting build run 'buildrun-local-dockerfile'...
Run 'C:\Program Files\IBM\Cloud\bin\ibmcloud.exe ce buildrun events -n buildrun-local-dockerfile' to get the system events of the build run.
Run 'C:\Program Files\IBM\Cloud\bin\ibmcloud.exe ce buildrun logs -f -n buildrun-local-dockerfile' to follow the logs of the build run.
OK

Name:          buildrun-local-dockerfile
ID:            abcdefgh-abcd-abcd-abcd-1a2b3c4d5e6f
Project Name:  myproject
Project ID:    01234567-abcd-abcd-abcd-abcdabcd1111
Age:           40s
Created:       2022-01-19T12:22:33-05:00

Summary:       Succeeded
Status:        Succeeded
Reason:        All Steps have completed executing
Source:
  Source Image Digest:  sha256:07159930b5abcf94e1a7451ea18490d4ad1162a77c2b987da5b7493fa1f1e49d
Image Digest:  sha256:04c7be7db438a41040ea24d646314f1c847c191d88fffdbea6f483fc443c2bbe

Build Name:    build-local-dockerfile
Source Image:  us.icr.io/mynamespace/codeengine-build-source
Image:         us.icr.io/mynamespace/codeengine-build
Timeout:       10m0s

Wenn Sie ein Build übergeben, das Code aus dem lokalen Verzeichnis extrahiert, wird Ihr Quellcode in eine Archivdatei gepackt und in Ihre IBM Cloud Container Registry-Instanz hochgeladen. Nach Abschluss der Buildausführung wird Ihr erstelltes Image (z. B. codeengine-build) in der IBM Cloud Container Registry-Instanz angezeigt. Sie können auch ein Quellbild sehen, bei dem -source an den Namen Ihres Builds angehängt ist, z. B. codeengine-build-source. Sie können dieses Quellenimage ohne Auswirkungen löschen.

Weitere Informationen zu Builds finden Sie unter Tipps zur Fehlerbehebung.