Tutorial: Implantar em aplicativos de contêiner do Azure usando o Visual Studio
O Azure Container Apps permite-lhe executar microsserviços e aplicações contentorizadas numa plataforma sem servidor. Com os Container Apps, você aproveita os benefícios de executar contêineres enquanto deixa para trás as preocupações de configurar manualmente a infraestrutura de nuvem e orquestradores de contêineres complexos.
Neste tutorial, você implanta um aplicativo ASP.NET Core 8.0 em contêiner nos Aplicativos de Contêiner do Azure usando o Visual Studio. As etapas abaixo também se aplicam a versões anteriores do ASP.NET Core.
Pré-requisitos
- É necessária uma conta do Azure com uma subscrição ativa. Se ainda não tiver uma, pode criar uma conta gratuitamente.
- Visual Studio 2022 versão 17.2 ou superior, disponível para download gratuito.
Criar o projeto
Comece criando o aplicativo ASP.NET Core em contêiner.
No Visual Studio, selecione Arquivo e, em seguida, escolha Novo => Projeto.
Na janela de diálogo, procure ASP.NET e, em seguida, escolha ASP.NET Core Web App e selecione Next.
No campo Nome do projeto, nomeie o aplicativo MyContainerApp e selecione Avançar.
Na tela Informações Adicionais, certifique-se de selecionar Ativar Docker e, em seguida, certifique-se de que Linux está selecionado para a configuração do sistema operacional Docker. Atualmente, os Aplicativos de Contêiner do Azure não oferecem suporte a contêineres do Windows. Essa seleção garante que o modelo de projeto ofereça suporte à conteinerização por padrão. Enquanto habilitado, o projeto usa um contêiner enquanto está sendo executado ou construído.
Clique em Criar e o Visual Studio cria e carrega o projeto.
Implantar em aplicativos de contêiner do Azure
O aplicativo inclui um Dockerfile porque o modelo de projeto tinha a configuração Habilitar Docker selecionada. O Visual Studio usa o Dockerfile para criar a imagem de contêiner que os Aplicativos de Contêiner do Azure executam.
Consulte Como o Visual Studio cria aplicativos em contêineres se quiser saber mais sobre as especificidades desse processo.
Agora você está pronto para implantar no aplicativo para Aplicativos de Contêineres do Azure.
Criar os recursos
As janelas de diálogo de publicação no Visual Studio ajudam você a escolher recursos existentes do Azure ou permitem que você crie novos recursos para implantação. Esse processo também cria a imagem de contêiner, envia a imagem para o Registro de Contêiner do Azure (ACR) e implanta a nova imagem do aplicativo de contêiner.
Clique com o botão direito do mouse no nó do projeto MyContainerApp e selecione Publicar.
Na caixa de diálogo, escolha Azure na lista de opções de publicação e selecione Avançar.
Na tela de destino específico, escolha Aplicativos de Contêiner do Azure (Linux) e selecione Avançar novamente.
Em seguida, crie um Aplicativo de Contêiner do Azure para hospedar o projeto. Selecione o ícone verde mais à direita para abrir a caixa de diálogo Criar novo . Na caixa de diálogo Criar novo, insira os seguintes valores:
- Nome do aplicativo de contêiner: insira um nome de
msdocscontainerapp
. - Nome da subscrição: escolha a subscrição onde pretende alojar a sua aplicação.
- Grupo de recursos: um grupo de recursos atua como um contêiner lógico para organizar recursos relacionados no Azure. Você pode selecionar um grupo de recursos existente ou selecionar Novo para criar um com um nome de sua escolha, como
msdocscontainerapps
. - Ambiente de aplicativos de contêiner: Ambiente de aplicativos de contêiner: cada aplicativo de contêiner deve fazer parte de um ambiente de aplicativo de contêiner. Um ambiente fornece uma rede isolada para um ou mais aplicativos de contêiner, tornando possível que eles invoquem facilmente uns aos outros. Clique em Novo para abrir a caixa de diálogo Criar novo para seu ambiente de aplicativo de contêiner. Deixe os valores padrão e selecione OK para fechar a caixa de diálogo do ambiente.
- Nome do contêiner: Este é o nome amigável do contêiner que é executado para este aplicativo de contêiner. Use o nome
msdocscontainer1
para este início rápido. Um aplicativo de contêiner normalmente executa um único contêiner, mas há momentos em que é necessário ter mais de um contêiner. Um desses exemplos é quando um contêiner de sidecar é necessário para executar uma atividade, como registro especializado ou comunicações.
- Nome do aplicativo de contêiner: insira um nome de
Selecione Criar para finalizar a criação ou seu aplicativo de contêiner. O Visual Studio e o Azure criam os recursos necessários em seu nome. Esse processo pode levar alguns minutos, portanto, permita que ele seja executado até a conclusão antes de seguir em frente.
Depois que os recursos forem criados, escolha Avançar.
Na tela Registro, você pode selecionar um Registro existente, se tiver um, ou criar um novo. Para criar um novo, clique no ícone verde + à direita. Na tela Criar novo registro, preencha os seguintes valores:
- Prefixo DNS
msdocscontainerregistry
: insira um valor ou um nome de sua escolha. - Nome da Subscrição: Selecione a subscrição que pretende utilizar - poderá ter apenas uma à sua escolha.
- Grupo de recursos: escolha o grupo de recursos msdocs criado anteriormente.
- Sku: Selecione Padrão.
- Local do Registro: Selecione uma região que esteja geograficamente próxima a você.
- Prefixo DNS
Depois de preencher esses valores, selecione Criar. O Visual Studio e o Azure levam um momento para criar o registro.
Depois que o registro do contêiner for criado, verifique se ele está selecionado e escolha Concluir. Visual Studio leva um momento para criar o perfil de publicação. Esse perfil de publicação é onde o Visual Studio armazena as opções de publicação e os recursos escolhidos para que você possa publicar rapidamente novamente sempre que quiser. Você pode fechar a caixa de diálogo assim que ela terminar.
Publicar o aplicativo usando o Visual Studio
Enquanto os recursos e o perfil de publicação são criados, você ainda precisa publicar e implantar o aplicativo no Azure.
Escolha Publicar no canto superior direito da tela do perfil de publicação para implantar no aplicativo de contêiner que você criou no Azure. Este processo pode demorar um pouco, por isso aguarde até que seja concluído.
Quando o aplicativo termina a implantação, o Visual Studio abre um navegador para a URL do seu site implantado. Esta página pode inicialmente exibir um erro se todos os recursos adequados não concluírem o provisionamento. Você pode continuar a atualizar o navegador periodicamente para verificar se a implantação foi totalmente concluída.
Publicar o aplicativo usando as Ações do GitHub
Os aplicativos de contêiner também podem ser implantados usando CI/CD por meio das Ações do GitHub. O GitHub Actions é uma ferramenta poderosa para automatizar, personalizar e executar fluxos de trabalho de desenvolvimento diretamente através do repositório GitHub do seu projeto.
Se o Visual Studio detetar que o projeto que você está publicando está hospedado no GitHub, o fluxo de publicação apresentará uma etapa adicional do tipo de implantação. Este estágio permite que os desenvolvedores escolham se desejam publicar diretamente por meio do Visual Studio usando as etapas mostradas anteriormente no início rápido ou por meio de um fluxo de trabalho de Ações do GitHub.
Se você selecionar o fluxo de trabalho Ações do GitHub, o Visual Studio criará uma pasta .github para o diretório raiz do projeto, juntamente com um arquivo YAML gerado dentro dele. O arquivo YAML contém configurações de Ações do GitHub para criar e implantar seu aplicativo no Azure sempre que você enviar seu código.
Depois de fazer uma alteração e enviar seu código, você pode ver o progresso do processo de compilação e implantação no GitHub na guia Ações . Esta página fornece logs e indicadores detalhados sobre o progresso e a integridade do fluxo de trabalho.
O fluxo de trabalho é concluído quando você vê uma marca de seleção verde ao lado dos trabalhos de compilação e implantação. Ao navegar até o site Aplicativos de contêiner, você verá as alterações mais recentes aplicadas. Você sempre pode encontrar a URL do seu aplicativo de contêiner usando a página do portal do Azure.
Clean up resources (Limpar recursos)
Se você não planeja mais usar esse aplicativo, poderá excluir a instância dos Aplicativos de Contêiner do Azure e todos os serviços associados removendo o grupo de recursos.
Para remover os recursos que criou, siga estes passos no portal do Azure:
- Selecione o grupo de recursos msdocscontainerapps na seção Visão geral .
- Selecione o botão Excluir grupo de recursos na parte superior da visão geral do grupo de recursos.
- Digite o nome do grupo de recursos msdocscontainerapps na caixa de diálogo de confirmação "my-container-apps".
- Selecione Eliminar.
O processo para excluir o grupo de recursos pode levar alguns minutos para ser concluído.
Gorjeta
Tem problemas? Informe-nos no GitHub abrindo um problema no repositório de Aplicativos de Contêiner do Azure.