Início Rápido: Ferramentas de Contêiner no Visual Studio

Com o Visual Studio, você pode facilmente criar, depurar e executar aplicativos .NET, ASP.NET e ASP.NET Core em contêineres e publicá-los no Registro de Contêiner do Azure, no Hub do Docker, 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 no Registro de Contêiner do Azure.

Pré-requisitos

• Área de Trabalho do Docker ou Podman Desktop.
• Visual Studio ou para suporte ao Podman, Visual Studio 2026, com a carga de trabalho ASP.NET e desenvolvimento web, desenvolvimento do Azure e/ou desenvolvimento de desktop do .NET instalada.
• Para publicar no Registro de Contêiner do Azure, é necessária uma assinatura do Azure. Inscreva-se para um teste gratuito.

Instalação e configuração

Para a instalação do Docker, primeiro examine as informações em Docker Desktop para Windows: o que saber antes de instalar. Em seguida, instale o Docker Desktop.

Para usar o Podman como plataforma de contêiner, baixe Podman Desktop para Windows e siga o tutorial em Podman para Windows para inicializar e iniciar uma máquina Podman.

Adicionar um projeto a um contêiner

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 do ASP.NET Core Web App .

3. Na tela Criar novo aplicativo Web , verifique se a caixa de seleção Habilitar suporte ao contêiner está selecionada.

   

   A captura de tela mostra a versão mais recente com o .NET 8.0.

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 AS base
USER $APP_UID
WORKDIR /app
EXPOSE 8080
EXPOSE 8081

# This stage is used to build the service project
FROM mcr.microsoft.com/dotnet/sdk:8.0 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 catálogo de contêineres do Microsoft Syndicates .NET 8 e inclui instruções para modificar a imagem base criando o projeto nomeado MyWebApp e adicionando-o ao contêiner.

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 tráfego HTTP; a outra porta é usada para HTTPS. Se a caixa de seleção não estiver marcada, uma única porta (80 ou 8080) será exposta para tráfego HTTP.

Ao usar o .NET 8 e versões posteriores, você tem a vantagem de poder executar seu aplicativo de forma mais segura, como um usuário comum, ao invés de usar permissões elevadas. O Dockerfile padrão gerado pelo Visual Studio para projetos do .NET 8 é configurado para ser executado como um usuário normal. Para habilitar esse comportamento 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 código como no exemplo a seguir:

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

Os modelos padrão usam a variável APP_UID de ambiente para a identidade do usuário normal.

Depurar

Selecione Docker na lista suspensa de depuração na barra de ferramentas e inicie a depuração do aplicativo. Você pode ver uma mensagem com um prompt sobre como confiar 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 demorar um pouco 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 home page 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.

Nota

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 de Contêineres usando a caixa de pesquisa no IDE (pressione Ctrl+Q para usá-la), digite containere escolha a janela de Contêineres na lista.

Você pode montar a janela Contêineres em um local conveniente, como abaixo do editor, movendo-a e seguindo os 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 depuração do aplicativo for concluído, 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 Novo Registro de Contêiner do Azure.

   

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

   Configuração	Valor sugerido	Descrição
   Prefixo DNS	Nome global exclusivo	Nome que identifica exclusivamente o registro de contêiner.
   Assinatura	Escolha sua assinatura	A assinatura do Azure a utilizar.
   Grupo de recursos	GrupoDeRecursosMeu	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 a você	Escolha um local em uma região perto de 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 Finalizar para concluir o processo de publicação de sua 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 de Ferramentas de Contêiner do Visual Studio