Buildkonfiguration erstellen, die Quelle aus einem lokalen Verzeichnis extrahiert

Wenn sich Ihre Quelle auf Ihrer lokalen Workstation befindet, erstellen Sie eine Build-Konfiguration mit Einstellungen, die Informationen dazu enthalten, wo die Quelle aus dem lokalen Verzeichnis extrahiert werden soll. Für die Buildausgabe können Sie Registry-Details angeben oder Details für Code Engine verwalten lassen IBM Cloud Container Registry.

Sie können eine Buildkonfiguration erstellen, die Quelle aus einem lokalen Verzeichnis extrahiert, indem Sie nur die Code Engine-CLI verwenden.

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. Beachten Sie, dass Sie IBM Cloud Container Registry nur für Ihre lokalen Builds verwenden können. Das Quellenimage wird in demselben Namensbereich erstellt wie Ihr Build-Image.

Sie können bestimmte Dateimuster in Ihrem Quellcode ignorieren, indem Sie die Datei .ceignore verwenden, die sich ähnlich wie eine .gitignore-Datei verhält. Einträge für eine .ceignore-Datei bezüglich einer Node.js-Anwendung können beispielsweise node_modules und .npm enthalten. Weitere Beispiele für zu ignorierende Dateimuster finden Sie im GitHub.gitignore-Repository.

Das Erstellen einer Buildkonfiguration dient nicht zur Erstellung eines Image, sondern erstellt die Konfiguration für den Build eines Image. Zur Erstellung eines Images müssen Sie anschließend einen Build ausführen, der die Buildkonfiguration referenziert. Die Buildkonfiguration wird erst bei der Ausführung des Builds validiert oder zum Erstellen eines Images verwendet. Mit der Buildkonfiguration können nacheinander mehrere Builds für ein Image ausgeführt werden, beispielsweise nach dem Anwenden von Änderungen auf das Quellenrepository.

Verwenden Sie zum Erstellen einer Buildkonfiguration, die Code aus einem lokalen Verzeichnis über die CLI extrahiert, den Befehl build create und geben Sie build-type als local an. Eine umfassende Liste der Optionen finden Sie im Abschnitt über den Befehl ibmcloud ce build create.

Mit dem Befehl build create können Sie Code Engine das Image aus Ihrer Quelle erstellen und das Image in IBM Cloud Container Registryspeichern lassen. Bei diesem automatischen Zugriff müssen Sie keinen geheimen Registry-Schlüssel oder die Position der Image-Registry angeben. Sie können auch die Position für die Ausgabe Ihres Build-Images angeben und einen geheimen Schlüssel für die Registry bereitstellen, damit Code Engine auf das Buildergebnis zugreifen und es mit Push-Operation an Ihre Registry übertragen kann.

Build-Konfiguration mit Befehlszeilenschnittstelle erstellen (mit lokaler Quelle und automatischem Zugriff auf Registry)

In diesem Szenario erstellt Code Engine ein Image aus Ihrer lokalen Quelle und lädt das Image automatisch in IBM Cloud Container Registry hoch. Weitere Informationen zum Festlegen der erforderlichen Berechtigungen für Code Engine für den automatischen Zugriff auf diese Images in Container Registry finden Sie unter Berechtigungen für Image-Registrys einrichten.

Vorbereitende Schritte

Erstellen Sie eine Build-Konfiguration, um ein Image aus der Quelle auf Ihrer lokalen Workstation zu erstellen, und lassen Sie Code Engine das Image automatisch speichern und darauf zugreifen. Wenn Sie local als Wert für -build-type angeben, können Sie nur IBM Cloud Container Registry als Ziel für die Ausgabe Ihres lokalen Builds angeben. In diesem Beispiel verwendet der Befehl die Standardstrategie dockerfile und die Standardbuildgröße medium. Wenn Sie die Position der Image-Registry oder eines geheimen Registry-Schlüssels nicht angeben, überträgt Code Engine die Buildausgabe mit einer Push-Operation mit automatischem Zugriff an IBM Cloud Container Registry.

ibmcloud ce build create --name build-local-dockerfile --build-type local

Nach der Erstellung der Buildkonfiguration müssen Sie den Build ausführen, um die Imagedatei zu erstellen. Nach der Erstellung der Imagedatei können Sie eine App bereitstellen oder einen Job ausführen mit Ihrer neu erstellten Imagedatei.

Build-Konfiguration mit der Befehlszeilenschnittstelle erstellen (mit lokaler Quelle und vom Benutzer bereitgestelltem Registry-Zugriff)

In diesem Szenario erstellt Code Engine ein Image aus Ihrer lokalen Quelle und lädt dann das Image mit dem von Ihnen bereitgestellten Registry-Zugriff in Ihre Container-Registry hoch.

Vorbereitende Schritte

Erstellen Sie eine Buildkonfiguration, um ein Image aus der Quelle auf Ihrer lokalen Workstation zu erstellen und die Position der Image-Registry für die Buildausgabe mit einem geheimen Registry-Schlüssel anzugeben. Wenn Sie mit dem Befehl build create local als Wert für --build-type angeben, können Sie nur IBM Cloud Container Registry als Ziel für die Ausgabe Ihres lokalen Builds angeben. Geben Sie die Option --image an, um die Position der Image-Registry anzugeben, und geben Sie die Option --registry-secret an, um auf die Registry zuzugreifen. In diesem Beispiel verwendet der Befehl die Standardstrategie dockerfile und die Standardbuildgröße medium.

ibmcloud ce build create --name build-local-dockerfile --build-type local --image us.icr.io/mynamespace/codeengine-build --registry-secret myregistry