Nota
O acesso a esta página requer autorização. Podes tentar iniciar sessão ou mudar de diretório.
O acesso a esta página requer autorização. Podes tentar mudar de diretório.
As ferramentas incluídas no Visual Studio para desenvolvimento com contêineres Docker ou Podman simplificam muito a criação, depuração e implantação de aplicativos em contêineres. Você pode trabalhar com um contêiner para um único projeto ou usar a orquestração de contêineres com o Docker Compose.
As ferramentas incluídas no Visual Studio para desenvolvimento com contêineres do Docker simplificam muito a criação, depuração e implantação de aplicativos em contêineres. Você pode trabalhar com um contêiner para um único projeto ou usar a orquestração de contêineres com o Docker Compose ou o Service Fabric para trabalhar com vários serviços em contêineres.
Pré-requisitos
- Docker Desktop ou Podman Desktop
- Visual Studio ou, para suporte ao Podman, Visual Studio 2026, com a carga de trabalho de desenvolvimento ASP.NET e web, carga de trabalho de desenvolvimento do Azure e/ou carga de trabalho de desenvolvimento de desktop .NET instalada.
- Para publicar no Registo de Contêiner do Azure, é necessária uma assinatura do Azure. Inscreva-se para uma avaliação gratuita.
Suporte a contêineres no Visual Studio
O suporte a contêineres está disponível para projetos ASP.NET Core e projetos de console do .NET Core (e .NET 5 e posteriores). Projetos do .NET Framework não são suportados na versão atual do Visual Studio.
Se você quiser apenas um contêiner para um único projeto, sem usar orquestração, você pode fazer isso adicionando suporte a contêiner. Você pode escolher Docker ou Podman como uma plataforma de contêiner e alternar facilmente entre eles sem alterar o projeto. O próximo nível é o suporte a Composição de Contêiner, que adiciona arquivos de suporte apropriados para o Docker Compose. (O Podman Compose não é suportado.)
Quando você adiciona suporte de contêiner a um projeto .NET 7 ou posterior, você tem dois tipos de compilação de contêiner para escolher para adicionar suporte a contêiner. Você pode optar por adicionar um Dockerfile para especificar como criar as imagens de contêiner ou pode optar por usar o suporte de contêiner interno fornecido pelo SDK do .NET.
A janela Contêineres permite visualizar contêineres em execução, procurar imagens disponíveis, exibir variáveis de ambiente, logs e mapeamentos de portas, inspecionar o sistema de arquivos, anexar um depurador ou abrir uma janela de terminal dentro do ambiente de contêiner. Consulte a janela de contêineres.
Pré-requisitos
- Área de trabalho do Docker
- Visual Studio. Para suporte ao Podman, o Visual Studio 2026 com a carga de trabalho ASP.NET e desenvolvimento web, desenvolvimento Azure e/ou desenvolvimento desktop .NET instalada.
- Para publicar no Registo de Contêiner do Azure, é necessária uma assinatura do Azure. Inscreva-se para uma avaliação gratuita.
Suporte ao Docker no Visual Studio
O suporte ao Docker está disponível para projetos ASP.NET, projetos ASP.NET Core e projetos de console do .NET Core e do .NET Framework.
O suporte para Docker no Visual Studio foi alterado ao longo de várias versões em resposta às necessidades do cliente. Há várias opções para adicionar suporte ao Docker a um projeto, e as opções com suporte variam de acordo com o tipo de projeto e a versão do Visual Studio. Com alguns tipos de projeto suportados, se você quiser apenas um contêiner para um único projeto, sem usar orquestração, poderá fazer isso adicionando suporte ao Docker. O próximo nível é o suporte à orquestração de contêineres, que adiciona arquivos de suporte apropriados para o orquestrador específico que você escolher.
Com o Visual Studio 2022 versão 17.9 e posterior, quando você adiciona suporte ao Docker a um projeto .NET 7 ou posterior, você tem dois tipos de compilação de contêiner para escolher para adicionar suporte ao Docker. Você pode optar por adicionar um Dockerfile para especificar como criar as imagens de contêiner ou pode optar por usar o suporte de contêiner interno fornecido pelo SDK do .NET.
Além disso, com o Visual Studio 2022 e posterior, ao escolher orquestração de contêiner, você pode usar o Docker Compose ou o Service Fabric como serviços de orquestração de contêiner.
No Visual Studio 2022, a janela Contêineres está disponível, que permite exibir contêineres em execução, procurar imagens disponíveis, exibir variáveis de ambiente, logs e mapeamentos de porta, inspecionar o sistema de arquivos, anexar um depurador ou abrir uma janela de terminal dentro do ambiente de contêiner. Consulte a janela de contêineres.
Para criar um projeto com suporte a contêiner ou adicionar suporte a contêiner a um projeto existente, consulte Adicionar suporte para contêineres.
Para criar um projeto com suporte ao Docker ou adicionar suporte ao Docker a um projeto existente, consulte Adicionar suporte para contêineres.
Observação
Os requisitos de licenciamento do Docker podem ser diferentes para diferentes versões do Docker Desktop. Consulte a documentação Docker para entender os requisitos de licenciamento atuais para usar a sua versão do Docker Desktop para desenvolvimento na sua situação.
Suporte ao Podman no Visual Studio
O Visual Studio oferece suporte a contêineres Podman, uma ferramenta popular de gerenciamento de contêineres que fornece um mecanismo de contêiner sem daemon. Você pode executar e gerenciar contêineres usando a CLI do Podman diretamente do Visual Studio. Você pode usar o Podman para executar seus aplicativos de contêiner único da mesma forma que o Docker.
Para usar contêineres do Podman, inicie o podman a partir da CLI e abra sua solução no Visual Studio. Por padrão, as Ferramentas de Contêiner detetam automaticamente se o Podman ou o Docker estão em execução e usam o tempo de execução do contêiner atualmente ativo quando você inicia o aplicativo. Para configurar manualmente o runtime do container, vá para Ferramentas > Opções > Ferramentas de Contêiner > Tempo de Execução de Container e selecione Podman ou Docker. A configuração padrão é Auto, o que significa que o Visual Studio tenta detetar o tempo de execução do contêiner ativo no momento. Feche a janela Opções de ferramentas > para confirmar a alteração de configuração.
Janela de Contentores
A janela Containers permite visualizar contentores e imagens no seu computador e ver o que está a acontecer com eles. Você pode visualizar o sistema de arquivos, os volumes montados, as variáveis de ambiente, as portas usadas e examinar os arquivos de log.
Abra a janela Containers usando o início rápido (Ctrl+Q) e digitando containers. Você pode usar os controles de encaixe para colocar a janela em algum lugar. Devido à largura da janela, ele funciona melhor quando encaixado na parte inferior da tela.
Selecione um contêiner e use as guias para exibir as informações disponíveis. Para fazer check-out, execute seu aplicativo habilitado para Docker, abra a guia Arquivos e expanda a pasta aplicativo para ver seu aplicativo implantado no contêiner.
Para obter mais informações, consulte janela Usar os contêineres.
Suporte ao Docker Compose
Quando quiser compor uma solução de vários contêineres usando o Docker Compose, adicione suporte ao orquestrador de contêineres aos seus projetos. Isso permite executar e depurar um grupo de contêineres (uma solução inteira ou um grupo de projetos) ao mesmo tempo se eles estiverem definidos no mesmo arquivo docker-compose.yml.
Para adicionar suporte ao Container Orchestrator usando o Docker Compose, clique com o botão direito na aplicação no Explorador de Soluções e depois selecione Adicionar>Suporte à Composição de Contentores.
Para adicionar suporte para orquestração de contentores usando o Docker Compose, clique com o botão direito do rato no nó do projeto em Gerenciador de Soluçõese escolha Adicionar > Suporte para Orquestração de Contentores. Em seguida, escolha Docker Compose para gerenciar os contêineres.
Depois de adicionar suporte ao orquestrador de contentores ao seu projeto, verá um Dockerfile adicionado ao projeto (se ainda não houver um) e uma pasta docker-compose adicionada à solução no Explorador de Soluções, conforme mostrado aqui:
Se docker-compose.yml já existir, o Visual Studio apenas adiciona as linhas necessárias de código de configuração a ele.
Repita o processo com os outros projetos que você deseja controlar usando o Docker Compose.
Se você trabalha com um grande número de serviços, pode economizar tempo e recursos de computação selecionando qual subconjunto de serviços deseja iniciar em sua sessão de depuração. Consulte Iniciar um subconjunto de Serviços de composição.
Observação
Os hosts remotos do Docker não são suportados nas ferramentas do Visual Studio.
Suporte ao Service Fabric
Os projetos de aplicativo do Service Fabric foram removidos no Visual Studio 2026 e se tornarão uma extensão do Visual Studio. Para obter o status sobre disponibilidade, consulte este problema do GitHub.
Com as ferramentas do Service Fabric no Visual Studio, você pode desenvolver e depurar para o Azure Service Fabric, executar e depurar localmente e implantar no Azure.
O Visual Studio 2019 e o Visual Studio 2022 suportam o desenvolvimento de microserviços containerizados usando contentores Windows e orquestração do Service Fabric.
Para obter um tutorial detalhado, consulte Tutorial: Implantar um aplicativo .NET em um contêiner do Windows no Azure Service Fabric.
Para obter mais informações sobre o Azure Service Fabric, consulte Service Fabric.
Entrega contínua e integração contínua (CI/CD)
O Visual Studio integra-se prontamente com o Azure Pipelines para integração automatizada e contínua e entrega de alterações ao seu código de serviço e configuração. Para começar, consulte Crie o seu primeiro pipeline.
Para o Service Fabric, consulte Tutorial: Implantar seu aplicativo ASP.NET Core no Azure Service Fabric usando o Azure DevOps Projects.
Próximos passos
Para obter mais detalhes sobre a implementação de serviços e o uso de ferramentas do Visual Studio para trabalhar com contêineres, leia os seguintes artigos:
Adicionar suporte para contêineres
Ferramentas de contêiner no Visual Studio
Depuração de aplicações num contentor local
Implantar um contêiner de ASP.NET em um registro de contêiner usando o Visual Studio
implantar no Serviço de Aplicativo do Azure
Implantar em Aplicativos de Contêiner do Azure usando o Visual Studio