Руководство. Развертывание первого приложения-контейнера

С помощью службы "Контейнеры приложений Azure" можно запускать микрослужбы и контейнерные приложения на бессерверной платформе. Благодаря Контейнерам приложений Azure вы можете пользоваться преимуществами выполнения контейнеров, не заботясь о настройке облачной инфраструктуры вручную и сложных оркестраторах контейнеров.

В этом руководстве вы создадите безопасную среду контейнеров приложений и развернете свое первое приложение-контейнер.

Примечание

Вы также можете развернуть это приложение с помощью команды az containerapp up , следуя инструкциям в статье Краткое руководство. Развертывание первого приложения-контейнера с помощью containerapp up . Команда az containerapp up — это быстрый и удобный способ сборки и развертывания приложения в контейнерах приложений Azure с помощью одной команды. Однако он не обеспечивает тот же уровень настройки для приложения-контейнера.

Предварительные требования

• Учетная запись Azure с активной подпиской.
  • Если у вас ее нет, вы можете создать ее бесплатно.
• Установка Azure CLI.

Настройка

Для начала войдите в Azure. Выполните приведенную ниже команду и следуйте инструкциям на экране, чтобы пройти процесс проверки подлинности.

Bash

az login

Azure PowerShell

Connect-AzAccount

Bash

Затем установите расширение Контейнеров приложений Azure для CLI.

az extension add --name containerapp --upgrade

Azure PowerShell

Необходимо установить последнюю версию модуля Az. Игнорируйте все предупреждения о модулях, используемых в настоящее время.

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

Теперь установите модуль Az.App.

Install-Module -Name Az.App

Теперь, когда текущее расширение или модуль установлено, зарегистрируйте Microsoft.App пространство имен.

Примечание

Ресурсы Контейнеров приложений Azure перенесены из пространства имен Microsoft.Web в пространство имен Microsoft.App. Дополнительные сведения см. в статье Миграция пространства имен из Microsoft.Web в Microsoft.App в марте 2022 года.

Bash

az provider register --namespace Microsoft.App

Azure PowerShell

Register-AzResourceProvider -ProviderNamespace Microsoft.App

Microsoft.OperationalInsights Зарегистрируйте поставщика для рабочей области Azure Monitor Log Analytics, если вы не использовали его ранее.

Bash

az provider register --namespace Microsoft.OperationalInsights

Azure PowerShell

Register-AzResourceProvider -ProviderNamespace Microsoft.OperationalInsights

Затем установите указанные ниже переменные среды.

Bash

RESOURCE_GROUP="my-container-apps"
LOCATION="canadacentral"
CONTAINERAPPS_ENVIRONMENT="my-environment"

Azure PowerShell

$ResourceGroupName = 'my-container-apps'
$Location = 'canadacentral'
$ContainerAppsEnvironment = 'my-environment'

Задав эти переменные, можно создать группу ресурсов для организации служб, связанных с новым приложением-контейнером.

Bash

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

Azure PowerShell

New-AzResourceGroup -Location $Location -Name $ResourceGroupName

Обновив интерфейс командной строки и сделав доступной новую группу ресурсов, можно создать среду Container Apps и развернуть приложение-контейнер.

Создание среды

Среда в Azure Container Apps создает безопасную границу вокруг группы приложений-контейнеров. Развертываемые в одной среде приложения-контейнеры развертываются в одной виртуальной сети и записывают журналы в одну рабочую область Log Analytics.

Bash

Чтобы создать среду, выполните следующую команду:

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

Azure PowerShell

Рабочая область Log Analytics требуется для среды контейнеров приложений. Следующие команды создают рабочую область Log Analytics и сохраняют идентификатор рабочей области и первичный общий ключ в переменных.

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

Чтобы создать среду, выполните следующую команду:

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

New-AzContainerAppManagedEnv @EnvArgs

Создание приложения-контейнера

Создав среду, вы можете развернуть первое приложение-контейнер. Используя команду containerapp create, разверните образ контейнера в Контейнерах приложений Azure.

Bash

az containerapp create \
  --name my-container-app \
  --resource-group $RESOURCE_GROUP \
  --environment $CONTAINERAPPS_ENVIRONMENT \
  --image mcr.microsoft.com/k8se/quickstart:latest \
  --target-port 80 \
  --ingress 'external' \
  --query properties.configuration.ingress.fqdn

Примечание

Убедитесь, что значение параметра --image имеет нижний регистр.

Если установить для --ingress значение external, приложение-контейнер будет поддерживать общедоступные запросы.

Azure PowerShell

$ImageParams = @{
    Name = 'my-container-app'
    Image = 'mcr.microsoft.com/k8se/quickstart:latest'
}
$TemplateObj = New-AzContainerAppTemplateObject @ImageParams
$EnvId = (Get-AzContainerAppManagedEnv -EnvName $ContainerAppsEnvironment -ResourceGroupName $ResourceGroupName).Id

$AppArgs = @{
    Name = 'my-container-app'
    Location = $Location
    ResourceGroupName = $ResourceGroupName
    ManagedEnvironmentId = $EnvId
    IdentityType = 'SystemAssigned'
    TemplateContainer = $TemplateObj
    IngressTargetPort = 80
    IngressExternal = $true

}
New-AzContainerApp @AppArgs

Примечание

Убедитесь, что значение параметра Image имеет нижний регистр.

Если установить для IngressExternal значение $true, приложение-контейнер будет поддерживать общедоступные запросы.

Проверка развертывания

Bash

Команда create возвращает полное доменное имя для приложения-контейнера. Скопируйте это расположение в веб-браузер.

Azure PowerShell

Получите полное доменное имя для приложения-контейнера.

(Get-AzContainerApp -Name $AppArgs.Name -ResourceGroupName $ResourceGroupName).IngressFqdn

Скопируйте это расположение в веб-браузер.

При развертывании приложения-контейнера отображается следующее сообщение:

Очистка ресурсов

Если вы не собираетесь продолжать использовать это приложение, выполните следующую команду, чтобы удалить группу ресурсов вместе со всеми ресурсами, созданными в этом руководстве.

Внимание!

Следующая команда удаляет указанную группу ресурсов и все содержащиеся в ней ресурсы. Если в указанной группе ресурсов существуют другие ресурсы, кроме созданных для работы с этим учебником, они также будут удалены.

Bash

az group delete --name $RESOURCE_GROUP

Azure PowerShell

Remove-AzResourceGroup -Name $ResourceGroupName -Force

Совет

Возникли проблемы? Сообщите о них в репозитории Azure Container Apps на GitHub.

Следующие шаги

Взаимодействие между микрослужбами