Zelfstudie: Uw app bouwen en implementeren in Azure Container Apps

In dit artikel wordt gedemonstreerd hoe u een microservice bouwt en implementeert in Azure Container Apps vanuit een bronopslagplaats met behulp van de programmeertaal van uw voorkeur.

Dit is de eerste zelfstudie in de reeks artikelen waarin u wordt begeleid bij het gebruik van kernmogelijkheden in Azure Container Apps. De eerste stap is het maken van een back-end web-API-service die een statische verzameling muziekalbums retourneert.

Notitie

U kunt deze app ook bouwen en implementeren met behulp van de az containerapp up door de instructies in de quickstart te volgen: Een app bouwen en implementeren in Azure Container Apps vanuit een opslagplaatsartikel . De az containerapp up opdracht is een snelle en handige manier om uw app te bouwen en te implementeren in Azure Container Apps met één opdracht. Het biedt echter niet hetzelfde aanpassingsniveau voor uw container-app.

De volgende zelfstudie in de reeks bouwt en implementeert de front-endwebtoepassing in Azure Container Apps.

In de volgende schermopname ziet u de uitvoer van de album-API die in deze zelfstudie is geïmplementeerd.

Vereisten

U hebt het volgende nodig om dit project te voltooien:

Vereiste	Instructies
Azure-account	Als u nog geen account hebt, maakt u gratis een account. U hebt de machtiging Inzender of Eigenaar voor het Azure-abonnement nodig om door te gaan. Raadpleeg Azure-rollen toewijzen met behulp van Azure Portal voor meer informatie.
GitHub-account	Meld u gratis aan.
git	Git installeren
Azure-CLI	Installeer de Azure CLI.

Vereiste	Instructies
Azure-account	Als u nog geen account hebt, maakt u gratis een account. U hebt de machtiging Inzender of Eigenaar voor het Azure-abonnement nodig om door te gaan. Raadpleeg Azure-rollen toewijzen met behulp van Azure Portal voor meer informatie.
GitHub-account	Meld u gratis aan.
git	Git installeren
Azure-CLI	Installeer de Azure CLI.
Docker Desktop	Docker biedt installatieprogramma's die de Docker-omgeving configureren op macOS, Windows en Linux. Typ docker vanaf de opdrachtprompt of Docker wordt uitgevoerd.

Instellingen

Als u zich wilt aanmelden bij Azure vanuit de CLI, voert u de volgende opdracht uit en volgt u de aanwijzingen om het verificatieproces te voltooien.

Bash

az login

Azure PowerShell

Connect-AzAccount

Voer de upgradeopdracht uit om ervoor te zorgen dat u de nieuwste versie van de CLI uitvoert.

Bash

az upgrade

Azure PowerShell

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

Negeer eventuele waarschuwingen over modules die momenteel in gebruik zijn.

Installeer of werk vervolgens de Azure Container Apps-extensie voor de CLI bij.

Bash

az extension add --name containerapp --upgrade

Azure PowerShell

Install-Module -Name Az.App

Als u een oudere versie van de Az.App-module hebt geïnstalleerd, werkt u deze bij.

Update-Module -Name Az.App

Nu de huidige extensie of module is geïnstalleerd, registreert u de Microsoft.App en Microsoft.OperationalInsights naamruimten.

Notitie

Azure Container Apps-resources zijn gemigreerd van de Microsoft.Web naamruimte naar de Microsoft.App naamruimte. Raadpleeg de naamruimtemigratie van Microsoft.Web naar Microsoft.App in maart 2022 voor meer informatie.

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

Omgevingsvariabelen maken

Nu uw Azure CLI-installatie is voltooid, kunt u de omgevingsvariabelen definiëren die in dit artikel worden gebruikt.

Bash

Definieer de volgende variabelen in uw 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>"

Voordat u deze opdracht uitvoert, moet u deze vervangen door <YOUR_GITHUB_USERNAME> uw GitHub-gebruikersnaam.

Definieer vervolgens een containerregisternaam die uniek voor u is.

ACR_NAME="acaalbums"$GITHUB_USERNAME

Azure PowerShell

Definieer de volgende variabelen in uw PowerShell-console.

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

Voordat u deze opdracht uitvoert, moet u deze vervangen door <YOUR_GITHUB_USERNAME> uw GitHub-gebruikersnaam.

Definieer vervolgens een containerregisternaam die uniek voor u is.

$ACRName = "acaalbums"+$GITHUB_USERNAME

De GitHub-opslagplaats voorbereiden

Navigeer naar de opslagplaats voor uw voorkeurstaal en fork de opslagplaats.

C#

Selecteer de knop Fork boven aan de api-opslagplaats van het album om de opslagplaats naar uw account te splitsen.

U kunt nu uw fork van de voorbeeldopslagplaats klonen.

Gebruik de volgende Git-opdracht om uw geforkte opslagplaats te klonen in de map code-naar-cloud :

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

Go

Selecteer de knop Fork boven aan de api-opslagplaats van het album om de opslagplaats naar uw account te splitsen.

U kunt nu uw fork van de voorbeeldopslagplaats klonen.

Gebruik de volgende Git-opdracht om uw geforkte opslagplaats te klonen in de map code-naar-cloud :

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

Java

Selecteer de knop Fork boven aan de api-opslagplaats van het album om de opslagplaats naar uw account te splitsen.

U kunt nu uw fork van de voorbeeldopslagplaats klonen.

Gebruik de volgende Git-opdracht om uw geforkte opslagplaats te klonen in de map code-naar-cloud :

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

Notitie

Het Java-voorbeeld ondersteunt alleen een Maven-build, wat resulteert in een uitvoerbaar JAR-bestand. De build maakt gebruik van de standaardinstellingen, omdat het doorgeven van omgevingsvariabelen niet wordt ondersteund.

JavaScript

Selecteer de knop Fork boven aan de api-opslagplaats van het album om de opslagplaats naar uw account te splitsen.

U kunt nu uw fork van de voorbeeldopslagplaats klonen.

Gebruik de volgende Git-opdracht om uw geforkte opslagplaats te klonen in de map code-naar-cloud :

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

Python

Selecteer de knop Fork boven aan de api-opslagplaats van het album om de opslagplaats naar uw account te splitsen.

U kunt nu uw fork van de voorbeeldopslagplaats klonen.

Gebruik de volgende Git-opdracht om uw geforkte opslagplaats te klonen in de map code-naar-cloud :

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

Wijzig vervolgens de map in de hoofdmap van de gekloonde opslagplaats.

cd code-to-cloud/src

Maak een Azure-resourcegroep

Maak een resourcegroep om de services te ordenen die betrekking hebben op de implementatie van uw container-app.

Bash

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

Azure PowerShell

New-AzResourceGroup -Location $Location -Name $ResourceGroupName

Een Azure Container Registry maken

Nadat de installatiekopie van de album-API-container is gemaakt, maakt u een Exemplaar van Azure Container Registry (ACR) in uw resourcegroep om deze op te slaan.

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

Uw toepassing bouwen

Met ACR-taken kunt u de docker-installatiekopieën voor de album-API bouwen en pushen zonder Docker lokaal te installeren.

De container bouwen met ACR

Voer de volgende opdracht uit om het build- en pushproces van de installatiekopieën te starten met behulp van ACR. De . aan het einde van de opdracht vertegenwoordigt de docker-buildcontext, wat betekent dat deze opdracht moet worden uitgevoerd in de src-map waar het Dockerfile zich bevindt.

Bash

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

Azure PowerShell

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

De uitvoer van de az acr build opdracht toont de voortgang van de upload van de broncode naar Azure en de details van de docker build en docker push bewerkingen.

Uw toepassing bouwen

De volgende stappen laten zien hoe u uw containerinstallatiekopieën lokaal bouwt met behulp van Docker en de installatiekopieën naar het nieuwe containerregister pusht.

De container bouwen met Docker

Met de volgende opdracht wordt een containerinstallatiekopieën voor de album-API gebouwd en gelabeld met de volledig gekwalificeerde naam van de ACR-aanmeldingsserver. De . aan het einde van de opdracht vertegenwoordigt de docker-buildcontext, wat betekent dat deze opdracht moet worden uitgevoerd in de src-map waar het Dockerfile zich bevindt.

Bash

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

Azure PowerShell

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

De installatiekopieën naar uw containerregister pushen

Meld u eerst aan bij uw Azure Container Registry.

Bash

az acr login --name $ACR_NAME

Azure PowerShell

az acr login --name $ACRName

Push nu de installatiekopieën naar het register.

Bash

docker push $ACR_NAME.azurecr.io/$API_NAME

Azure PowerShell

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

Een Container Apps-omgeving maken

De Azure Container Apps-omgeving fungeert als een veilige grens rond een groep container-apps.

Maak de Container Apps-omgeving met behulp van de volgende opdracht.

Bash

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

Azure PowerShell

Een Log Analytics-werkruimte is vereist voor de Container Apps-omgeving. Met de volgende opdrachten maakt u een Log Analytics-werkruimte en slaat u de werkruimte-id en de primaire gedeelde sleutel op in variabelen.

$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

Voer de volgende opdracht uit om de omgeving te maken:

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

New-AzContainerAppManagedEnv @EnvArgs

Uw installatiekopieën implementeren in een container-app

Nu u een omgeving hebt gemaakt, kunt u uw container-app maken en implementeren met de az containerapp create opdracht.

Maak en implementeer uw container-app met de volgende opdracht.

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

• Door deze instelling in te externalstellen--ingress, is uw container-app toegankelijk vanaf het openbare internet.

• De target-port waarde is ingesteld op 8080 overeenkomen met de poort waarnaar de container luistert voor aanvragen.

• Zonder een query eigenschap retourneert de aanroep om een JSON-antwoord te az containerapp create retourneren dat een uitgebreide set details over de toepassing bevat. Als u een queryparameter toevoegt, wordt de uitvoer gefilterd op alleen de FQDN (Fully Qualified Domain Name) van de app.

Azure PowerShell

Als u de container-app wilt maken, maakt u sjabloonobjecten die u als argumenten doorgeeft aan de New-AzContainerApp opdracht.

Maak een sjabloonobject om de parameters voor de containerinstallatiekopieën te definiëren.

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

Voer de volgende opdracht uit om uw registerreferenties op te halen.

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

Maak een registerreferentieobject om uw registergegevens te definiëren en een geheim object om uw registerwachtwoord te definiëren. De PasswordSecretRef verwijst naar het Name in het geheime object.

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

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

Haal uw omgevings-id op.

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

Maak de 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

• Door deze instelling in te externalstellenIngressExternal, is uw container-app toegankelijk vanaf het openbare internet.
• De IngressTargetPort parameter is zo ingesteld 8080 dat deze overeenkomt met de poort waarnaar de container luistert voor aanvragen.

Implementatie verifiëren

Kopieer de FQDN naar een webbrowser. Navigeer vanuit uw webbrowser naar het /albums eindpunt van de FQDN.

Resources opschonen

Als u niet verdergaat met de zelfstudie Communicatie tussen microservices , kunt u de Azure-resources verwijderen die tijdens deze quickstart zijn gemaakt. Voer de volgende opdracht uit om de resourcegroep te verwijderen, samen met alle resources die in deze quickstart zijn gemaakt.

Bash

az group delete --name $RESOURCE_GROUP

Azure PowerShell

Remove-AzResourceGroup -Name $ResourceGroup -Force

Tip

Ondervindt u problemen? Laat het ons weten op GitHub door een probleem te openen in de Azure Container Apps-opslagplaats.

Volgende stappen

Deze quickstart is het beginpunt voor een reeks progressieve zelfstudies die de verschillende functies in Azure Container Apps laten zien. Ga verder met het inschakelen van communicatie vanuit een webfront-end die de API aanroept die u in dit artikel hebt geïmplementeerd.

Zelfstudie: Communicatie tussen microservices