Ferramentas de Contêiner do Visual Studio para Docker

Pré-requisitos

• Docker Desktop
• Visual Studio 2019 com Desenvolvimento para a Web, a carga de trabalho de Ferramentas do Azure e/ou Desenvolvimento multiplataforma do .NET Core instalados
• Ferramentas de Desenvolvimento do .NET Core para desenvolvimento com .NET Core.
• Para publicar no Registro de Contêiner do Azure, é necessária uma assinatura do Azure. Inscreva-se para um teste gratuito.

Suporte do Docker no Visual Studio

O suporte do Docker está disponível para projetos ASP.NET, projetos do ASP.NET Core e projetos de console do .NET Core e do .NET Framework.

O suporte para o Docker no Visual Studio foi alterado ao longo de várias versões em resposta às necessidades dos clientes. Há dois níveis de suporte do Docker que você pode adicionar 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 com suporte, 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 escolhido.

Com o Visual Studio 2019, você pode usar o Docker Compose, o Kubernetes e o Service Fabric como serviços de orquestração de contêiner.

No Visual Studio 2019 versão 16.4 e posterior, a janela Contêineres está disponível, o 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. Confira Usar a janela Contêineres.

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, é necessária uma assinatura do Azure. Inscreva-se para uma versão de avaliação gratuita.

Suporte do Docker no Visual Studio

O suporte do Docker está disponível para projetos ASP.NET, projetos do ASP.NET Core e projetos de console do .NET Core e do .NET Framework.

O suporte para o Docker no Visual Studio foi alterado ao longo de diversas versões em resposta às necessidades dos clientes. 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 com suporte, 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 escolhido.

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 build 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 interno de contêiner fornecido pelo SDK do .NET.

Além disso, com o Visual Studio 2022 e posterior, quando você escolhe a orquestração de contêiner, pode usar o Docker Compose ou o Service Fabric como serviços de orquestração de contêiner.

No Visual Studio 2022, a janela de contêineres está disponível, permitindo que você visualize contêineres em execução, procure imagens disponíveis, veja variáveis de ambiente, logs e mapeamentos de porta, inspecione o sistema de arquivos, conecte um depurador ou abra uma janela de terminal dentro do ambiente do contêiner. Confira Usar a janela Contêineres.

Adicionar suporte ao Docker

Quando você adiciona ou habilita o suporte ao Docker, o Visual Studio adiciona o seguinte ao projeto:

• um arquivo Dockerfile
• um arquivo .dockerignore
• uma referência de pacote do NuGet para o Microsoft.VisualStudio.Azure.Containers.Tools.Targets

O Dockerfile adicionado será semelhante ao código a seguir. Neste exemplo, o projeto foi nomeado WebApplication-Dockere você escolheu contêineres do Linux:

#See https://aka.ms/containerfastmode to understand how Visual Studio uses this Dockerfile to build your images for faster debugging.

FROM mcr.microsoft.com/dotnet/aspnet:3.1 AS base
WORKDIR /app
EXPOSE 80
EXPOSE 443

FROM mcr.microsoft.com/dotnet/sdk:3.1 AS build
WORKDIR /src
COPY ["WebApplication-Docker/WebApplication-Docker.csproj", "WebApplication-Docker/"]
RUN dotnet restore "WebApplication-Docker/WebApplication-Docker.csproj"
COPY . .
WORKDIR "/src/WebApplication-Docker"
RUN dotnet build "WebApplication-Docker.csproj" -c Release -o /app/build

FROM build AS publish
RUN dotnet publish "WebApplication-Docker.csproj" -c Release -o /app/publish

FROM base AS final
WORKDIR /app
COPY --from=publish /app/publish .
ENTRYPOINT ["dotnet", "WebApplication-Docker.dll"]

Adicionar suporte ao Docker usando o tipo de build de contêiner do Dockerfile

Quando você adiciona ou habilita o suporte ao Docker em um projeto .NET 7 ou posterior, o Visual Studio mostra a caixa de diálogo Opções de Scaffolding de Contêiner, permitindo escolher a opção de sistema operacional (Linux ou Windows) e o tipo de build de contêiner, seja Dockerfile ou SDK do .NET. Essa caixa de diálogo não aparece em projetos do .NET Framework ou projetos do Azure Functions.

Nas versões 17.11 e posteriores, você também pode especificar a Distribuição de Imagem de Contêiner e o Contexto de Build do Docker.

Distribuição de Imagem de Contêiner especifica qual imagem do sistema operacional os contêineres usam como a imagem base. Essa lista será alterada se você alternar entre o Linux e o Windows como o tipo de contêiner.

As seguintes imagens estão disponíveis:

Windows:

• Windows Nano Server (recomendado, disponível apenas para 8.0 e posteriores, não predefinido para projetos de implantação nativa AOT (Ahead-of-Time))
• Windows Server Core (disponível apenas 8.0 e posterior)

Linux:

• Padrão (Debian, só que a etiqueta é "8.0")
• Debian
• Ubuntu
• Chiseled Ubuntu
• Alpino

O Contexto de Build do Docker especifica a pasta usada para o build do Docker. Confira Contexto de build do Docker. O padrão é a pasta da solução, que é altamente recomendada. Todos os arquivos necessários para um build precisam estar nessa pasta, o que geralmente não é o caso se você escolher a pasta do projeto ou alguma outra pasta.

Se você escolher Dockerfile, o Visual Studio adicionará o seguinte ao projeto:

• um arquivo Dockerfile
• um arquivo .dockerignore
• uma referência de pacote do NuGet para o Microsoft.VisualStudio.Azure.Containers.Tools.Targets

O Dockerfile adicionado será semelhante ao código a seguir. Neste exemplo, o projeto foi nomeado WebApplication-Dockere você escolheu contêineres do Linux:

#See https://aka.ms/containerfastmode to understand how Visual Studio uses this Dockerfile to build your images for faster debugging.

FROM mcr.microsoft.com/dotnet/aspnet:6.0 AS base
WORKDIR /app
EXPOSE 80
EXPOSE 443

FROM mcr.microsoft.com/dotnet/sdk:6.0 AS build
WORKDIR /src
COPY ["WebApplication-Docker/WebApplication-Docker.csproj", "WebApplication-Docker/"]
RUN dotnet restore "WebApplication-Docker/WebApplication-Docker.csproj"
COPY . .
WORKDIR "/src/WebApplication-Docker"
RUN dotnet build "WebApplication-Docker.csproj" -c Release -o /app/build

FROM build AS publish
RUN dotnet publish "WebApplication-Docker.csproj" -c Release -o /app/publish

FROM base AS final
WORKDIR /app
COPY --from=publish /app/publish .
ENTRYPOINT ["dotnet", "WebApplication-Docker.dll"]

Conteinerizar um aplicativo .NET sem um Dockerfile

Com o Visual Studio 2022 17.9 e posterior com o SDK do .NET 7 instalado, em projetos do ASP.NET Core destinados ao .NET 6 ou posterior, você tem a opção de usar o suporte interno do SDK do .NET para builds de contêineres, o que significa que você não precisa de um Dockerfile; consulte Conteinerizar um aplicativo .NET com dotnet publish. Em vez disso, você configura seus contêineres usando as propriedades do MSBuild no arquivo de projeto e as configurações para iniciar os contêineres com o Visual Studio são codificadas em um arquivo de configuração .json, launchSettings.json.

Aqui, escolha SDK .NET como o tipo de build de contêiner para usar o gerenciamento de contêiner do SDK .NET em vez de usar um Dockerfile.

Distribuição de Imagem de Contêiner especifica qual imagem do sistema operacional os contêineres usam como a imagem base. Essa lista será alterada se você alternar entre o Linux e o Windows como o contêiner. Consulte a seção anterior para obter uma lista de imagens disponíveis.

A entrada de construção de contêiner do SDK do .NET no launchSettings.json se assemelha ao seguinte código:

"Container (.NET SDK)": {
  "commandName": "SdkContainer",
  "launchBrowser": true,
  "launchUrl": "{Scheme}://{ServiceHost}:{ServicePort}",
  "environmentVariables": {
    "ASPNETCORE_HTTPS_PORTS": "8081",
    "ASPNETCORE_HTTP_PORTS": "8080"
  },
  "publishAllPorts": true,
  "useSSL": true
}

O SDK do .NET gerencia algumas das configurações que teriam sido codificadas em um Dockerfile, como a imagem base do contêiner e as variáveis de ambiente a serem definidas. As configurações disponíveis no arquivo de projeto para configuração de contêiner são listadas em Personalizando seu contêiner. Por exemplo, a Distribuição de Imagem de Contêiner é salva no arquivo de projeto como a propriedade ContainerBaseImage. Você pode alterá-lo posteriormente editando o arquivo de projeto.

<PropertyGroup>
    <ContainerBaseImage>mcr.microsoft.com/dotnet/runtime:8.0-alpine-amd64</ContainerBaseImage>
</PropertyGroup>