Tutorial: dimensionar um aplicativo de contêiner

Os Aplicativos de Contêiner do Azure gerenciam a colocação em escala horizontal automático por meio de um conjunto de regras de colocação em escala declarativo. À medida que um aplicativo de contêiner é escalado, novas instâncias do aplicativo de contêiner são criadas sob demanda. Essas instâncias são conhecidas como réplicas.

Neste tutorial, você adiciona uma regra de escala HTTP ao seu aplicativo de contêiner e observa como seu aplicativo é dimensionado.

Pré-requisitos

Requisito	Instruções
Conta do Azure	Se você ainda não tiver uma conta do Azure, poderá criar uma conta gratuitamente. Você precisa da permissão de Colaborador na assinatura do Azure para continuar. Consulte Atribuir funções do Azure usando o portal do Azure para obter detalhes.
Conta do GitHub	Obtenha uma gratuitamente.
CLI do Azure	Instale a CLI do Azure.

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

Criar e implantar o aplicativo de contêiner

Crie e implante seu aplicativo de contêiner com o comando containerapp up. Este comando cria um:

• Grupo de recursos
• Ambiente de Aplicativos de Contêiner
• Espaço de Trabalho do Log Analytics

Se algum desses recursos já existir, o comando usará os recursos existentes em vez de criar novos.

Por fim, o comando cria e implanta o aplicativo de contêiner usando uma imagem de contêiner público.

Bash

az containerapp up \
  --name my-container-app \
  --resource-group my-container-apps \
  --location centralus \
  --environment 'my-container-apps' \
  --image mcr.microsoft.com/k8se/quickstart:latest \
  --target-port 8080 \
  --ingress external \
  --query properties.configuration.ingress.fqdn \

PowerShell do Azure

az containerapp up `
  --name my-container-app `
  --resource-group my-container-apps `
  --location centralus `
  --environment my-container-apps `
  --image mcr.microsoft.com/k8se/quickstart:latest `
  --target-port 8080 `
  --ingress external `
  --query properties.configuration.ingress.fqdn `

Observação

Certifique-se de que o valor do parâmetro --image está em menor caso.

Ao definir --ingress como external, você torna as solicitações públicas disponíveis do aplicativo de contêiner.

O comando up retorna o FQDN (nome de domínio totalmente qualificado) do aplicativo de contêiner. Copie este FQDN para um arquivo de texto. Você o usará na seção Enviar solicitações. Seu FQDN se parece com o exemplo a seguir:

https://my-container-app.icydune-96848328.centralus.azurecontainerapps.io

Adicionar regra de escala

Adicione uma regra de escala HTTP ao seu aplicativo de contêiner executando o comando az containerapp update.

Bash

az containerapp update \
	--name my-container-app \
	--resource-group my-container-apps \
    --scale-rule-name my-http-scale-rule \
    --scale-rule-http-concurrency 1

PowerShell do Azure

az containerapp update `
	--name my-container-app `
	--resource-group my-container-apps `
    --scale-rule-name my-http-scale-rule `
    --scale-rule-http-concurrency 1

Esse comando adiciona uma regra de escala HTTP ao seu aplicativo de contêiner com o nome my-http-scale-rule e uma configuração de simultaneidade de 1. Se seu aplicativo receber mais de uma solicitação HTTP simultânea, o tempo de execução criará réplicas do aplicativo para lidar com as solicitações.

O comando update retorna a nova configuração como uma resposta JSON para verificar se sua solicitação foi bem-sucedida.

Iniciar saída de log

Você pode observar os efeitos do dimensionamento do aplicativo exibindo os logs gerados pelo tempo de execução dos Aplicativos de Contêiner. Use o comando az containerapp logs show para começar a escutar entradas de log.

Bash

az containerapp logs show \
	--name my-container-app \
	--resource-group my-container-apps \
	--type=system \
	--follow=true

PowerShell do Azure

az containerapp logs show `
	--name my-container-app `
	--resource-group my-container-apps `
	--type=system `
	--follow=true

O comando show retorna entradas dos logs do sistema para seu aplicativo de contêiner em tempo real. Você pode esperar uma resposta como o exemplo a seguir:

{
	"TimeStamp":"2023-08-01T16:49:03.02752",
	"Log":"Connecting to the container 'my-container-app'..."
}
{
	"TimeStamp":"2023-08-01T16:49:03.04437",
	"Log":"Successfully Connected to container:
	'my-container-app' [Revision: 'my-container-app--9uj51l6',
	Replica: 'my-container-app--9uj51l6-5f96557ffb-5khg9']"
}
{
	"TimeStamp":"2023-08-01T16:47:31.9480811+00:00",
	"Log":"Microsoft.Hosting.Lifetime[14]"
}
{
	"TimeStamp":"2023-08-01T16:47:31.9481264+00:00",
	"Log":"Now listening on: http://[::]:8080"
}
{
	"TimeStamp":"2023-08-01T16:47:31.9490917+00:00",
	"Log":"Microsoft.Hosting.Lifetime[0]"
}
{
	"TimeStamp":"2023-08-01T16:47:31.9491036+00:00",
	"Log":"Application started. Press Ctrl+C to shut down."
}
{
	"TimeStamp":"2023-08-01T16:47:31.949723+00:00",
	"Log":"Microsoft.Hosting.Lifetime[0]"
}
{
	"TimeStamp":"2023-08-01T16:47:31.9497292+00:00",
	"Log":"Hosting environment: Production"
}
{
	"TimeStamp":"2023-08-01T16:47:31.9497325+00:00",
	"Log":"Microsoft.Hosting.Lifetime[0]"
}
{
	"TimeStamp":"2023-08-01T16:47:31.9497367+00:00",
	"Log":"Content root path: /app/"
}

Para obter mais informações, consulte Logs containerapp do Azure.

Solicitações de envio

Bash

Abra um novo shell bash. Execute o comando a seguir, substituindo <YOUR_CONTAINER_APP_FQDN> pelo nome de domínio totalmente qualificado para seu aplicativo de contêiner que você salvou na seção Criar e implantar o aplicativo de contêiner.

seq 1 50 | xargs -Iname -P10 curl "<YOUR_CONTAINER_APP_FQDN>"

Esses comandos enviam 50 solicitações para seu aplicativo de contêiner em lotes simultâneos de dez solicitações cada.

Comando ou argumento	Descrição
seq 1 50	Gera uma sequência de números de 1 a 50.
|	O operador de pipe envia a sequência para o comando xargs.
xargs	Executa curl com a URL especificada
-Iname	Atua como um espaço reservado para a saída de seq. Esse argumento impede que o valor de retorno seja enviado para o comando curl.
curl	Chama a URL fornecida.
-P10	Instrui xargs a executar até dez processos por vez.

Para obter mais informações, consulte a documentação para:

• seq
• xargs
• curl

PowerShell do Azure

Abra um novo prompt de comando e insira PowerShell. Execute os comandos a seguir, substituindo <YOUR_CONTAINER_APP_FQDN> pelo nome de domínio totalmente qualificado para seu aplicativo de contêiner que você salvou na seção Criar e implantar o aplicativo de contêiner.

$url="<YOUR_CONTAINER_APP_FQDN>"
$Runspace = [runspacefactory]::CreateRunspacePool(1,10)
$Runspace.Open()
1..50 | % {
    $ps = [powershell]::Create()
    $ps.RunspacePool = $Runspace
    [void]$ps.AddCommand("Invoke-WebRequest").AddParameter("UseBasicParsing",$true).AddParameter("Uri",$url)
    [void]$ps.BeginInvoke()
}

Esses comandos enviam 50 solicitações para seu aplicativo de contêiner em lotes assíncronos de dez solicitações cada.

Comando ou argumento	Descrição
[runspacefactory]::CreateRunspacePool(1,10)	Cria um RunspacePool que permite que até dez espaços de execução sejam executados simultaneamente.
1..50 | % { }	Executa o código incluído nas chaves 50 vezes.
$ps = [powershell]::Create()	Cria uma nova instância do PowerShell.
$ps.RunspacePool = $Runspace	Informa a instância do PowerShell para ser executada no RunspacePool.
[void]$ps.AddCommand("Invoke-WebRequest")	Envia uma solicitação para seu aplicativo de contêiner.
.AddParameter("UseBasicParsing", $true)	Envia uma solicitação para seu aplicativo de contêiner.
.AddParameter("Uri", $url)	Envia uma solicitação para seu aplicativo de contêiner.
[void]$ps.BeginInvoke()	Informa a instância do PowerShell para ser executada de forma assíncrona.

Para obter mais informações, consulte Iniciando o uso de espaços de execução do PowerShell

No primeiro shell, onde você executou o comando az containerapp logs show, a saída agora contém uma ou mais entradas de log como as seguintes.

{
	"TimeStamp":"2023-08-01 18:09:52 +0000 UTC",
	"Type":"Normal",
	"ContainerAppName":"my-container-app",
	"RevisionName":"my-container-app--9uj51l6",
	"ReplicaName":"my-container-app--9uj51l6-5f96557ffb-f795d",
	"Msg":"Replica 'my-container-app--9uj51l6-5f96557ffb-f795d' has been scheduled to run on a node.",
	"Reason":"AssigningReplica",
	"EventSource":"ContainerAppController",
	"Count":0
}

Exibir dimensionamento no portal do Azure (opcional)

1. Entre no portal do Azure.
2. Na barra Pesquisar na parte superior, digite my-container-app.
3. Nos resultados da pesquisa, em Recursos, selecione my-container-app.
4. Na barra de navegação à esquerda, expanda Aplicativo e selecione Escala e réplicas.
5. Na página Escala e réplicas selecione Réplicas.
6. Seu aplicativo de contêiner agora tem mais de uma réplica em execução.

Talvez seja necessário selecionar Atualizar para ver as novas réplicas.

1. Na barra de navegação à esquerda, expanda Monitoramento e selecione Métricas.

2. Na página Métricas, defina Métrica como Solicitações.

3. Selecione Aplicar divisão.

4. Expanda a lista suspensa Valores e marque Réplica.

5. Selecione o ícone de verificação azul para concluir a edição da divisão.

6. O gráfico mostra as solicitações recebidas pelo aplicativo de contêiner, divididas por réplica.

   

7. Por padrão, a escala do gráfico é definida para durar 24 horas, com uma granularidade de tempo de 15 minutos. Selecione a escala e altere-a para os últimos 30 minutos, com uma granularidade de tempo de um minuto. Clique no botão Aplicar.

8. Selecione no gráfico e arraste para destacar o aumento recente nas solicitações recebidas pelo seu aplicativo de contêiner.

A captura de tela a seguir mostra uma exibição ampliada de como as solicitações recebidas pelo aplicativo de contêiner são divididas entre réplicas.

Limpar os recursos

Caso não pretenda continuar usando este aplicativo, execute o comando a seguir para excluir o grupo de recursos junto com todos os recursos criados neste tutorial.

Cuidado

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

az group delete --name my-container-apps

Dica

Está enfrentando problemas? Deixe-nos saber sobre GitHub abrindo um problema no repositório dos Aplicativos de Contêiner do Azure.

Próximas etapas

Definir regras de colocação em escala em Aplicativos de Contêiner do Azure