Erstellen und Übertragen eines Images aus einer App mithilfe eines Cloud Native-Buildpacks

Artikel
10/31/2023

Der Azure CLI-Befehl az acr pack build verwendet das pack-CLI-Tool von Buildpacks, um eine App zu erstellen und das Image mithilfe von Push in eine Azure-Containerregistrierung zu übertragen. Diese Funktion bietet eine Option für das schnelle Erstellen eines Containerimages aus dem Quellcode Ihrer Anwendung in Node.js, Java und anderen Sprachen ohne Dockerfile-Definition.

Sie können Azure Cloud Shell oder eine lokale Installation der Azure CLI verwenden, um die Beispiele in diesem Artikel auszuführen. Wenn Sie es lokal verwenden möchten, ist Version 2.0.70 oder höher erforderlich. Führen Sie az --version aus, um die Version zu ermitteln. Informationen zum Durchführen einer Installation oder eines Upgrades finden Sei bei Bedarf unter Installieren der Azure CLI.

Wichtig

Diese Funktion steht derzeit als Vorschau zur Verfügung. Vorschauversionen werden Ihnen zur Verfügung gestellt, wenn Sie die zusätzlichen Nutzungsbedingungen akzeptieren. Einige Aspekte dieses Features werden bis zur allgemeinen Verfügbarkeit unter Umständen noch geändert.

Verwenden des „build“-Befehls

Führen Sie den Befehl az acr pack build aus, um ein Containerimage mithilfe eines Cloud Native-Buildpacks zu erstellen und mithilfe von Push zu übertragen. Während der Befehl az acr build ein Image aus einer Dockerfile-Quelle und zugehörigem Code erstellt und mithilfe von Push überträgt, geben Sie mit az acr pack build direkt eine Anwendungsquellstruktur an.

Geben Sie beim Ausführen des Befehls az acr pack build mindestens Folgendes an:

Eine Azure-Containerregistrierung, in der Sie den Befehl ausführen
Ein Imagename und -tag für das neu erstellte Image
Einen der unterstützten Kontextspeicherorte für ACR Tasks (z. B. ein lokales Verzeichnis, ein GitHub-Repository oder ein Remotetarball)
Den Namen eines Buildpack-Generatorimages, das für Ihre Anwendung geeignet ist. Wenn es nicht von Azure Container Registry zwischengespeichert wird, muss das Generatorimage mit dem Parameter --pull gepullt werden.

Der Befehl az acr pack build unterstützt weitere Funktionen von ACR Tasks-Befehlen (einschließlich Run-Variablen und gestreamte und für den späteren Abruf gespeicherte Ausführungsprotokolle für Aufgaben).

Beispiel: Erstellen eines Node.js-Images mit dem Cloud Foundry-Generator

Im folgenden Beispiel wird mithilfe des Generators cloudfoundry/cnb:cflinuxfs3 ein Containerimage aus der Node.js-App im Repository Azure-Samples/nodejs-docs-hello-world erstellt.

az acr pack build \
    --registry myregistry \
    --image node-app:1.0 \
    --pull --builder cloudfoundry/cnb:cflinuxfs3 \
    https://github.com/Azure-Samples/nodejs-docs-hello-world.git

In diesem Beispiel wird das node-app-Image mit dem 1.0-Tag erstellt und mithilfe von Push an die myregistry-Containerregistrierung übertragen. In diesem Beispiel wird der Name der Zielcontainerregistrierung dem Namen des Image explizit vorangestellt. Wenn dieser nicht angegeben ist, wird der Anmeldeservername der Registrierung automatisch dem Imagenamen vorangestellt.

Die Befehlsausgabe zeigt den Status der Erstellung und Übertragung des Images mithilfe von Push an.

Nachdem das Image erfolgreich erstellt wurde, können Sie es mit Docker ausführen, sofern es installiert ist. Melden Sie sich zuerst bei Ihrer Containerregistrierung an:

az acr login --name myregistry

Führen Sie das Image aus:

docker run --rm -p 1337:1337 myregistry.azurecr.io/node-app:1.0

Navigieren Sie in Ihrem bevorzugten Browser zu localhost:1337, um die Beispiel-Web-App anzuzeigen. Drücken Sie [Ctrl]+[C] (STRG+C), um den Container anzuhalten.

Beispiel: Erstellen eines Java-Images mit dem Heroku-Generator

Im folgenden Beispiel wird mithilfe des Generators heroku/buildpacks:18 ein Containerimage aus der Java-App im Repository buildpack/sample-java-app erstellt.

az acr pack build \
    --registry myregistry \
    --image java-app:{{.Run.ID}} \
    --pull --builder heroku/buildpacks:18 \
    https://github.com/buildpack/sample-java-app.git

In diesem Beispiel wird das mit der Ausführungs-ID des Befehls markierte java-app-Image erstellt und mithilfe von Push an die Containerregistrierung myregistry übertragen.

Die Befehlsausgabe zeigt den Status der Erstellung und Übertragung des Images mithilfe von Push an.

Nachdem das Image erfolgreich erstellt wurde, können Sie es mit Docker ausführen, sofern es installiert ist. Melden Sie sich zuerst bei Ihrer Containerregistrierung an:

az acr login --name myregistry

Führen Sie das Image aus, und ersetzen Sie das Imagetag durch runid:

docker run --rm -p 8080:8080 myregistry.azurecr.io/java-app:runid

Navigieren Sie in Ihrem bevorzugten Browser zu localhost:8080, um die Beispiel-Web-App anzuzeigen. Drücken Sie [Ctrl]+[C] (STRG+C), um den Container anzuhalten.

Nächste Schritte

Nachdem Sie mithilfe des Befehls az acr pack build ein Containerimage erstellt und mithilfe von Push übertragen haben, können Sie es wie jedes andere Image für ein Ziel Ihrer Wahl bereitstellen. Zu den Azure-Bereitstellungsoptionen gehört unter anderem die Ausführung in App Service oder Azure Kubernetes Service.

Weitere Informationen zu den ACR Tasks-Funktionen finden Sie unter Automate container image builds and maintenance with ACR Tasks (Automatisieren der Erstellung und der Wartung von Containerimages mit ACR Tasks).

Freigeben über