Fornecer uma rede virtual para um ambiente externo de Aplicativos de Contêiner do Azure

O exemplo a seguir mostra como criar um ambiente de Aplicativos de Contêiner em uma rede virtual existente.

Para começar, entre no portal do Azure.

Criar um aplicativo de contêiner

Para criar o aplicativo de contêiner, comece na home page do portal do Azure.

1. Pesquise por Aplicativos de Contêiner na barra de pesquisa superior.
2. Selecione Aplicativos de Contêiner nos resultados da pesquisa.
3. Selecione o botão Criar.

Guia Básico

Na guia Básico, execute as ações a seguir.

1. Insira os valores a seguir na seção Detalhes do projeto.

   Configuração	Ação
   Subscription	Selecione sua assinatura do Azure.
   Resource group	Selecione Criar e insira my-container-apps.
   Nome do aplicativo de contêiner	Insira my-container-app.
   Fonte de implantação	Selecione Imagem do contêiner.

Criar um ambiente

Em seguida, crie um ambiente para seu aplicativo de contêiner.

1. Selecione a região apropriada.

   Configuração	Valor
   Região	Selecione EUA Central.

2. No campo Criar ambiente de Aplicativos de Contêiner, selecione o link Criar novo.

3. Na página Criar Ambiente de Aplicativos de Contêiner, na guia Noções Básicas, insira os seguintes valores:

   Configuração	Valor
   Nome do ambiente	Insira my-environment.
   Tipo de ambiente	Selecione Perfis de carga de trabalho.
   Redundância de zona	Selecione Desabilitado

4. Selecione a guia Monitoramento para criar um workspace do Log Analytics.

5. Selecione Azure Log Analytics como o Destino de Logs.

6. Selecione o link Criar novo no campo Workspace do Log Analytics e insira os valores a seguir.

   Configuração	Valor
   Nome	Insira my-container-apps-logs.

   O campo Local é preenchido previamente com EUA Central para você.

7. Selecione OK.

Observação

Você pode usar uma rede virtual existente, mas é necessária uma sub-rede dedicada com um intervalo CIDR /23 ou maior para uso com Aplicativos de Contêiner do Azure ao usar a arquitetura somente de Consumo. Ao usar um ambiente de perfis de carga de trabalho, é necessário um /27 ou maior. Para saber mais sobre o dimensionamento de sub-rede, consulte a visão geral da arquitetura de rede.

7. Selecione a guia Rede para criar uma VNET.

8. Selecione Sim ao lado de Usar sua própria rede virtual.

9. Ao lado da caixa Rede virtual, selecione o link Criar novo e insira o valor a seguir.

   Configuração	Valor
   Nome	Insira my-custom-vnet.

10. Selecione o botão OK.

11. Ao lado da caixa Sub-rede de infraestrutura, selecione o link Criar novo e insira os seguintes valores:

    Configuração	Valor
    Nome da sub-rede	Insira infrastructure-subnet.
    Bloco de endereço da VNET	Mantenha os valores padrão.
    Bloco de endereço da sub-rede	Mantenha os valores padrão.

12. Selecione o botão OK.

13. Em IP Virtual, selecione Externo.

14. Selecione Criar.

Implantar o aplicativo de contêiner

1. Selecione Examinar e criar na parte inferior da página.

   Se nenhum erro for encontrado, o botão Criar será habilitado.

   Se houver erros, qualquer guia que contiver erros será marcada com um ponto vermelho. Navegue até a guia apropriada. Os campos que contêm um erro são realçados em vermelho. Depois que todos os erros forem corrigidos, selecione Revisar e criar novamente.

2. Selecione Criar.

   Uma página com a mensagem A implantação está em andamento é exibida. Depois que a implantação for concluída com êxito, você verá a mensagem: Sua implantação foi concluída.

Pré-requisitos

• Conta do Azure com uma assinatura ativa.
  • Se não tiver uma, poderá criá-la gratuitamente.
• Instale a CLI do Azure versão 2.28.0 ou posterior.

Instalação

Para entrar no Azure usando a CLIl, execute o comando a seguir e siga os prompts para concluir o processo de autenticação.

Bash

az login

PowerShell do Azure

Connect-AzAccount

Para garantir que você esteja executando a versão mais recente da CLI, execute o comando “upgrade”.

Bash

az upgrade

PowerShell do Azure

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

Ignore quaisquer avisos sobre módulos em uso no momento.

Em seguida, instale ou atualize a extensão dos Aplicativos de Contêiner do Azure para a CLI.

Se você receber erros sobre parâmetros ausentes ao executar comandos az containerapp na CLI do Azure ou cmdlets do módulo Az.App no Azure PowerShell, verifique se está com a versão mais recente da extensão Aplicativos de Contêiner do Azure instalada.

Bash

az extension add --name containerapp --upgrade

Observação

A partir de maio de 2024, as extensões da CLI do Azure já não permitem funcionalidades de versão prévia do recurso por padrão. Para acessar as versões prévias dos recursos dos Aplicativos de Contêiner, instale a extensão Aplicativos de Contêiner com --allow-preview true.

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

PowerShell do Azure

Install-Module -Name Az.App

Atualize o módulo Az.App para a versão mais recente.

Update-Module -Name Az.App

Agora que a extensão ou módulo atual está instalado, registre os namespaces Microsoft.App e Microsoft.OperationalInsights.

Bash

az provider register --namespace Microsoft.App

az provider register --namespace Microsoft.OperationalInsights

PowerShell do Azure

Register-AzResourceProvider -ProviderNamespace Microsoft.App

Register-AzResourceProvider -ProviderNamespace Microsoft.OperationalInsights

Definir variáveis de ambiente

Defina as variáveis de ambiente a seguir. Substitua o <PLACEHOLDERS> por seus valores:

Bash

RESOURCE_GROUP="<RESOURCE_GROUP>"
LOCATION="<LOCATION>"
CONTAINERAPPS_ENVIRONMENT="<CONTAINERAPPS_ENVIRONMENT>"

PowerShell do Azure

$ResourceGroupName = '<RESOURCE_GROUP>'
$Location = '<LOCATION>'
$ContainerAppsEnvironment = '<CONTAINERAPPS_ENVIRONMENT>'

Criar um grupo de recursos do Azure

Crie um grupo de recursos para organizar os serviços relacionados à implantação do aplicativo de contêiner.

Bash

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

PowerShell do Azure

New-AzResourceGroup -Location $Location -Name $ResourceGroupName

Criar um ambiente

Um ambiente em aplicativos de contêiner do Azure cria um limite seguro em um grupo de aplicativos de contêiner. Os Aplicativos de Contêiner implantados no mesmo ambiente são implantados na mesma rede virtual e gravam logs no mesmo workspace do Log Analytics.

Registre o provedor Microsoft.ContainerService.

Bash

az provider register --namespace Microsoft.ContainerService

PowerShell do Azure

Register-AzResourceProvider -ProviderNamespace Microsoft.ContainerService

Declare uma variável para conter o nome da VNET.

Bash

VNET_NAME="my-custom-vnet"

PowerShell do Azure

$VnetName = 'my-custom-vnet'

Agora, crie uma rede virtual do Azure para associar ao ambiente de Aplicativos de Contêiner. A rede virtual deve ter uma sub-rede disponível para a implantação do ambiente.

Observação

O prefixo de endereço de sub-rede de rede requer um intervalo CIDR mínimo de /23 para uso com Aplicativos de Contêiner do Azure ao usar a arquitetura somente de Consumo. Ao usar a Arquitetura de Perfis de Carga de Trabalho, é necessário um /27 ou maior. Para saber mais sobre o dimensionamento de sub-rede, consulte a visão geral da arquitetura de rede.

Bash

az network vnet create \
  --resource-group $RESOURCE_GROUP \
  --name $VNET_NAME \
  --location $LOCATION \
  --address-prefix 10.0.0.0/16

az network vnet subnet create \
  --resource-group $RESOURCE_GROUP \
  --vnet-name $VNET_NAME \
  --name infrastructure-subnet \
  --address-prefixes 10.0.0.0/21

PowerShell do Azure

$SubnetArgs = @{
    Name = 'infrastructure-subnet'
    AddressPrefix = '10.0.0.0/21'
}
$subnet = New-AzVirtualNetworkSubnetConfig @SubnetArgs

$VnetArgs = @{
    Name = $VnetName
    Location = $Location
    ResourceGroupName = $ResourceGroupName
    AddressPrefix = '10.0.0.0/16'
    Subnet = $subnet
}
$vnet = New-AzVirtualNetwork @VnetArgs

Ao usar o ambiente de perfis de carga de trabalho, você precisa atualizar a VNET para delegar a sub-rede para Microsoft.App/environments. Essa delegação não é aplicável ao ambiente somente de consumo.

Bash

az network vnet subnet update \
  --resource-group $RESOURCE_GROUP \
  --vnet-name $VNET_NAME \
  --name infrastructure-subnet \
  --delegations Microsoft.App/environments

PowerShell do Azure

$delegation = New-AzDelegation -Name 'containerApp' -ServiceName 'Microsoft.App/environments'
$vnet = Set-AzVirtualNetworkSubnetConfig -Name $SubnetArgs.Name -VirtualNetwork $vnet -AddressPrefix $SubnetArgs.AddressPrefix -Delegation $delegation
$vnet | Set-AzVirtualNetwork

Com a rede virtual criada, você pode recuperar a ID da sub-rede de infraestrutura.

Bash

INFRASTRUCTURE_SUBNET=`az network vnet subnet show --resource-group ${RESOURCE_GROUP} --vnet-name $VNET_NAME --name infrastructure-subnet --query "id" -o tsv | tr -d '[:space:]'`

PowerShell do Azure

$InfrastructureSubnet=(Get-AzVirtualNetworkSubnetConfig -Name $SubnetArgs.Name -VirtualNetwork $vnet).Id

Por fim, crie o ambiente de Aplicativos de Contêiner usando a VNET personalizada implantada nas etapas anteriores.

Bash

az containerapp env create \
  --name $CONTAINERAPPS_ENVIRONMENT \
  --resource-group $RESOURCE_GROUP \
  --location "$LOCATION" \
  --infrastructure-subnet-resource-id $INFRASTRUCTURE_SUBNET

A tabela a seguir descreve os parâmetros usados em containerapp env create.

Parâmetro	Descrição
name	Nome do ambiente de Aplicativos de Contêiner.
resource-group	Nome do grupo de recursos.
location	O local do Azure em que o ambiente deve ser implantado.
infrastructure-subnet-resource-id	ID de recurso de uma sub-rede para componentes de infraestrutura e contêineres de aplicativo de usuário.

PowerShell do Azure

Um workspace do Log Analytics é necessário para o ambiente de Aplicativos de Contêiner. Os comandos a seguir criam um workspace do Log Analytics e salvam a ID do workspace e a chave compartilhada primária em variáveis de ambiente.

$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

Para criar o ambiente, execute o seguinte comando:

$EnvArgs = @{
    EnvName = $ContainerAppsEnvironment
    ResourceGroupName = $ResourceGroupName
    Location = $Location
    AppLogConfigurationDestination = "log-analytics"
    LogAnalyticConfigurationCustomerId = $WorkspaceId
    LogAnalyticConfigurationSharedKey = $WorkspaceSharedKey
    VnetConfigurationInfrastructureSubnetId = $InfrastructureSubnet
    VnetConfigurationInternal = $true
}
New-AzContainerAppManagedEnv @EnvArgs

A tabela a seguir descreve os parâmetros usados para New-AzContainerAppManagedEnv.

Parâmetro	Descrição
EnvName	Nome do ambiente de Aplicativos de Contêiner.
ResourceGroupName	Nome do grupo de recursos.
LogAnalyticConfigurationCustomerId	ID de recurso para um workspace do Log Analytics existente.
LogAnalyticConfigurationSharedKey	O segredo do cliente do Log Analytics.
Location	O local do Azure em que o ambiente deve ser implantado.
VnetConfigurationInfrastructureSubnetId	ID de recurso de uma sub-rede para componentes de infraestrutura e contêineres de aplicativo de usuário.

Com o ambiente criado usando uma rede virtual personalizada, você pode agora implantar aplicativos de contêiner no ambiente.

Configuração opcional

Você tem a opção de implantar um DNS privado e definir intervalos de IP de rede personalizados para seu ambiente de Aplicativos de Contêiner.

Implantar com um DNS privado

Se você quiser implantar seu aplicativo de contêiner com um DNS privado, execute os comandos a seguir.

Primeiro, extraia informações de identificação do ambiente.

Bash

ENVIRONMENT_DEFAULT_DOMAIN=`az containerapp env show --name ${CONTAINERAPPS_ENVIRONMENT} --resource-group ${RESOURCE_GROUP} --query properties.defaultDomain --out json | tr -d '"'`

ENVIRONMENT_STATIC_IP=`az containerapp env show --name ${CONTAINERAPPS_ENVIRONMENT} --resource-group ${RESOURCE_GROUP} --query properties.staticIp --out json | tr -d '"'`

VNET_ID=`az network vnet show --resource-group ${RESOURCE_GROUP} --name ${VNET_NAME} --query id --out json | tr -d '"'`

PowerShell do Azure

$EnvironmentDefaultDomain = (Get-AzContainerAppManagedEnv -EnvName $ContainerAppsEnvironment -ResourceGroupName $ResourceGroupName).DefaultDomain

$EnvironmentStaticIp = (Get-AzContainerAppManagedEnv -EnvName $ContainerAppsEnvironment -ResourceGroupName $ResourceGroupName).StaticIp

Em seguida, configure o DNS privado.

Bash

az network private-dns zone create \
  --resource-group $RESOURCE_GROUP \
  --name $ENVIRONMENT_DEFAULT_DOMAIN

az network private-dns link vnet create \
  --resource-group $RESOURCE_GROUP \
  --name $VNET_NAME \
  --virtual-network $VNET_ID \
  --zone-name $ENVIRONMENT_DEFAULT_DOMAIN -e true

az network private-dns record-set a add-record \
  --resource-group $RESOURCE_GROUP \
  --record-set-name "*" \
  --ipv4-address $ENVIRONMENT_STATIC_IP \
  --zone-name $ENVIRONMENT_DEFAULT_DOMAIN

PowerShell do Azure

New-AzPrivateDnsZone -ResourceGroupName $ResourceGroupName -Name $EnvironmentDefaultDomain

New-AzPrivateDnsVirtualNetworkLink -ResourceGroupName $ResourceGroupName -Name $VnetName -VirtualNetwork $Vnet -ZoneName $EnvironmentDefaultDomain -EnableRegistration

$DnsRecords = @()
$DnsRecords += New-AzPrivateDnsRecordConfig -Ipv4Address $EnvironmentStaticIp

$DnsRecordArgs = @{
    ResourceGroupName = $ResourceGroupName
    ZoneName = $EnvironmentDefaultDomain
    Name = '*'
    RecordType = 'A'
    Ttl = 3600
    PrivateDnsRecords = $DnsRecords
}
New-AzPrivateDnsRecordSet @DnsRecordArgs

Parâmetros de rede

Há três parâmetros de rede opcionais que você pode optar por definir ao chamar containerapp env create. Use essas opções quando você tiver uma VNET emparelhada com intervalos de endereços separados. Configurar explicitamente esses intervalos garante que os endereços usados pelo ambiente de Aplicativos de Contêiner não entrem em conflito com outros intervalos na infraestrutura de rede.

Você deve fornecer valores para todas as três propriedades ou para nenhuma delas. Se eles não forem fornecidos, os valores serão gerados para você.

Bash

Parâmetro	Descrição
platform-reserved-cidr	O intervalo de endereços usado internamente para serviços de infraestrutura do ambiente. Deve ter um tamanho entre /23 e /12 ao usar a arquitetura Somente Consumo
platform-reserved-dns-ip	Um endereço IP do intervalo platform-reserved-cidr usado para o servidor DNS interno. O endereço não pode ser o primeiro endereço no intervalo nem o endereço da rede. Por exemplo, se platform-reserved-cidr for definido como 10.2.0.0/16, platform-reserved-dns-ip não poderá ser 10.2.0.0 (o endereço da rede) nem 10.2.0.1 (a infraestrutura reserva o uso desse IP). Nesse caso, o primeiro IP utilizável para o DNS seria 10.2.0.2.
docker-bridge-cidr	O intervalo de endereços atribuído à rede de ponte do Docker. Esse intervalo deve ter um tamanho entre /28 e /12.

• Os intervalos de endereços platform-reserved-cidr e docker-bridge-cidr não podem entrar em conflito entre si nem com os intervalos de qualquer sub-rede fornecida. Além disso, esses intervalos não devem entrem em conflito com nenhum outro intervalo de endereços da VNET.

• Se essas propriedades não forem fornecidas, a CLI gerará automaticamente os valores de intervalo com base no intervalo de endereços da VNET para evitar conflitos de intervalo.

PowerShell do Azure

Parâmetro	Descrição
VnetConfigurationPlatformReservedCidr	O intervalo de endereços usado internamente para serviços de infraestrutura do ambiente. Deve ter um tamanho entre /23 e /12 ao usar a arquitetura Somente Consumo
VnetConfigurationPlatformReservedDnsIP	Um endereço IP do intervalo VnetConfigurationPlatformReservedCidr usado para o servidor DNS interno. O endereço não pode ser o primeiro endereço no intervalo nem o endereço da rede. Por exemplo, se VnetConfigurationPlatformReservedCidr for definido como 10.2.0.0/16, VnetConfigurationPlatformReservedDnsIP não poderá ser 10.2.0.0 (o endereço da rede) nem 10.2.0.1 (a infraestrutura reserva o uso desse IP). Nesse caso, o primeiro IP utilizável para o DNS seria 10.2.0.2.
VnetConfigurationDockerBridgeCidr	O intervalo de endereços atribuído à rede de ponte do Docker. Esse intervalo deve ter um tamanho entre /28 e /12.

• Os intervalos de endereços VnetConfigurationPlatformReservedCidr e VnetConfigurationDockerBridgeCidr não podem entrar em conflito entre si nem com os intervalos de qualquer sub-rede fornecida. Além disso, esses intervalos não devem entrem em conflito com nenhum outro intervalo de endereços da VNET.

• Se essas propriedades não forem fornecidas, os valores de intervalo serão gerados automaticamente com base no intervalo de endereços da VNET para evitar conflitos de intervalo.

Limpar os recursos

Se você não continuar usando esse aplicativo, poderá remover o grupo de recursos my-container-apps. Isso elimina a instância Aplicativos de Contêiner do Azure e todos os serviços associados. Também elimina o grupo de recursos que o serviço Aplicativos de Contêiner do Azure criou automaticamente e que contém os componentes de rede personalizados.

Cuidado

O comando a seguir exclui o grupo de recursos especificado e todos os recursos contidos nele. Se existirem recursos fora do escopo deste guia no grupo de recursos especificado, eles também serão excluídos.

Bash

az group delete --name $RESOURCE_GROUP

PowerShell do Azure

Remove-AzResourceGroup -Name $ResourceGroupName -Force

Próximas etapas

Gerenciando o comportamento de dimensionamento automático