Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Este artigo demonstra como criar e implantar um microsserviço nos Aplicativos de Contêiner do Azure a partir do código-fonte local na linguagem de programação de sua escolha. Neste início rápido, você cria 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 do serviço de API do álbum implantado por você.
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 de atualização:
az upgrade
Em seguida, instale ou atualize a extensão Aplicativos de Contêiner 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 seguintes variáveis no shell do 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 alternar 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
Crie e implante seu primeiro aplicativo de contêiner usando o containerapp up comando. Esse comando:
- Cria o grupo de recursos.
- Cria um recurso do Registro de Contêiner.
- Compila a imagem de contêiner e a envia por push para o registro.
- Cria o ambiente de Aplicativos de Contêiner com um workspace 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 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 que deve 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 entrar com as permissões necessárias e execute o az containerapp up comando novamente.
Verificar a implantação
Localize a URL do aplicativo de contêiner na saída do comando az containerapp up. Acesse 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 upload for muito grande, o erro 413 será retornado.
Limpar os recursos
Se você não quiser continuar no tutorial Implantar um front-end , poderá remover os recursos do Azure criados durante este início rápido usando 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á com problemas? Informe-nos no GitHub abrindo uma issue no repositório Aplicativos de Contêiner do Azure.
Próxima etapa
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 front-end que chama a API.