Tutorial: Erstellen und Bereitstellen Ihrer App in Azure Container Apps

In diesem Artikel wird veranschaulicht, wie Sie mithilfe Ihrer bevorzugten Programmiersprache einen Microservice für Azure Container Apps aus einem Quell-Repository erstellen und bereitstellen.

Dies ist das erste Tutorial in einer Reihe von Artikeln, die Sie durch die Verwendung der wichtigsten Funktionen in Azure Container Apps führen. Der erste Schritt besteht darin, einen Back-End-Web-API-Dienst zu erstellen, der eine statische Sammlung von Musikalben zurückgibt.

Hinweis

Sie können diese App auch mit dem Befehl az containerapp up erstellen und bereitstellen. Folgen Sie dazu den Anleitungen im Artikel Schnellstart: Erstellen und Bereitstellen einer App in Azure Container Apps aus einem Repository. Der Befehl az containerapp up bietet eine schnelle und praktische Methode, um Ihre App mithilfe eines einzigen Befehls zu erstellen und in Azure Container Apps bereitzustellen. Es bietet jedoch nicht die gleichen Anpassungsmöglichkeiten für Ihre Container-App.

Im nächsten Tutorial in der Reihe wird die Front-End-Webanwendung erstellt und in Azure Container Apps bereitgestellt.

Der folgende Screenshot zeigt die Ausgabe der Album-API, die in diesem Tutorial bereitgestellt wird.

Voraussetzungen

Zum Abschließen dieses Projekts benötigen Sie die folgenden Elemente:

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	Registrieren Sie sich kostenlos.
Git	git installieren
Azure CLI	Installieren Sie die Azure CLI.

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	Registrieren Sie sich kostenlos.
Git	git installieren
Azure CLI	Installieren Sie die Azure CLI.
Docker Desktop	Docker stellt Installationsprogramme zur Verfügung, die die Docker-Umgebung für macOS, Windows und Linux konfigurieren. Geben Sie an der Eingabeaufforderung docker ein, um sicherzustellen, dass Docker ausgeführt wird.

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.

Bash

az login

Azure PowerShell

Connect-AzAccount

Verwenden Sie den Upgradebefehl, um sicherzustellen, dass Sie die neueste Version der CLI ausführen.

Bash

az upgrade

Azure PowerShell

Install-Module -Name Az -Scope CurrentUser -Repository PSGallery -Force

Ignorieren Sie alle Warnungen zu derzeit verwendeten Modulen.

Installieren oder aktualisieren Sie als Nächstes die Azure Container Apps-Erweiterung für die CLI.

Bash

az extension add --name containerapp --upgrade

Azure PowerShell

Install-Module -Name Az.App

Wenn Sie eine ältere Version des Az.App-Moduls installiert haben, aktualisieren Sie es.

Update-Module -Name Az.App

Nachdem die aktuelle Erweiterung oder das aktuelle Modul installiert ist, registrieren Sie nun die Namespaces Microsoft.App und Microsoft.OperationalInsights.

Hinweis

Azure Container Apps-Ressourcen wurden vom Microsoft.Web-Namespace zum Microsoft.App-Namespace migriert. Weitere Informationen finden Sie unter Namespacemigration von Microsoft.Web zu Microsoft.App im März 2022.

Bash

az provider register --namespace Microsoft.App

az provider register --namespace Microsoft.OperationalInsights

Azure PowerShell

Register-AzResourceProvider -ProviderNamespace Microsoft.App

Register-AzResourceProvider -ProviderNamespace 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.

Bash

Definieren Sie die folgenden Variablen in Ihrer Bash-Shell.

RESOURCE_GROUP="album-containerapps"
LOCATION="canadacentral"
ENVIRONMENT="env-album-containerapps"
API_NAME="album-api"
FRONTEND_NAME="album-ui"
GITHUB_USERNAME="<YOUR_GITHUB_USERNAME>"

Bevor Sie diesen Befehl ausführen, müssen Sie <YOUR_GITHUB_USERNAME> durch Ihren GitHub-Benutzernamen ersetzen.

Definieren Sie als Nächstes einen für Sie eindeutigen Containerregistrierungsnamen.

ACR_NAME="acaalbums"$GITHUB_USERNAME

Azure PowerShell

Legen Sie die folgenden Variablen in Ihrer PowerShell-Konsole fest.

$ResourceGroup = "album-containerapps"
$Location = "canadacentral"
$Environment = "env-album-containerapps"
$APIName="album-api"
$FrontendName="album-ui"
$GITHUB_USERNAME = "<YOUR_GITHUB_USERNAME>"

Bevor Sie diesen Befehl ausführen, müssen Sie <YOUR_GITHUB_USERNAME> durch Ihren GitHub-Benutzernamen ersetzen.

Definieren Sie als Nächstes einen für Sie eindeutigen Containerregistrierungsnamen.

$ACRName = "acaalbums"+$GITHUB_USERNAME

Vorbereiten des GitHub-Repositorys

Navigieren Sie zum Repository für Ihre bevorzugte Sprache und forken (verzweigen) Sie das Repository.

C#

Wählen Sie oben im Album API-Repository die Schaltfläche Forken aus, um das Repository in Ihr Konto zu forken.

Jetzt können Sie Ihre Fork des Beispiel-Repositorys klonen.

Verwenden Sie den folgenden git-Befehl, um Ihr geforktes Repository in den Code-zu-Cloud-Ordner zu klonen:

git clone https://github.com/$GITHUB_USERNAME/containerapps-albumapi-csharp.git code-to-cloud

OK

Wählen Sie oben im Album API-Repository die Schaltfläche Forken aus, um das Repository in Ihr Konto zu forken.

Jetzt können Sie Ihre Fork des Beispiel-Repositorys klonen.

Verwenden Sie den folgenden git-Befehl, um Ihr geforktes Repository in den Code-zu-Cloud-Ordner zu klonen:

git clone https://github.com/$GITHUB_USERNAME/containerapps-albumapi-go.git code-to-cloud

Java

Wählen Sie oben im Album API-Repository die Schaltfläche Forken aus, um das Repository in Ihr Konto zu forken.

Jetzt können Sie Ihre Fork des Beispiel-Repositorys klonen.

Verwenden Sie den folgenden git-Befehl, um Ihr geforktes Repository in den Code-zu-Cloud-Ordner zu klonen:

git clone https://github.com/$GITHUB_USERNAME/containerapps-albumapi-java.git code-to-cloud

Hinweis

Das Java-Beispiel unterstützt nur einen Maven-Build, durch den eine ausführbare JAR-Datei entsteht. Der Build verwendet die Standardeinstellungen, da das Übergeben von Umgebungsvariablen nicht unterstützt wird.

JavaScript

Wählen Sie oben im Album API-Repository die Schaltfläche Forken aus, um das Repository in Ihr Konto zu forken.

Jetzt können Sie Ihre Fork des Beispiel-Repositorys klonen.

Verwenden Sie den folgenden git-Befehl, um Ihr geforktes Repository in den Code-zu-Cloud-Ordner zu klonen:

git clone https://github.com/$GITHUB_USERNAME/containerapps-albumapi-javascript.git code-to-cloud

Python

Wählen Sie oben im Album API-Repository die Schaltfläche Forken aus, um das Repository in Ihr Konto zu forken.

Jetzt können Sie Ihre Fork des Beispiel-Repositorys klonen.

Verwenden Sie den folgenden git-Befehl, um Ihr geforktes Repository in den Code-zu-Cloud-Ordner zu klonen:

git clone https://github.com/$GITHUB_USERNAME/containerapps-albumapi-python.git code-to-cloud

Ändern Sie als Nächstes das Verzeichnis in das Stammverzeichnis des geklonten Repositorys.

cd code-to-cloud/src

Erstellen einer Azure-Ressourcengruppe

Erstellen Sie eine Ressourcengruppe, um die Dienste im Zusammenhang mit der Bereitstellung Ihrer Container-App zu organisieren.

Bash

az group create \
  --name $RESOURCE_GROUP \
  --location "$LOCATION"

Azure PowerShell

New-AzResourceGroup -Location $Location -Name $ResourceGroupName

Erstellen einer Azure-Containerregistrierung

Nachdem das Album-API-Containerimage erstellt wurde, erstellen Sie eine Azure Container Registry-Instanz (ACR) in Ihrer Ressourcengruppe, um es zu speichern.

Bash

az acr create \
  --resource-group $RESOURCE_GROUP \
  --name $ACR_NAME \
  --sku Basic \
  --admin-enabled true

Azure PowerShell

$acr = New-AzContainerRegistry -ResourceGroupName $ResourceGroup -Name $ACRName -Sku Basic -EnableAdminUser

Erstellen Ihrer Anwendung

Mit ACR-Aufgaben können Sie das Docker-Image für die Album-API erstellen und mithilfe von Push zu übertragen, ohne Docker lokal zu installieren.

Erstellen des Containers mit ACR

Führen Sie den folgenden Befehl aus, um den Prozess zur Erstellung und zum Übertragen des Image mithilfe von ACR zu initiieren. Das . am Ende des Befehls stellt den Docker-Build-Kontext dar, was bedeutet, dass dieser Befehl innerhalb des src-Ordners ausgeführt werden sollte, in dem sich die Dockerfile befindet.

Bash

az acr build --registry $ACR_NAME --image $API_NAME .

Azure PowerShell

az acr build --registry $ACRName --image $APIName .

Die Ausgabe aus dem az acr build-Befehl zeigt den Upload-Fortschritt des Quellcodes in Azure und die Details der Vorgänge docker build und docker push.

Erstellen Ihrer Anwendung

Die folgenden Schritte zeigen, wie Sie Ihr Containerimage lokal mithilfe von Docker erstellen und das Image mithilfe von Push an die neue Containerregistrierung übertragen.

Erstellen des Containers mit Docker

Der folgende Befehl erstellt ein Containerimage für die Album-API und markiert es mit dem vollqualifizierten Namen des ACR-Anmeldeservers. Das . am Ende des Befehls stellt den Docker-Build-Kontext dar, was bedeutet, dass dieser Befehl innerhalb des src-Ordners ausgeführt werden sollte, in dem sich die Dockerfile befindet.

Bash

docker build --tag $ACR_NAME.azurecr.io/$API_NAME .

Azure PowerShell

docker build --tag "$ACRName.azurecr.io/$APIName" .

Übertragen des Images mithilfe von Push an Ihre Containerregistrierung

Melden Sie sich zuerst bei Ihrer Azure Container Registry an.

Bash

az acr login --name $ACR_NAME

Azure PowerShell

az acr login --name $ACRName

Übertragen Sie jetzt das Image mithilfe von Push an Ihre Registrierung.

Bash

docker push $ACR_NAME.azurecr.io/$API_NAME

Azure PowerShell

docker push "$ACRName.azurecr.io/$APIName"

Erstellen einer Container-Apps-Umgebung

Die Azure Container Apps-Umgebung fungiert als eine sichere Grenze, die eine Gruppe von Container-Apps umgibt.

Erstellen Sie die Container-Apps-Umgebung mit dem folgenden Befehl.

Bash

az containerapp env create \
  --name $ENVIRONMENT \
  --resource-group $RESOURCE_GROUP \
  --location "$LOCATION"

Azure PowerShell

Für die Container Apps-Umgebung ist ein Log Analytics-Arbeitsbereich erforderlich. Die folgenden Befehle erstellen einen Log Analytics-Arbeitsbereich und speichern die Arbeitsbereichs-ID und den primären freigegebenen Schlüssel in Variablen.

$WorkspaceArgs = @{
    Name = 'my-album-workspace'
    ResourceGroupName = $ResourceGroup
    Location = $Location
    PublicNetworkAccessForIngestion = 'Enabled'
    PublicNetworkAccessForQuery = 'Enabled'
}
New-AzOperationalInsightsWorkspace @WorkspaceArgs
$WorkspaceId = (Get-AzOperationalInsightsWorkspace -ResourceGroupName $ResourceGroup -Name $WorkspaceArgs.Name).CustomerId
$WorkspaceSharedKey = (Get-AzOperationalInsightsWorkspaceSharedKey -ResourceGroupName $ResourceGroup -Name $WorkspaceArgs.Name).PrimarySharedKey

Führen Sie den folgenden Befehl aus, um die Umgebung zu erstellen:

$EnvArgs = @{
    EnvName = $Environment
    ResourceGroupName = $ResourceGroup
    Location = $Location
    AppLogConfigurationDestination = 'log-analytics'
    LogAnalyticConfigurationCustomerId = $WorkspaceId
    LogAnalyticConfigurationSharedKey = $WorkspaceSharedKey
}

New-AzContainerAppManagedEnv @EnvArgs

Bereitstellen Ihres Images in einer Container-App

Nachdem Sie eine Umgebung erstellt haben, können Sie Ihre Container-App mit dem Befehl az containerapp create erstellen und bereitstellen.

Erstellen Sie Ihre Container App mit dem folgenden Befehl und stellen Sie sie bereit.

Bash

az containerapp create \
  --name $API_NAME \
  --resource-group $RESOURCE_GROUP \
  --environment $ENVIRONMENT \
  --image $ACR_NAME.azurecr.io/$API_NAME \
  --target-port 8080 \
  --ingress 'external' \
  --registry-server $ACR_NAME.azurecr.io \
  --query properties.configuration.ingress.fqdn

• Wenn Sie --ingress auf external setzen, ist Ihre Container-App über das öffentliche Internet zugänglich.

• target-port wird auf 8080 festgelegt, damit es mit dem Port übereinstimmt, an dem der Container auf Anforderungen lauscht.

• Ohne eine query-Eigenschaft gibt der Aufruf an az containerapp create eine JSON-Antwort zurück, die umfangreiche Details zur Anwendung enthält. Durch das Hinzufügen eines Abfrageparameters wird die Ausgabe auf nur den vollqualifizierten Domänennamen (FQDN) der App gefiltert.

Azure PowerShell

Zum Erstellen der Container-App erstellen Sie Vorlagenobjekte, die Sie als Argumente an den Befehl New-AzContainerApp übergeben.

Erstellen Sie ein Vorlagenobjekt, um Ihre Containerimageparameter zu definieren.

$ImageParams = @{
    Name = $APIName
    Image = $ACRName + '.azurecr.io/' + $APIName + ':latest'
}
$TemplateObj = New-AzContainerAppTemplateObject @ImageParams

Führen Sie den folgenden Befehl aus, um Ihre Registrierungsanmeldeinformationen abzurufen.

$RegistryCredentials = Get-AzContainerRegistryCredential -Name $ACRName -ResourceGroupName $ResourceGroup

Erstellen Sie ein Registrierungsanmeldeinformationen-Objekt, um Ihre Registrierungsinformationen zu definieren, sowie ein Geheimnisobjekt, um Ihr Registrierungskennwort festzulegen. PasswordSecretRef bezieht sich auf den Name im Geheimnisobjekt.

$RegistryArgs = @{
    Server = $ACRName + '.azurecr.io'
    PasswordSecretRef = 'registrysecret'
    Username = $RegistryCredentials.Username
}
$RegistryObj = New-AzContainerAppRegistryCredentialObject @RegistryArgs

$SecretObj = New-AzContainerAppSecretObject -Name 'registrysecret' -Value $RegistryCredentials.Password

Rufen Sie Ihre Umgebungs-ID ab.

$EnvId = (Get-AzContainerAppManagedEnv -EnvName $Environment -ResourceGroup $ResourceGroup).Id

Erstellen Sie die Container-App.

$AppArgs = @{
    Name = $APIName
    Location = $Location
    ResourceGroupName = $ResourceGroup
    ManagedEnvironmentId = $EnvId
    TemplateContainer = $TemplateObj
    ConfigurationRegistry = $RegistryObj
    ConfigurationSecret = $SecretObj
    IngressTargetPort = 8080
    IngressExternal = $true
}
$MyApp = New-AzContainerApp @AppArgs

# show the app's fully qualified domain name (FQDN).
$MyApp.IngressFqdn

• Wenn Sie IngressExternal auf external setzen, ist Ihre Container-App über das öffentliche Internet zugänglich.
• Der Parameter IngressTargetPort wird auf 8080 festgelegt, damit er mit dem Port übereinstimmt, an dem der Container auf Anforderungen lauscht.

Überprüfen der Bereitstellung

Kopieren Sie den vollqualifizierten Domänennamen in einen Webbrowser. Navigieren Sie im Webbrowser zum Endpunkt /albums des vollqualifizierten Domänennamen.

Bereinigen von Ressourcen

Wenn Sie das Tutorial Kommunikation zwischen Microservices nicht fortsetzen möchten, können Sie die Azure-Ressourcen entfernen, die während dieser Schnellstartanleitung erstellt wurden. Führen Sie den folgenden Befehl aus, um die Ressourcengruppe zusammen mit allen in dieser Schnellstartanleitung erstellten Ressourcen zu löschen.

Bash

az group delete --name $RESOURCE_GROUP

Azure PowerShell

Remove-AzResourceGroup -Name $ResourceGroup -Force

Tipp

Treten Probleme auf? Informieren Sie uns über GitHub, indem Sie ein Problem im Azure Container Apps-Repository öffnen.

Nächste Schritte

Diese Schnellstartanleitung ist der Einstiegspunkt für eine Reihe aufeinander aufbauender Tutorials, die die verschiedenen Funktionen in Azure Container Apps vorstellen. Fahren Sie fort, um zu erfahren, wie Sie die Kommunikation über ein Web-Front-End aktivieren, das die API aufruft, die Sie in diesem Artikel bereitgestellt haben.

Tutorial: Kommunikation zwischen Microservices