Partilhar via

Início rápido: criar e implantar a partir do código-fonte local nos Azure Container Apps

Este artigo demonstra como construir e implementar um microserviço para Azure Container Apps a partir de código-fonte local na linguagem de programação que preferir. Neste início rápido, cria-se uma API web de back-end que retorna uma coleção estática de álbuns de música.

A captura de ecrã seguinte mostra a saída do serviço API de álbums que implementa.

Captura de ecrã da resposta do endpoint da API dos álbuns.

Pré-requisitos

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

Requisito 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 Azure usando o portal Azure para mais detalhes.
Git Instale o Git.
CLI do Azure Instale a CLI do Azure.

Configuração

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 está a correr a versão mais recente da CLI, execute o comando upgrade:

az upgrade

De seguida, instale ou atualize a extensão Container Apps para a linha de código:

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

Agora que a extensão atual está instalada, registar 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 está concluída, você pode definir as variáveis de ambiente usadas ao longo deste artigo.

Defina as seguintes variáveis no 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 a aplicação de exemplo na linguagem que preferir e mude 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

Constrói e implementa a tua primeira aplicação de contentor usando o containerapp up comando. Este comando:

  • Cria o grupo de recursos.
  • Cria um recurso do Registo de Contentores.
  • Cria a imagem do contêiner e envia-a para o registo.
  • Cria o ambiente Container Apps com um espaço de trabalho do Log Analytics.
  • Cria e implanta o aplicativo de contêiner usando a imagem de contêiner criada.

O up comando usa o Dockerfile na pasta do projeto para construir a imagem do contentor. 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 devolver um erro com a mensagem "AADSTS50158: Desafio de segurança externo não satisfeito", execute az login --scope https://graph.microsoft.com//.default para iniciar sessão com as permissões necessárias e depois execute novamente o az containerapp up comando.

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 ecrã da resposta do endpoint da API dos álbuns.

Limites

O tamanho máximo para carregar código-fonte é de 200 MB. Se o upload for demasiado grande, o erro 413 é devolvedo.

Limpar recursos

Se não vais continuar com o tutorial de Deploy a frontend , podes remover os recursos do Azure criados durante este quickstart usando 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 âmbito deste quickstart, também são eliminados.

az group delete --name $RESOURCE_GROUP

Dica (if "Tip" means advice or suggestion)

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

Próximo passo

Depois de concluir este início rápido, pode continuar para Tutorial: Comunicação entre microserviços nos Azure Container Apps para aprender a distribuir uma aplicação front-end que chama a API.

Tutorial: Comunicação entre microsserviços

  • Last updated on