Tutorial: Criar e implantar seu aplicativo em Aplicativos de Contêiner do Azure

Este artigo demonstra como criar e implantar um microsserviço nos Aplicativos de Contêiner do Azure a partir de um repositório de origem usando sua linguagem de programação preferida.

Este é o primeiro tutorial da série de artigos que o orientam sobre como usar os principais recursos nos Aplicativos de Contêiner do Azure. A primeira etapa é criar um serviço de API da Web de back-end que retorna uma coleção estática de álbuns de música.

Nota

Você também pode criar e implantar esse aplicativo usando o az containerapp up seguindo as instruções no artigo Guia de início rápido: criar e implantar um aplicativo em aplicativos de contêiner do Azure a partir de um repositório . O az containerapp up comando é uma maneira rápida e conveniente de criar e implantar seu aplicativo nos Aplicativos de Contêiner do Azure usando um único comando. No entanto, ele não fornece o mesmo nível de personalização para seu aplicativo de contêiner.

O próximo tutorial da série criará e implantará o aplicativo Web front-end nos Aplicativos de Contêiner do Azure.

A captura de tela a seguir mostra a saída da API do álbum implantada neste tutorial.

Pré-requisitos

Para concluir este projeto, você precisa dos seguintes itens:

Necessidade	Instruções
Conta do Azure	Se você não tiver uma, crie uma conta gratuitamente. Você precisa da permissão de Colaborador ou Proprietário na assinatura do Azure para continuar. Consulte Atribuir funções do Azure usando o portal do Azure para obter detalhes.
Conta GitHub	Registe-se gratuitamente.
git	Instalar o git
CLI do Azure	Instale a CLI do Azure.

Necessidade	Instruções
Conta do Azure	Se você não tiver uma, crie uma conta gratuitamente. Você precisa da permissão de Colaborador ou Proprietário na assinatura do Azure para continuar. Consulte Atribuir funções do Azure usando o portal do Azure para obter detalhes.
Conta GitHub	Registe-se gratuitamente.
git	Instalar o git
CLI do Azure	Instale a CLI do Azure.
Área de trabalho do Docker	O Docker fornece instaladores que configuram o ambiente do Docker no macOS, Windows e Linux. No prompt de comando, digite docker para garantir que o Docker esteja em execução.

Configurar

Para entrar no Azure a partir da CLI, execute o seguinte comando e siga os prompts para concluir o processo de autenticação.

Bash

az login

Azure PowerShell

Connect-AzAccount

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

Bash

az upgrade

Azure PowerShell

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

Ignore quaisquer avisos sobre módulos atualmente em uso.

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

Bash

az extension add --name containerapp --upgrade

Azure PowerShell

Install-Module -Name Az.App

Se você tiver uma versão mais antiga do módulo Az.App instalada, atualize-a.

Update-Module -Name Az.App

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

Nota

Os recursos dos Aplicativos de Contêiner do Azure migraram do Microsoft.Web namespace para o Microsoft.App namespace. Consulte Migração de namespace de Microsoft.Web para Microsoft.App em março de 2022 para obter mais detalhes.

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

Criar variáveis de ambiente

Agora que a configuração da CLI do Azure está concluída, você pode definir as variáveis de ambiente usadas ao longo deste artigo.

Bash

Defina as seguintes variáveis em seu shell bash.

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

Antes de executar esse comando, certifique-se de substituir <YOUR_GITHUB_USERNAME> pelo seu nome de usuário do GitHub.

Em seguida, defina um nome de registro de contêiner exclusivo para você.

ACR_NAME="acaalbums"$GITHUB_USERNAME

Azure PowerShell

Defina as seguintes variáveis no console do PowerShell.

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

Antes de executar esse comando, certifique-se de substituir <YOUR_GITHUB_USERNAME> pelo seu nome de usuário do GitHub.

Em seguida, defina um nome de registro de contêiner exclusivo para você.

$ACRName = "acaalbums"+$GITHUB_USERNAME

Preparar o repositório GitHub

Navegue até o repositório para o seu idioma preferido e bifurque o repositório.

C#

Selecione o botão Fork na parte superior do repositório da API do álbum para bifurcar o repositório na sua conta.

Agora você pode clonar sua bifurcação do repositório de exemplo.

Use o seguinte comando git para clonar seu repositório bifurcado na pasta code-to-cloud :

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

Ir

Selecione o botão Fork na parte superior do repositório da API do álbum para bifurcar o repositório na sua conta.

Agora você pode clonar sua bifurcação do repositório de exemplo.

Use o seguinte comando git para clonar seu repositório bifurcado na pasta code-to-cloud :

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

Java

Selecione o botão Fork na parte superior do repositório da API do álbum para bifurcar o repositório na sua conta.

Agora você pode clonar sua bifurcação do repositório de exemplo.

Use o seguinte comando git para clonar seu repositório bifurcado na pasta code-to-cloud :

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

Nota

O exemplo Java suporta apenas uma compilação Maven, que resulta em um arquivo JAR executável. A compilação usa as configurações padrão, pois não há suporte para a passagem de variáveis de ambiente.

JavaScript

Selecione o botão Fork na parte superior do repositório da API do álbum para bifurcar o repositório na sua conta.

Agora você pode clonar sua bifurcação do repositório de exemplo.

Use o seguinte comando git para clonar seu repositório bifurcado na pasta code-to-cloud :

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

Python

Selecione o botão Fork na parte superior do repositório da API do álbum para bifurcar o repositório na sua conta.

Agora você pode clonar sua bifurcação do repositório de exemplo.

Use o seguinte comando git para clonar seu repositório bifurcado na pasta code-to-cloud :

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

Em seguida, altere o diretório para a raiz do repositório clonado.

cd code-to-cloud/src

Criar um grupo de recursos do Azure

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

Bash

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

Azure PowerShell

New-AzResourceGroup -Location $Location -Name $ResourceGroupName

Criar um Azure Container Registry

Depois que a imagem do contêiner da API do álbum for criada, crie uma instância do Azure Container Registry (ACR) em seu grupo de recursos para armazená-la.

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

Compilar a aplicação

Com as tarefas ACR, você pode criar e enviar por push a imagem do docker para a API do álbum sem instalar o Docker localmente.

Construa o contêiner com ACR

Execute o seguinte comando para iniciar o processo de compilação e envio de imagem usando o ACR. O . no final do comando representa o contexto de compilação do docker, o que significa que esse comando deve ser executado dentro da pasta src onde o Dockerfile está localizado.

Bash

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

Azure PowerShell

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

A saída do comando mostra o az acr build progresso do carregamento do código-fonte para o Azure e os detalhes das docker build operações e docker push .

Compilar a aplicação

As etapas a seguir demonstram como criar sua imagem de contêiner localmente usando o Docker e enviar a imagem para o novo registro de contêiner.

Crie o contêiner com o Docker

O comando a seguir cria uma imagem de contêiner para a API do álbum e a marca com o nome totalmente qualificado do servidor de login ACR. O . no final do comando representa o contexto de compilação do docker, o que significa que esse comando deve ser executado dentro da pasta src onde o Dockerfile está localizado.

Bash

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

Azure PowerShell

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

Envie a imagem para o registro do contêiner

Primeiro, entre no seu Registro de Contêiner do Azure.

Bash

az acr login --name $ACR_NAME

Azure PowerShell

az acr login --name $ACRName

Agora, envie a imagem para o seu registro.

Bash

docker push $ACR_NAME.azurecr.io/$API_NAME

Azure PowerShell

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

Criar um ambiente de aplicativos de contêiner

O ambiente de Aplicativos de Contêiner do Azure atua como um limite seguro em torno de um grupo de aplicativos de contêiner.

Crie o ambiente Container Apps usando o comando a seguir.

Bash

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

Azure PowerShell

Um espaço de trabalho do Log Analytics é necessário para o ambiente Container Apps. Os comandos a seguir criam um espaço de trabalho do Log Analytics e salvam o ID do espaço de trabalho e a chave compartilhada primária nas variáveis.

$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

Para criar o ambiente, execute o seguinte comando:

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

New-AzContainerAppManagedEnv @EnvArgs

Implantar sua imagem em um aplicativo de contêiner

Agora que você tem um ambiente criado, você pode criar e implantar seu aplicativo de contêiner com o az containerapp create comando.

Crie e implante seu aplicativo de contêiner com o seguinte comando.

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

• Ao definir --ingress como external, seu aplicativo de contêiner pode ser acessado pela Internet pública.

• O target-port está definido para corresponder à 8080 porta que o contêiner está escutando para solicitações.

• Sem uma query propriedade, a chamada para az containerapp create retorna uma resposta JSON que inclui um conjunto avançado de detalhes sobre o aplicativo. Adicionar um parâmetro de consulta filtra a saída apenas para o FQDN (nome de domínio totalmente qualificado) do aplicativo.

Azure PowerShell

Para criar o aplicativo de contêiner, crie objetos de modelo que você passa como argumentos para o New-AzContainerApp comando.

Crie um objeto de modelo para definir os parâmetros da imagem do contêiner.

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

Execute o seguinte comando para obter suas credenciais do Registro.

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

Crie um objeto de credencial do Registro para definir suas informações do Registro e um objeto secreto para definir sua senha do Registro. O PasswordSecretRef refere-se ao Name no objeto secreto.

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

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

Obtenha o ID do seu ambiente.

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

Crie o aplicativo de contêiner.

$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

• Ao definir IngressExternal como external, seu aplicativo de contêiner pode ser acessado pela Internet pública.
• O IngressTargetPort parâmetro é definido para 8080 corresponder à porta que o contêiner está escutando para solicitações.

Verificar a implementação

Copie o FQDN para um navegador da Web. No navegador da Web, navegue até o /albums ponto de extremidade do FQDN.

Clean up resources (Limpar recursos)

Se você não continuar com o tutorial Comunicação entre microsserviços , poderá remover os recursos do Azure criados durante este início rápido. Execute o seguinte comando para excluir o grupo de recursos junto com todos os recursos criados neste início rápido.

Bash

az group delete --name $RESOURCE_GROUP

Azure PowerShell

Remove-AzResourceGroup -Name $ResourceGroup -Force

Gorjeta

Tem problemas? Informe-nos no GitHub abrindo um problema no repositório de Aplicativos de Contêiner do Azure.

Próximos passos

Este guia de início rápido é o ponto de entrada para um conjunto de tutoriais progressivos que mostram os vários recursos nos Aplicativos de Contêiner do Azure. Continue para saber como habilitar a comunicação de um front-end da Web que chama a API implantada neste artigo.

Tutorial: Comunicação entre microsserviços