Partilhar via


Guia de início rápido: criar e implantar a partir do código-fonte local para os 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 do código-fonte local usando a linguagem de programação de sua escolha. Neste início rápido, você cria um serviço de API da 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 do serviço de API de álbum que você implanta.

Captura de tela da resposta do endpoint da API de álbuns.

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.
Git Instale o Git.
CLI do Azure Instale a CLI do Azure.

Configurar

Para entrar no Azure a partir da CLI, execute o seguinte comando 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 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 Microsoft.App namespaces 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 está concluída, você pode definir as variáveis de ambiente usadas ao longo deste artigo.

Defina as seguintes variáveis em seu 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 seguinte comando para clonar o aplicativo de exemplo no idioma de sua escolha e mudar para a pasta de origem do projeto.

git clone https://github.com/azure-samples/containerapps-albumapi-csharp.git
cd containerapps-albumapi-csharp/src

Criar e implantar o aplicativo de contêiner

Primeiro, execute o seguinte comando para criar o grupo de recursos que conterá os recursos criados neste início rápido.

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

Crie e implante seu primeiro aplicativo de contêiner com o containerapp up comando. Este comando irá:

  • Criar o grupo de recursos
  • Criar um Azure Container Registry
  • Crie a imagem do contêiner e envie-a para o registro
  • Criar o ambiente de aplicativos de contêiner com um espaço de trabalho do Log Analytics
  • Criar e implantar o aplicativo de contêiner usando a imagem de contêiner criada

O up comando usa o Dockerfile na pasta do projeto para criar a imagem do contêiner. A EXPOSE instrução no Dockerfile define a porta de destino, que é a porta usada para enviar tráfego de entrada para o contêiner.

No exemplo de código a seguir, o . (ponto) diz 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 .

Nota

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 login com as permissões necessárias e, em seguida, execute o az containerapp up comando novamente.

Verificar a implementação

Localize a URL do aplicativo contêiner na saída do az containerapp up comando. Navegue até o URL no seu navegador. Adicione /albums ao final do URL para ver a resposta da API.

Captura de tela da resposta do endpoint da API de álbuns.

Limites

O tamanho máximo para carregar o código-fonte é de 200MB. Se o upload ultrapassar o limite, o erro 413 será retornado.

Clean up resources (Limpar recursos)

Se você não continuar com o tutorial Implantar um front-end , poderá remover os recursos do Azure criados durante este início rápido com o seguinte comando.

Atenção

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

Gorjeta

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

Próximos passos

Depois de concluir este início rápido, você pode continuar para Tutorial: Comunicação entre microsserviços em Aplicativos de Contêiner do Azure para saber como implantar um aplicativo front-end que chama a API.