Использование средств Visual Studio для работы с контейнерами для Docker

Необходимые компоненты

• Docker Desktop
• Visual Studio 2019 с рабочей нагрузкой Веб-разработка, Средства Azure и (или) Кроссплатформенная разработка .NET Core.
• Средства разработки .NET Core для разработки с использованием .NET Core.
• Для публикации в Реестр контейнеров Azure требуется подписка Azure. Зарегистрируйтесь для получения бесплатной пробной версии.

Поддержка Docker в Visual Studio

Поддержка Docker доступна в проектах ASP.NET, ASP.NET Core и консольных проектах .NET Core и .NET Framework.

Поддержка Docker в Visual Studio оптимизировалась с каждым выпуском программы с учетом пожеланий пользователей. Есть два уровня поддержки Docker, которые можно добавить в проект. Набор поддерживаемых возможностей зависит от типа проекта и версии Visual Studio. Если вам необходим контейнер для работы над отдельным проектом, а не оркестрация, для некоторых типов проектов можно просто добавить поддержку Docker. Следующий уровень — это поддержка оркестрации контейнеров, в рамках которой добавляются соответствующие файлы поддержки для определенного оркестратора по выбору.

В Visual Studio 2019 в качестве служб оркестрации контейнеров можно использовать Docker Compose, Kubernetes и Service Fabric.

В Visual Studio 2019 версии 16.4 и более поздних версиях доступно окно Контейнеры, которое позволяет просматривать запущенные контейнеры, доступные образы, переменные среды, журналы и сопоставления портов, проверять файловую систему, подключать отладчик или открывать окно терминала в среде контейнера. См. Использование окна "Контейнеры".

Необходимые компоненты

• Docker Desktop
• Visual Studio 2022 с установленной рабочей нагрузкой Веб-разработка, Azure Tools и (или) Разработка классических приложений .NET
• Для публикации в Реестр контейнеров Azure требуется подписка Azure. Зарегистрируйтесь для получения бесплатной пробной версии.

Поддержка Docker в Visual Studio

Поддержка Docker доступна в проектах ASP.NET, ASP.NET Core и консольных проектах .NET Core и .NET Framework.

Поддержка Docker в Visual Studio оптимизировалась с каждым выпуском программы с учетом пожеланий пользователей. Существует несколько вариантов добавления поддержки Docker в проект, а поддерживаемые параметры зависят от типа проекта и версии Visual Studio. Если вам необходим контейнер для работы над отдельным проектом, а не оркестрация, для некоторых типов проектов можно просто добавить поддержку Docker. Следующий уровень — это поддержка оркестрации контейнеров, в рамках которой добавляются соответствующие файлы поддержки для определенного оркестратора по выбору.

В Visual Studio 2022 версии 17.9 и более поздних версий при добавлении поддержки Docker в проект .NET 7 или более поздней версии можно выбрать два типа сборки контейнеров для добавления поддержки Docker. Можно добавить Dockerfile, чтобы указать, как создавать образы контейнеров или использовать встроенную поддержку контейнеров, предоставляемую пакетом SDK для .NET.

Кроме того, в Visual Studio 2022 и более поздних версиях при выборе оркестрации контейнеров можно использовать Docker Compose или Service Fabric в качестве служб оркестрации контейнеров.

В Visual Studio 2022 доступно окно Контейнеры, которое позволяет просматривать запущенные контейнеры, доступные образы, переменные среды, журналы и сопоставления портов, проверять файловую систему, подключать отладчик и открывать окно терминала в среде контейнера. См. Использование окна "Контейнеры".

Добавление поддержки Docker

При добавлении или включении поддержки Docker Visual Studio добавляет в проект следующее:

• файл Dockerfile;
• .dockerignore файл
• ссылку пакета NuGet на Microsoft.VisualStudio.Azure.Containers.Tools.Targets.

Добавляемый Dockerfile будет похож на следующий код. В этом примере проект был назван WebApplication-Docker, и вы выбрали контейнеры 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"]

Добавление поддержки Docker с помощью типа сборки контейнера Dockerfile

При добавлении или включении поддержки Docker в проект .NET 7 или более поздней версии Visual Studio отображает диалоговое окно "Параметры шаблонов контейнеров", которое дает выбор операционной системы (Linux или Windows), но также возможность выбрать тип сборки контейнера, Dockerfile или пакет SDK для .NET. Это диалоговое окно не отображается в платформа .NET Framework проектах или Функции Azure проектах.

В версии 17.11 и более поздних версий можно также указать дистрибутив образа контейнера и контекст сборки Docker.

Дистрибутив образа контейнера указывает, какой образ ОС используется в качестве базового образа. Этот список изменяется при переключении между Linux и Windows в качестве типа контейнера.

Доступны следующие изображения:

Windows:

• Windows Nano Server (рекомендуется только 8.0 и более поздних версий, а не предустановлен для проектов развертывания в машинном коде (AOT)
• Windows Server Core (доступно только 8.0 и более поздней версии)

Linux:

• По умолчанию (Debian, но тег имеет значение "8.0")
• Debian
• Ubuntu
• Chiseled Ubuntu
• Алпайн

Контекст сборки Docker указывает папку, используемую для сборки Docker. См . контекст сборки Docker. По умолчанию используется папка решения, которая настоятельно рекомендуется. Все файлы, необходимые для сборки, должны находиться в этой папке, что обычно не так, если выбрать папку проекта или другую папку.

Если выбрать Dockerfile, Visual Studio добавляет в проект следующее:

• файл Dockerfile;
• файл .dockerignore;
• ссылку пакета NuGet на Microsoft.VisualStudio.Azure.Containers.Tools.Targets.

Добавляемый Dockerfile будет похож на следующий код. В этом примере проект был назван WebApplication-Docker, и вы выбрали контейнеры 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"]

Контейнеризация приложения .NET без Dockerfile

С помощью Visual Studio 2022 17.9 и более поздних версий с установленным пакетом SDK для .NET 7 в проектах ASP.NET Core, предназначенных для .NET 6 или более поздней версии, вы можете использовать встроенную поддержку пакета SDK для контейнеров .NET, что означает, что вам не нужен Dockerfile; См. статью "Контейнеризация приложения .NET с помощью dotnet publish". Вместо этого вы настраиваете контейнеры с помощью свойств MSBuild в файле проекта, а параметры запуска контейнеров с помощью Visual Studio кодируются в .json файле конфигурации launchSettings.json.

Здесь выберите пакет SDK для .NET в качестве типа сборки контейнера, чтобы использовать управление контейнерами пакета SDK для .NET вместо Dockerfile.

Дистрибутив образа контейнера указывает, какой образ ОС используется в качестве базового образа. Этот список изменяется при переключении между Linux и Windows в качестве контейнера. Список доступных изображений см. в предыдущем разделе.

Запись сборки контейнера пакета SDK для .NET в launchSettings.json выглядит следующим образом:

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

Пакет SDK для .NET управляет некоторыми параметрами, которые были бы закодированы в Dockerfile, таких как базовый образ контейнера, и переменные среды для задания. Параметры, доступные в файле проекта для конфигурации контейнера, перечислены при настройке контейнера. Например, дистрибутив образа контейнера сохраняется в файле проекта в качестве ContainerBaseImage свойства. Вы можете изменить его позже, изменив файл проекта.

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