Samouczek: kompilowanie i wdrażanie aplikacji w usłudze Azure Container Apps

W tym artykule pokazano, jak utworzyć i wdrożyć mikrousługę w usłudze Azure Container Apps z repozytorium źródłowego przy użyciu preferowanego języka programowania.

Jest to pierwszy samouczek z serii artykułów, które przeprowadzą Cię przez proces korzystania z podstawowych funkcji w usłudze Azure Container Apps. Pierwszym krokiem jest utworzenie usługi internetowego interfejsu API zaplecza, która zwraca statyczną kolekcję albumów muzycznych.

Uwaga

Możesz również skompilować i wdrożyć tę aplikację przy użyciu polecenia az containerapp up , postępując zgodnie z instrukcjami w przewodniku Szybki start: kompilowanie i wdrażanie aplikacji w usłudze Azure Container Apps z poziomu artykułu o repozytorium . Polecenie az containerapp up to szybki i wygodny sposób kompilowania i wdrażania aplikacji w usłudze Azure Container Apps przy użyciu jednego polecenia. Nie zapewnia jednak tego samego poziomu dostosowywania aplikacji kontenera.

W następnym samouczku z serii skompiluje i wdrożysz aplikację internetową frontonu w usłudze Azure Container Apps.

Poniższy zrzut ekranu przedstawia dane wyjściowe z interfejsu API albumu wdrożonego w tym samouczku.

Wymagania wstępne

Do ukończenia tego projektu potrzebne są następujące elementy:

Wymaganie	Instrukcje
Konto platformy Azure	Jeśli go nie masz, utwórz bezpłatne konto. Aby kontynuować, musisz mieć uprawnienia administratora dostępu użytkowników lub właściciela subskrypcji platformy Azure. Upewnij się, że kontekst używa najbardziej restrykcyjnej roli. Aby uzyskać szczegółowe informacje, zobacz Przypisywanie ról platformy Azure przy użyciu witryny Azure Portal i ról platformy Azure, rólfirmy Microsoft Entra i klasycznego administratora subskrypcji.
Konto usługi GitHub	Zarejestruj się bezpłatnie.
git	Instalowanie narzędzia git
Interfejs wiersza polecenia platformy Azure	Zainstaluj interfejs wiersza polecenia platformy Azure.

Wymaganie	Instrukcje
Konto platformy Azure	Jeśli go nie masz, utwórz bezpłatne konto. Aby kontynuować, musisz mieć uprawnienie Współautor lub Właściciel w subskrypcji platformy Azure. Aby uzyskać szczegółowe informacje, zobacz Przypisywanie ról platformy Azure przy użyciu witryny Azure Portal .
Konto usługi GitHub	Zarejestruj się bezpłatnie.
git	Instalowanie narzędzia git
Interfejs wiersza polecenia platformy Azure	Zainstaluj interfejs wiersza polecenia platformy Azure.
Docker Desktop	Platforma Docker udostępnia instalatory, które konfigurują środowisko platformy Docker w systemach macOS, Windows i Linux. W wierszu polecenia wpisz , docker aby upewnić się, że platforma Docker jest uruchomiona.

Ustawienia

Aby zalogować się do platformy Azure z poziomu interfejsu wiersza polecenia, uruchom następujące polecenie i postępuj zgodnie z monitami, aby ukończyć proces uwierzytelniania.

Bash

az login

Azure PowerShell

Connect-AzAccount

Aby upewnić się, że używasz najnowszej wersji interfejsu wiersza polecenia, uruchom polecenie uaktualniania.

Bash

az upgrade

Azure PowerShell

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

Ignoruj wszelkie ostrzeżenia dotyczące aktualnie używanych modułów.

Następnie zainstaluj lub zaktualizuj rozszerzenie usługi Azure Container Apps dla interfejsu wiersza polecenia.

Jeśli podczas uruchamiania az containerapp poleceń w interfejsie wiersza polecenia platformy Azure lub poleceniach cmdlet z modułu Az.App w programie Azure PowerShell wystąpią błędy dotyczące brakujących parametrów, upewnij się, że masz zainstalowaną najnowszą wersję rozszerzenia Azure Container Apps.

Bash

az extension add --name containerapp --upgrade

Uwaga

Począwszy od maja 2024 r., rozszerzenia interfejsu wiersza polecenia platformy Azure domyślnie nie włączają funkcji w wersji zapoznawczej. Aby uzyskać dostęp do funkcji usługi Container Apps w wersji zapoznawczej, zainstaluj rozszerzenie Container Apps za pomocą polecenia --allow-preview true.

az extension add --name containerapp --upgrade --allow-preview true

Azure PowerShell

Install-Module -Name Az.App

Pamiętaj, aby zaktualizować Az.App moduł do najnowszej wersji.

Update-Module -Name Az.App

Teraz, po zainstalowaniu bieżącego rozszerzenia lub modułu Microsoft.App , zarejestruj przestrzenie nazw i Microsoft.OperationalInsights .

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

Tworzenie zmiennych środowiskowych

Teraz, gdy konfiguracja interfejsu wiersza polecenia platformy Azure została ukończona, możesz zdefiniować zmienne środowiskowe używane w tym artykule.

Bash

Zdefiniuj następujące zmienne w powłoce powłoki bash.

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

Przed uruchomieniem tego polecenia pamiętaj, aby zastąpić <YOUR_GITHUB_USERNAME> ciąg nazwą użytkownika usługi GitHub.

Następnie zdefiniuj unikatową nazwę rejestru kontenerów.

ACR_NAME="acaalbums"$GITHUB_USERNAME

Azure PowerShell

Zdefiniuj następujące zmienne w konsoli programu PowerShell.

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

Przed uruchomieniem tego polecenia pamiętaj, aby zastąpić <YOUR_GITHUB_USERNAME> ciąg nazwą użytkownika usługi GitHub.

Następnie zdefiniuj unikatową nazwę rejestru kontenerów.

$ACRName = "acaalbums"+$GITHUB_USERNAME

Przygotowywanie repozytorium GitHub

Przejdź do repozytorium dla preferowanego języka i rozwidlenia repozytorium.

C#

Wybierz przycisk Rozwidlenie u góry repozytorium interfejsu API albumu, aby rozwidlić repozytorium na koncie.

Teraz możesz sklonować rozwidlenie przykładowego repozytorium.

Użyj następującego polecenia git, aby sklonować rozwidlenie repozytorium do folderu code-to-cloud :

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

Przejdź

Wybierz przycisk Rozwidlenie u góry repozytorium interfejsu API albumu, aby rozwidlić repozytorium na koncie.

Teraz możesz sklonować rozwidlenie przykładowego repozytorium.

Użyj następującego polecenia git, aby sklonować rozwidlenie repozytorium do folderu code-to-cloud :

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

Java

Wybierz przycisk Rozwidlenie u góry repozytorium interfejsu API albumu, aby rozwidlić repozytorium na koncie.

Teraz możesz sklonować rozwidlenie przykładowego repozytorium.

Użyj następującego polecenia git, aby sklonować rozwidlenie repozytorium do folderu code-to-cloud :

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

Uwaga

Przykład języka Java obsługuje tylko kompilację narzędzia Maven, która powoduje utworzenie wykonywalnego pliku JAR. Kompilacja używa ustawień domyślnych, ponieważ przekazywanie zmiennych środowiskowych nie jest obsługiwane.

JavaScript

Wybierz przycisk Rozwidlenie u góry repozytorium interfejsu API albumu, aby rozwidlić repozytorium na koncie.

Teraz możesz sklonować rozwidlenie przykładowego repozytorium.

Użyj następującego polecenia git, aby sklonować rozwidlenie repozytorium do folderu code-to-cloud :

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

Python

Wybierz przycisk Rozwidlenie u góry repozytorium interfejsu API albumu, aby rozwidlić repozytorium na koncie.

Teraz możesz sklonować rozwidlenie przykładowego repozytorium.

Użyj następującego polecenia git, aby sklonować rozwidlenie repozytorium do folderu code-to-cloud :

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

Następnie zmień katalog na katalog główny sklonowanego repozytorium.

cd code-to-cloud/src

Tworzenie grupy zasobów platformy Azure

Utwórz grupę zasobów, aby zorganizować usługi związane z wdrożeniem aplikacji kontenera.

Bash

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

Azure PowerShell

New-AzResourceGroup -Location $Location -Name $ResourceGroupName

Tworzenie rejestru Azure Container Registry

Po utworzeniu obrazu kontenera interfejsu API albumu utwórz wystąpienie usługi Azure Container Registry (ACR) w grupie zasobów, aby je przechowywać.

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

Kompilowanie aplikacji

Za pomocą zadań usługi ACR można kompilować i wypychać obraz platformy Docker dla interfejsu API albumu bez lokalnego instalowania platformy Docker.

Tworzenie kontenera za pomocą usługi ACR

Uruchom następujące polecenie, aby zainicjować proces kompilacji i wypychania obrazu przy użyciu usługi ACR. Na . końcu polecenia reprezentuje kontekst kompilacji platformy Docker, co oznacza, że to polecenie powinno być uruchamiane w folderze src , w którym znajduje się plik Dockerfile.

Bash

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

Azure PowerShell

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

Dane wyjściowe z az acr build polecenia pokazują postęp przekazywania kodu źródłowego na platformę Azure oraz szczegóły docker build operacji i docker push .

Kompilowanie aplikacji

W poniższych krokach pokazano, jak utworzyć obraz kontenera lokalnie przy użyciu platformy Docker i wypchnąć obraz do nowego rejestru kontenerów.

Kompilowanie kontenera przy użyciu platformy Docker

Następujące polecenie tworzy obraz kontenera dla interfejsu API albumu i taguje go przy użyciu w pełni kwalifikowanej nazwy serwera logowania usługi ACR. Na . końcu polecenia reprezentuje kontekst kompilacji platformy Docker, co oznacza, że to polecenie powinno być uruchamiane w folderze src , w którym znajduje się plik Dockerfile.

Bash

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

Azure PowerShell

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

Wypychanie obrazu do rejestru kontenerów

Najpierw zaloguj się do usługi Azure Container Registry.

Bash

az acr login --name $ACR_NAME

Azure PowerShell

az acr login --name $ACRName

Teraz wypchnij obraz do rejestru.

Bash

docker push $ACR_NAME.azurecr.io/$API_NAME

Azure PowerShell

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

Tworzenie środowiska usługi Container Apps

Środowisko usługi Azure Container Apps działa jako bezpieczna granica wokół grupy aplikacji kontenera.

Utwórz środowisko Container Apps przy użyciu następującego polecenia.

Bash

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

Azure PowerShell

Obszar roboczy usługi Log Analytics jest wymagany dla środowiska Usługi Container Apps. Następujące polecenia umożliwiają utworzenie obszaru roboczego usługi Log Analytics i zapisanie identyfikatora obszaru roboczego oraz podstawowego klucza współużytkowanego do zmiennych.

$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

Aby utworzyć środowisko, uruchom następujące polecenie:

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

New-AzContainerAppManagedEnv @EnvArgs

Wdrażanie obrazu w aplikacji kontenera

Po utworzeniu środowiska możesz utworzyć i wdrożyć aplikację kontenera za az containerapp create pomocą polecenia .

Utwórz i wdróż aplikację kontenera za pomocą następującego polecenia.

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

• Ustawiając wartość --ingress external, aplikacja kontenera jest dostępna z publicznego Internetu.

• Parametr target-port ma 8080 być zgodny z portem, na który kontener nasłuchuje żądań.

• query Bez właściwości wywołanie metody az containerapp create zwraca odpowiedź JSON zawierającą bogaty zestaw szczegółów dotyczących aplikacji. Dodanie parametru zapytania filtruje dane wyjściowe tylko do w pełni kwalifikowanej nazwy domeny aplikacji (FQDN).

Azure PowerShell

Aby utworzyć aplikację kontenera, utwórz obiekty szablonu przekazywane jako argumenty do New-AzContainerApp polecenia .

Utwórz obiekt szablonu, aby zdefiniować parametry obrazu kontenera.

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

Uruchom następujące polecenie, aby uzyskać poświadczenia rejestru.

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

Utwórz obiekt poświadczeń rejestru, aby zdefiniować informacje o rejestrze i obiekt tajny w celu zdefiniowania hasła rejestru. Obiekt PasswordSecretRef odwołuje się do Name obiektu wpisów tajnych.

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

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

Pobierz identyfikator środowiska.

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

Utwórz aplikację kontenera.

$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

• Ustawiając wartość IngressExternal external, aplikacja kontenera jest dostępna z publicznego Internetu.
• Parametr IngressTargetPort jest ustawiony tak, aby 8080 był zgodny z portem, na który kontener nasłuchuje żądań.

Weryfikowanie wdrożenia

Skopiuj nazwę FQDN do przeglądarki internetowej. W przeglądarce internetowej przejdź do /albums punktu końcowego nazwy FQDN.

Czyszczenie zasobów

Jeśli nie zamierzasz kontynuować pracy z samouczkiem Dotyczącym komunikacji między mikrousługami, możesz usunąć zasoby platformy Azure utworzone podczas tego przewodnika Szybki start. Uruchom następujące polecenie, aby usunąć grupę zasobów wraz ze wszystkimi zasobami utworzonymi w tym przewodniku Szybki start.

Bash

az group delete --name $RESOURCE_GROUP

Azure PowerShell

Remove-AzResourceGroup -Name $ResourceGroup -Force

Napiwek

Masz problemy? Poinformuj nas o usłudze GitHub, otwierając problem w repozytorium usługi Azure Container Apps.

Następne kroki

Ten przewodnik Szybki start to punkt wejścia zestawu progresywnych samouczków, które przedstawiają różne funkcje w usłudze Azure Container Apps. Kontynuuj, aby dowiedzieć się, jak włączyć komunikację z frontonu internetowego, który wywołuje interfejs API wdrożony w tym artykule.

Samouczek: komunikacja między mikrousługami