Início Rápido: compilar e implantar do código-fonte local nos Aplicativos de Contêiner do Azure
Este artigo demonstra como criar e implantar um microsserviço nos Aplicativos de Contêiner do Azure de um código-fonte local usando a linguagem de programação de sua escolha. Neste início rápido, você vai criar um serviço de API Web de back-end que retorna uma coleção estática de álbuns de música.
A captura de tela a seguir mostra a saída da API do álbum implatado.
Pré-requisitos
Para concluir este projeto, você precisa dos seguintes itens:
| Requisito | Instruções |
|---|---|
| Conta do Azure | Se você não tiver, crie uma conta gratuita. 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. |
| Git | Instale o Git. |
| 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.
az login
Para garantir que você esteja executando a versão mais recente da CLI, execute o comando “upgrade”.
az upgrade
Em seguida, instale ou atualize a extensão dos Aplicativos de Contêiner do Azure para a CLI.
az extension add --name containerapp --upgrade --allow-preview true
Agora que a extensão atual está instalada, registre os namespaces Microsoft.App e Microsoft.OperationalInsights.
az provider register --namespace Microsoft.App
az provider register --namespace Microsoft.OperationalInsights
Criar variáveis de ambiente
Agora que a configuração da CLI foi concluída, você pode definir as variáveis de ambiente que são usadas ao longo deste artigo.
Defina as variáveis a seguir no shell bash.
export RESOURCE_GROUP="album-containerapps"
export LOCATION="canadacentral"
export ENVIRONMENT="env-album-containerapps"
export API_NAME="album-api"
Obter o código de exemplo
Execute o comando a seguir para clonar o aplicativo de exemplo no idioma de sua escolha e altere para a pasta de origem do projeto.
git clone https://github.com/azure-samples/containerapps-albumapi-csharp.git
cd containerapps-albumapi-csharp/src
Compilar e implantar o aplicativo de contêiner
Primeiro, execute o comando a seguir para criar o grupo de recursos que conterá os recursos criados neste início rápido.
az group create --name $RESOURCE_GROUP --location $LOCATION
Compile e implante o seu primeiro aplicativo de contêiner com o comando containerapp up. Este comando vai:
- Criar o grupo de recursos
- Criar um Registro de Contêiner do Azure
- Compilar a imagem de contêiner e efetuá-la por push para o registro
- Criar o ambiente de Aplicativos de Contêiner com um workspace do Log Analytics
- Compilar e implantar o aplicativo de contêiner usando uma imagem de contêiner público
O comando up usa o Dockerfile na pasta do projeto para criar a imagem de contêiner. A instrução EXPOSE no Dockerfile define a porta de destino, que é a porta usada para enviar o tráfego de entrada para o contêiner.
No exemplo de código a seguir, o . (ponto) informa containerapp up para ser executado no diretório atual do projeto que também contém o Dockerfile.
az containerapp up \
--name $API_NAME \
--resource-group $RESOURCE_GROUP \
--location $LOCATION \
--environment $ENVIRONMENT \
--source .
Observação
Se o comando retornar um erro com a mensagem "AADSTS50158: desafio de segurança externa não satisfeito", execute az login --scope https://graph.microsoft.com//.default para fazer logon com as permissões necessárias e execute o comando az containerapp up novamente.
Verificar a implantação
Localize a URL do aplicativo de contêiner na saída do comando az containerapp up. Navegue até a URL no seu navegador. Adicione /albums ao final da URL para ver a resposta da API.
Limites
O tamanho máximo para carregar o código-fonte é de 200 MB. Se o carregamento ultrapassar o limite, o erro 413 será retornado.
Limpar os recursos
Se você não pretende continuar no tutorial Implantar um front-end, remova os recursos do Azure criados durante este início rápido com o comando a seguir.
Cuidado
O comando a seguir exclui o grupo de recursos especificado e todos os recursos contidos nele. Se o grupo contiver recursos fora do escopo deste início rápido, eles também serão excluídos.
az group delete --name $RESOURCE_GROUP
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
Depois de concluir este início rápido, você pode continuar no Tutorial: Comunicação entre microsserviços nos Aplicativos de Contêiner do Azure para saber como implantar um aplicativo de front-end que chama a API.