Início Rápido: Docker no Visual Studio

Com o Visual Studio, você pode facilmente criar, depurar e executar aplicativos do .NET, ASP.NET e ASP.NET Core em contêineres e publicá-los no Registro de Contêiner do Azure, no Docker Hub, no Serviço de Aplicativo do Azure ou no seu próprio Registro de Contêiner. Neste artigo, você publicará um aplicativo ASP.NET Core para Registro de Contêiner do Azure.

Pré-requisitos

• Docker Desktop
• Visual Studio 2022 com Desenvolvimento para a Web, a carga de trabalho das Ferramentas do Azure e/ou a carga de trabalho de Desenvolvimento para área de trabalho do .NET instalada
• Para publicar no Registro de Contêiner do Azure, uma assinatura do Azure. Inscreva-se em uma avaliação gratuita.

Instalação e configuração

Para a instalação do Docker, primeiro examine as informações em Docker Desktop for Windows: What to know before you install (Docker para Windows: o que saber antes de instalar). Em seguida, instale o Docker Desktop.

Adicionar um projeto a um contêiner do Docker

1. Antes de criar o projeto do Visual Studio, verifique se o Docker Desktop está executando o tipo de contêineres (Windows ou Linux) que você pretende usar em seu projeto do Visual Studio.

   Para alterar o tipo de contêiner usado pelo Docker Desktop, clique com o botão direito do mouse no ícone do Docker (baleia) na Barra de Tarefas e escolha Alternar para contêineres do Linux ou Alternar para contêineres do Windows.

   Aviso

   Se você alternar o tipo de contêiner depois de criar o projeto do Visual Studio, os arquivos de imagem do Docker poderão falhar ao carregar.

2. Crie um novo projeto usando o modelo ASP.NET Core Web App ou, se quiser usar o .NET Framework em vez do .NET Core, escolha ASP.NET Aplicativo Web (.NET Framework).

3. Na tela Criar novo aplicativo Web, verifique se a caixa de seleção Habilitar Suporte ao Docker está marcada.

   

   A captura de tela mostra a versão mais recente com o .NET 8.0. Se você estiver usando o .NET Framework, a caixa de diálogo será um pouco diferente.

4. Selecione o tipo de contêiner desejado (Windows ou Linux) e selecione Criar.

Visão geral do Dockerfile

O Visual Studio cria um Dockerfile em seu projeto, que fornece a receita de como criar uma imagem final do Docker. Para obter mais informações, consulte a referência do Dockerfile para obter detalhes sobre os comandos usados no Dockerfile.

#See https://aka.ms/customizecontainer to learn how to customize your debug container and how Visual Studio uses this Dockerfile to build your images for faster debugging.

# This stage is used when running from VS in fast mode (Default for Debug configuration)
FROM mcr.microsoft.com/dotnet/aspnet:8.0-nanoserver-1809 AS base
WORKDIR /app
EXPOSE 8080
EXPOSE 8081

# This stage is used to build the service project
FROM mcr.microsoft.com/dotnet/sdk:8.0-nanoserver-1809 AS build
ARG BUILD_CONFIGURATION=Release
WORKDIR /src
COPY ["MyWepApp/MyWebApp.csproj", "MyWebApp/"]
RUN dotnet restore "./MyWebApp/./MyWebApp.csproj"
COPY . .
WORKDIR "/src/MyWebApp"
RUN dotnet build "./MyWebApp.csproj" -c %BUILD_CONFIGURATION% -o /app/build

# This stage is used to publish the service project to be copied to the final stage
FROM build AS publish
ARG BUILD_CONFIGURATION=Release
RUN dotnet publish "./MyWebApp.csproj" -c %BUILD_CONFIGURATION% -o /app/publish /p:UseAppHost=false

# This stage is used in production or when running from VS in regular mode (Default when not using the Debug configuration)
FROM base AS final
WORKDIR /app
COPY --from=publish /app/publish .
ENTRYPOINT ["dotnet", "MyWebApp.dll"]

O Dockerfile anterior baseia-se na imagem do .NET 8 do MCR (Registro de Contêiner do Azure) e inclui instruções para modificar a imagem de base, criando o projeto chamado MyWebApp e adicionando-o ao contêiner. Se você estiver usando o .NET Framework, a imagem base será diferente.

Quando a caixa de seleção Configurar para HTTPS do diálogo do novo projeto estiver marcada, o Dockerfile exibirá duas portas. Uma porta é usada para o tráfego HTTP; a outra porta é usada para o HTTPS. Se a caixa de seleção não estiver marcada, uma única porta (80) será exposta para o tráfego HTTP.

Com o Visual Studio 2022 versão 17.7 ou posterior, você pode direcionar para o .NET 8. Nesse caso, você tem o benefício de poder executar seu aplicativo com mais segurança, como um usuário normal, em vez de com permissões elevadas. O Dockerfile padrão gerado pelo Visual Studio para projetos do .NET 8 está configurado para ser executado como um usuário normal. Para habilitar esse computador em um projeto existente, adicione a linha USER app ao Dockerfile na imagem base. Além disso, como a porta 80 é restrita para usuários normais, exponha as portas 8080 e 8081 em vez de 80 e 443. A porta 8080 é usada para tráfego HTTP e a porta 8081 é usada para HTTPS. Para ser executado como um usuário normal, o contêiner deve usar uma imagem base do .NET 8 e o aplicativo deve ser executado como um aplicativo .NET 8. Quando configurado corretamente, o Dockerfile deve conter um código como no exemplo a seguir:

FROM mcr.microsoft.com/dotnet/aspnet:8.0-preview AS base
USER app
WORKDIR /app
EXPOSE 8080
EXPOSE 8081

Depurar

Selecione Docker na lista suspensa de depuração na barra de ferramentas e inicie a depuração do aplicativo. Poderá aparecer uma mensagem com um aviso sobre a confiança em um certificado, escolha confiar no certificado para continuar.

A opção Ferramentas de Contêiner na janela Saída mostra quais ações estão ocorrendo. Na primeira vez, pode levar algum tempo para baixar a imagem base, mas é mais rápido em execuções subsequentes.

Depois que o build for concluído, o navegador será aberto e exibirá a página inicial do aplicativo. Na barra de endereços do Browser, você pode ver a URL do localhost e o número da porta para depuração.

Observação

Se você precisar alterar as portas para depuração, poderá fazer isso no arquivo launchSettings.json. Consulte Configurações de inicialização de contêiner.

Janela Contêineres

Você pode usar a janela Contêineres para exibir contêineres em execução em seu computador, bem como imagens disponíveis.

Abra a janela Contêineres usando a caixa de pesquisa no IDE (pressione Ctrl+Q para usá-la), digite containere escolha a janela Contêineres na lista.

Você pode montar a janela Contêineres em um local conveniente, como abaixo do editor, movendo-a e seguindo as guias de posicionamento da janela.

Na janela, localize o contêiner e percorra cada guia para exibir as variáveis de ambiente, os mapeamentos de porta, os logs e o sistema de arquivos.

Para obter mais informações, consulte Usar a janela Contêineres.

Publicar imagens do Docker

Depois que o ciclo de desenvolvimento e de depuração do aplicativo forem concluídos, você poderá criar uma imagem de produção do aplicativo.

1. Altere a lista suspensa de configuração para Versão e compile o aplicativo.

2. Clique com o botão direito no projeto em Gerenciador de Soluções e escolha Publicar.

3. Na caixa de diálogo Publicar, selecione a guia do Registro de Contêiner do Docker.

   

4. Escolha Criar um novo Registro de Contêiner do Azure.

   

5. Preencha os valores desejados em Criar um novo Registro de Contêiner do Azure.

   Configuração	Valor sugerido	Descrição
   Prefixo DNS	Nome globalmente exclusivo	Nome que identifica exclusivamente o registro de contêiner.
   Assinatura	Escolha sua assinatura	A assinatura do Azure a utilizar.
   Grupo de Recursos	myResourceGroup	Nome do grupo de recursos no qual criar o registro de contêiner. Escolha Novo para criar um novo grupo de recursos.
   SKU	Standard	Camada de serviço do registro de contêiner
   Local do Registro	Um local próximo	Escolha um Local em uma região próxima a você ou perto de outros serviços que podem usar o registro de contêiner.

   

6. Selecione Criar. A caixa de diálogo Publicar agora mostra o registro criado.

   

7. Escolha Concluir para concluir o processo de publicação da imagem de contêiner no registro recém-criado no Azure.

   

Próximas etapas

Agora, é possível extrair o contêiner do registro para qualquer host capaz de executar imagens do Docker, por exemplo Instâncias de Contêiner do Azure.

Recursos adicionais

• Desenvolvimento de contêiner com o Visual Studio
• Criar um aplicativo de vários contêineres com o Docker Compose
• Solucionar problemas de desenvolvimento do Visual Studio com o Docker
• Repositório do GitHub e Ferramentas do Visual Studio para Contêineres