Schnellstart: Bereitstellen einer Artefaktdatei in Azure Container Apps (Preview)
In dieser Schnellstartanleitung erfahren Sie, wie Sie eine Container-App aus einer vordefinierten Artefaktdatei bereitstellen. Das folgenden Beispiel in diesem Artikel stellt mithilfe einer JAR-Datei eine Java-Anwendung bereit, die eine javaspezifische Manifestdatei enthält. Ihre Aufgabe besteht darin, einen Back-End-Web-API-Dienst zu erstellen, der eine statische Sammlung von Musikalben zurückgibt. Nach Abschluss dieser Schnellstartanleitung können Sie mit Kommunikation zwischen Microservices fortfahren, um zu erfahren, wie Sie eine Front-End-Anwendung bereitstellen, die die API aufruft.
Der folgende Screenshot zeigt die Ausgabe des Album-API-Dienstes, den Sie bereitstellen.
Voraussetzungen
| Anforderung | Anweisungen |
|---|---|
| Azure-Konto | Erstellen Sie ein kostenloses Konto, falls Sie keines besitzen. Sie benötigen die Berechtigung Mitwirkender oder Besitzer für das Azure-Abonnement, um den Vorgang fortzusetzen. Weitere Einzelheiten finden Sie unter Zuweisen von Azure-Rollen über das Azure-Portal. |
| GitHub-Konto | Kostenlos erhalten. |
| Git | git installieren |
| Azure CLI | Installieren Sie die Azure CLI. |
| Java | Installieren Sie JDK, 17 oder höher empfohlen |
| Maven | Installieren Sie Maven. |
Setup
Um sich ausgehend von der CLI bei Azure anzumelden, führen Sie den folgenden Befehl aus und befolgen Sie die Anweisungen, um den Authentifizierungsprozess abzuschließen.
az login
Verwenden Sie den Upgradebefehl, um sicherzustellen, dass Sie die neueste Version der CLI ausführen.
az upgrade
Installieren oder aktualisieren Sie als Nächstes die Azure Container Apps-Erweiterung für die CLI.
Falls Sie Fehler aufgrund fehlender Parameter erhalten, wenn Sie az containerapp-Befehle in der Azure CLI oder Cmdlets aus dem Az.App-Modul in Azure PowerShell ausführen, stellen Sie sicher, dass die aktuelle Version der Azure Container Apps-Erweiterung installiert ist.
az extension add --name containerapp --upgrade
Hinweis
Ab Mai 2024 aktivieren Azure CLI-Erweiterungen standardmäßig keine Previewfunktionen mehr. Um auf Previewfunktionen von Container Apps zuzugreifen, installieren Sie die Container Apps-Erweiterung mit --allow-preview true.
az extension add --name containerapp --upgrade --allow-preview true
Nachdem die aktuelle Erweiterung oder das aktuelle Modul installiert ist, registrieren Sie nun die Namespaces Microsoft.App und Microsoft.OperationalInsights.
az provider register --namespace Microsoft.App
az provider register --namespace Microsoft.OperationalInsights
Erstellen von Umgebungsvariablen
Nachdem die Einrichtung Ihrer Azure CLI abgeschlossen ist, können Sie die Umgebungsvariablen definieren, die in diesem Artikel verwendet werden.
Definieren Sie die folgenden Variablen in Ihrer Bash-Shell.
RESOURCE_GROUP="album-containerapps"
LOCATION="canadacentral"
ENVIRONMENT="env-album-containerapps"
API_NAME="album-api"
SUBSCRIPTION=<YOUR_SUBSCRIPTION_ID>
Bei Bedarf können Sie Ihre Abonnement-ID abfragen.
az account list --output table
Vorbereiten des GitHub-Repositorys
Beginnen Sie mit dem Klonen des Beispiel-Repositorys.
Verwenden Sie den folgenden Git-Befehl, um die Beispiel-App in den Code-zu-Cloud-Ordner zu klonen:
git clone https://github.com/azure-samples/containerapps-albumapi-java code-to-cloud
cd code-to-cloud
Erstellen einer JAR-Datei
Hinweis
Das Java-Beispiel unterstützt nur einen Maven-Build, durch den eine ausführbare JAR-Datei entsteht. Der Build verwendet Standardeinstellungen, wenn Umgebungsvariablen übergeben werden, wird nicht unterstützt.
Erstellen Sie das Projekt mit Maven.
mvn clean package -DskipTests
Lokales Ausführen des Projekts
java -jar target\containerapps-albumapi-java-0.0.1-SNAPSHOT.jar
Um zu überprüfen, ob die Anwendung ausgeführt wird, öffnen Sie einen Browser, und wechseln Sie zu http://localhost:8080/albums. Die Seite gibt eine Liste der JSON-Objekte zurück.
Bereitstellen des Artefakts
Erstellen und bereitstellen Sie Ihre erste Container-App aus Ihrer lokalen JAR-Datei mit dem Befehl containerapp up.
Dieser Befehl:
- Erstellt die Ressourcengruppe
- Erstellt eine Azure-Containerregistrierung
- Erzeugt das Container-Image und überträgt es in die Registrierung
- Erstellt die Container Apps-Umgebung mit einem Log Analytics-Arbeitsbereich
- Erstellt und stellt die Container-App mithilfe eines öffentlichen Containerimages bereit
Der Befehl up verwendet die Docker-Datei im Repository-Stammverzeichnis, um das Containerimage zu erstellen. Die EXPOSE Anweisung in der Docker-Datei definiert den Zielport. Zum Erstellen einer Container-App ist jedoch keine Docker-Datei erforderlich.
Hinweis
Hinweis: Wenn Sie die Anwendung containerapp up in Kombination mit einer Codebasis ohne Docker verwenden, benutzen Sie den --location Parameter, damit die Anwendung an einem anderen Ort als USA, Osten läuft.
az containerapp up \
--name $API_NAME \
--resource-group $RESOURCE_GROUP \
--location $LOCATION \
--environment $ENVIRONMENT \
--artifact ./target/containerapps-albumapi-java-0.0.1-SNAPSHOT.jar \
--ingress external \
--target-port 8080 \
--subscription $SUBSCRIPTION
Überprüfen der Bereitstellung
Kopieren Sie den vollqualifizierten Domänennamen in einen Webbrowser. Navigieren Sie im Webbrowser zum Endpunkt /albums des vollqualifizierten Domänennamens.
Bereitstellen einer WAR-Datei
Sie können Ihre Container-App auch aus einer WAR-Datei bereitstellen.
Bereinigen von Ressourcen
Wenn Sie diese Anwendung nicht weiter verwenden möchten, können Sie die Azure Container Apps-Instanz und alle zugehörigen Dienste löschen, indem Sie die Ressourcengruppe entfernen.
Führen Sie die folgenden Schritte aus, um die von Ihnen erstellten Ressourcen zu entfernen:
az group delete \
--resource-group $RESOURCE_GROUP
Tipp
Treten Probleme auf? Informieren Sie uns über GitHub, indem Sie ein Problem im Azure Container Apps-Repository öffnen.