Guia de início rápido: criar e implantar a partir de um repositório para Aplicativos de Contêiner do Azure
Este artigo demonstra como criar e implantar um microsserviço para Aplicativos de Contêiner do Azure a partir de um repositório GitHub usando a linguagem de programação de sua escolha. Neste início rápido, você cria um microsserviço de exemplo, que representa um serviço de API da Web de back-end que retorna uma coleção estática de álbuns de música.
Este aplicativo de exemplo está disponível em duas versões. Uma versão inclui um contêiner, onde a fonte contém um Dockerfile. A outra versão não tem Dockerfile. Selecione a versão que melhor reflete o seu código-fonte. Se você for novo em contêineres, selecione a opção Sem Dockerfile na parte superior.
Nota
Você também pode criar e implantar esse aplicativo de exemplo a partir do seu sistema de arquivos local. Para obter mais informações, consulte Criar a partir do código-fonte local e implantar seu aplicativo nos Aplicativos de Contêiner do Azure.
A captura de tela a seguir mostra a saída do serviço de API de álbum que você implanta.
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 | Obtenha um gratuitamente. |
| git | Instalar 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.
Se você receber erros sobre parâmetros ausentes ao executar az containerapp comandos na CLI do Azure ou cmdlets do Az.App módulo no Azure PowerShell, certifique-se de ter a versão mais recente da extensão Aplicativos de Contêiner do Azure instalada.
az extension add --name containerapp --upgrade
Nota
A partir de maio de 2024, as extensões da CLI do Azure não habilitam mais recursos de visualização por padrão. Para acessar os recursos de visualização do Container Apps, instale a extensão Container Apps com --allow-preview trueo .
az extension add --name containerapp --upgrade --allow-preview true
Agora que a extensão ou módulo atual está instalado, 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 do Azure 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"
export 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ê.
export ACR_NAME="acaalbums"$GITHUB_USERNAME
Preparar o repositório GitHub
Em uma janela do navegador, vá para o repositório GitHub para o seu idioma preferido e bifurque o repositório.
Selecione o botão Fork na parte superior do repositório da API do álbum para bifurcar o repositório na sua conta. Em seguida, copie o URL de repositório para usá-lo na próxima etapa.
Em uma janela do navegador, vá para o repositório GitHub para o seu idioma preferido e bifurque o repositório , incluindo ramificações.
Selecione o botão Fork na parte superior do repositório da API do álbum para bifurcar o repositório na sua conta. Desmarque "Copiar somente a main ramificação" para também bifurcar a buildpack ramificação.
Criar e implantar o aplicativo de contêiner
Crie e implante seu primeiro aplicativo de contêiner a partir do repositório bifurcado do GitHub com o containerapp up comando. Este comando irá:
- Criar o grupo de recursos
- Criar o ambiente de aplicativos de contêiner com um espaço de trabalho do Log Analytics
- Criar um Azure Container Registry
- Criar um fluxo de trabalho GitHub Action para criar e implantar o aplicativo de contêiner
- Criar o grupo de recursos
- Criar o ambiente de aplicativos de contêiner com um espaço de trabalho do Log Analytics
- Criar automaticamente um registro padrão como parte do seu ambiente
- Criar um fluxo de trabalho GitHub Action para criar e implantar o aplicativo de contêiner
Quando você envia um novo código para o repositório, a Ação do GitHub irá:
- Crie a imagem do contêiner e envie-a por push para o Registro de Contêiner do Azure
- Implantar a imagem de contêiner no aplicativo de contêiner criado
O up comando usa o Dockerfile na raiz do repositório para criar a imagem do contêiner. A EXPOSE instrução no Dockerfile define a porta de destino. Um arquivo do Docker não é necessário para criar um aplicativo de contêiner.
- Detetar automaticamente a linguagem e o tempo de execução
- Crie a imagem usando o Buildpack apropriado
- Enviar a imagem para o registro padrão dos Aplicativos de Contêiner do Azure
O aplicativo de contêiner precisa estar acessível para o tráfego de entrada. Certifique-se de expor a porta 8080 para ouvir as solicitações recebidas.
No comando a seguir, substitua o <YOUR_GITHUB_REPOSITORY_NAME> pelo nome do repositório GitHub na forma de https://github.com/<OWNER>/<REPOSITORY-NAME> ou <OWNER>/<REPOSITORY-NAME>.
No comando a seguir, substitua o <YOUR_GITHUB_REPOSITORY_NAME> pelo nome do repositório GitHub na forma de https://github.com/<OWNER>/<REPOSITORY-NAME> ou <OWNER>/<REPOSITORY-NAME>. Use a --branch buildpack opção para apontar para a fonte de exemplo sem um Dockerfile.
az containerapp up \
--name $API_NAME \
--resource-group $RESOURCE_GROUP \
--location $LOCATION \
--environment $ENVIRONMENT \
--context-path ./src \
--repo <YOUR_GITHUB_REPOSITORY_NAME>
az containerapp up \
--name $API_NAME \
--resource-group $RESOURCE_GROUP \
--location $LOCATION \
--environment $ENVIRONMENT \
--context-path ./src \
--ingress external \
--target-port 8080 \
--repo <YOUR_GITHUB_REPOSITORY_NAME>
--branch buildpack
--
Usando o URL e o código de usuário exibidos no terminal, vá para a página de ativação do dispositivo GitHub em um navegador e insira o código de usuário na página. Siga as instruções para autorizar a CLI do Azure a acessar seu repositório GitHub.
O up comando cria um fluxo de trabalho GitHub Action na pasta .github/workflows do repositório. O fluxo de trabalho é acionado para criar e implantar seu aplicativo de contêiner quando você envia alterações para o repositório.
Verificar a implementação
Copie containerapp up o nome de domínio retornado pelo para um navegador da Web. No seu navegador da Web, vá para o /albums ponto de extremidade do URL.
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.