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, uma assinatura do Azure. Inscreva-se em uma avaliação gratuita.

Suporte ao Docker no Visual Studio

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

O suporte ao Docker no Visual Studio foi alterado ao longo das 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 conforme o tipo de projeto e a versão do Visual Studio. Com alguns tipos de projeto com suporte, adicione o suporte do Docker se você quiser apenas um contêiner para um único projeto, sem o uso de orquestração. O próximo nível é o suporte à orquestração de contêiner, que adiciona os arquivos de suporte apropriados para o orquestrador específico que você escolher.

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 posteriores, a janela Contêineres está disponível, permitindo 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, uma assinatura do Azure. Inscreva-se em uma avaliação gratuita.

Suporte ao Docker no Visual Studio

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

O suporte ao Docker no Visual Studio foi alterado ao longo das versões em resposta às necessidades dos clientes. Existem diversas maneiras de adicionar suporte ao Docker em um projeto, e as opções compatíveis variam conforme o tipo de projeto e a versão do Visual Studio. Com alguns tipos de projeto com suporte, adicione o suporte do Docker se você quiser apenas um contêiner para um único projeto, sem o uso de orquestração. O próximo nível é o suporte à orquestração de contêiner, que adiciona os arquivos de suporte apropriados para o orquestrador específico que você escolher.

A partir da versão 17.9 do Visual Studio 2022, ao adicionar suporte ao Docker em projetos .NET 7 ou mais recentes, você pode escolher entre dois tipos de build de contêiner para adicionar suporte ao Docker. Você pode optar por adicionar um Dockerfile para especificar como criar as imagens de contêiner, ou usar o suporte integrado ao contêiner fornecido pelo SDK do .NET.

Além disso,com o Visual Studio 2022 em diante,ao escolher um contêiner de orquestração, você pode usar o Docker Compose ou o Service Fabric como serviço de orquestração de contêineres.

No Visual Studio 2022, a janela Contêineres está disponível, permitindo 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.

Adicionar suporte ao Docker

Ao adicionar ou habilitar 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 recebeu o nome WebApplication-Docker e 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 do Azure Functions.

Na versão 17.11 e posterior, você também pode especificar a Distribuição de Imagem de Contêiner e o Contexto de Compilação do Docker.

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

As seguintes imagens estão disponíveis:

Windows:

• Windows Nano Server (recomendado, disponível apenas na versão 8.0 e posterior, não predefinido para projetos de implantação AOT (Native Ahead-of-time))
• Windows Server Core (disponível somente na versão 8.0 e posterior)

Linux:

• Padrão (Debian, mas a tag é "8.0")
• Debian
• Ubuntu
• Chiseled Ubuntu
• Alpine

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

Se optar pelo 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 recebeu o nome WebApplication-Docker e 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"]

Adicionar suporte ao Docker usando a opção SDK do .NET

A partir da versão 17.9 do Visual Studio 2022 com o SDK do .NET 7 instalado, projetos do ASP.NET Core destinados ao .NET 6 ou posterior podem usar o suporte interno do SDK do .NET para builds de contêiner, eliminando a necessidade de um Dockerfile; confira Conteinerizar um aplicativo .NET com o dotnet publish. Em vez disso, você configura os 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 do .NET como tipo de compilação de contêiner para usar o gerenciamento de contêineres do SDK do .NET em vez de um Dockerfile.

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

A entrada de build de contêiner do SDK do .NET no launchSettings.json se parece com o 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 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 Personalização do contêiner. Por exemplo, a Distribuição de Imagem de Contêiner é salva no arquivo de projeto como a propriedade ContainerBaseImage. Você pode alterá-la posteriormente editando o arquivo de projeto.

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