Отладка приложений в локальном контейнере Docker

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

В этой статье рассказывается, как запускать приложение в локальном контейнере Docker с помощью Visual Studio, вносить изменения и обновлять браузер для их отображения. В ней также показано, как устанавливать точки останова для отладки контейнерных приложений. Поддерживаемые типы проектов включают веб-приложение, консольное приложение и функцию Azure, предназначенные для платформа .NET Framework и .NET Core. Примеры, представленные в этой статье, — это проект типа ASP.NET Core Web App и проект консольного приложения (платформа .NET Framework).

Если у вас уже есть проект поддерживаемого типа, Visual Studio может создать Dockerfile и настроить проект для запуска в контейнере. Ознакомьтесь со статьей Средства для контейнеров в Visual Studio.

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

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

Для запуска контейнеров Docker локально требуется локальный клиент Docker. Вы можете использовать Docker Desktop. Для этого требуется Windows 10 или более поздней версии.

Создание веб-приложения.

Пропустите этот раздел, если у вас есть проект и вы добавили поддержку Docker, как описано в обзоре.

Изменение страниц Razor и обновление

Для быстрого изменения страниц Razor можно запустить приложение в контейнере. Затем продолжайте вносить изменения, просматривая их так же, как и в службы IIS (IIS).

1. Убедитесь, что Docker настроен для применения типа контейнера (Linux или Windows), который вы используете. На панели задач щелкните правой кнопкой мыши значок Docker и выберите пункт Switch to Linux containers (Переключиться на контейнеры Linux) или Switch to Windows containers (Переключиться на контейнеры Windows) в зависимости от ситуации.

2. Изменение кода и обновление работающего сайта, как описано в этом разделе, не включено в шаблонах по умолчанию в .NET Core и .NET 5 и более поздних версиях. Чтобы включить их, установить пакет NuGet Microsoft.AspNetCore.Mvc.Razor.RuntimeCompilation. Добавьте вызов метода расширения AddRazorRuntimeCompilation в код в методе Startup.ConfigureServices . Этот параметр необходим только в режиме ОТЛАДКИ, поэтому код будет следующим образом в методе Main :

   // Add services to the container.
   var mvcBuilder = builder.Services.AddRazorPages();
   #if DEBUG
       if (Env.IsDevelopment())
       {
           mvcBuilder.AddRazorRuntimeCompilation();
       }
   #endif
   

   Дополнительные сведения см. в статье Компиляция файла Razor в ASP.NET Core. Точный код может отличаться в зависимости от целевой платформы и используемого шаблона проекта.

3. В качестве конфигурации решения выберите Отладка. Затем нажмите клавиши CTRL+F5, чтобы создать образ Docker и запустить его локально.

   После сборки и запуска образа контейнера в контейнере Docker среда Visual Studio запустит веб-приложение в вашем браузере по умолчанию.

4. Перейдите на страницу Index (Индекс). Мы будем вносить на ней изменения.

5. Вернитесь в Visual Studio и откройте файл Index.cshtml.

6. Добавьте приведенное ниже содержимое HTML в конец файла и сохраните изменения.

   <h1>Hello from a Docker container!</h1>
   

7. Когда сборка .NET завершится и в окне вывода будут отображаться следующие строки, вернитесь в браузер и обновите страницу:

   Now listening on: http://*:80
   Application started. Press Ctrl+C to shut down.
   

Изменения применены!

Отладка с использованием точек останова

Изменения часто требуют дальнейшей проверки. Для этого можно использовать функции отладки Visual Studio.

1. В Visual Studio откройте файл Index.cshtml.cs.

2. Замените содержимое метода OnGet следующим кодом:

       ViewData["Message"] = "Your application description page from within a container";
   

3. Установите точку останова слева от строки кода.

4. Чтобы начать отладку и достичь точки останова, нажмите клавишу F5.

5. Переключитесь в Visual Studio, чтобы просмотреть точку останова. Проверьте значения.

   

   

Создание консольного приложения .NET Framework

Этот раздел содержит сведения о том, как выполнять отладку для проекта консольного приложения .NET Framework в локальном контейнере Docker, вначале описывая, как обеспечить поддержку Docker в проекте. Важно понимать, что проекты разных типов имеют разные уровни поддержки Docker. Существуют даже различные уровни поддержки Docker для проектов консольного приложения .NET Core (включая .NET 5 и более поздних версий) и для проектов консольного приложения .NET Framework.

При создании проекта консольного приложения .NET Framework нет возможности включить поддержку Docker. После создания такого проекта невозможно явно добавить поддержку Docker в проект. Для проекта консольного приложения .NET Framework можно обеспечить поддержку оркестрации контейнеров. Побочным эффектом добавления поддержки оркестрации в проект консольного приложения платформа .NET Framework является добавление поддержки Docker в проект.

Следующая процедура демонстрирует, как добавить поддержку оркестрации в проект консольного приложения .NET Framework, что впоследствии обеспечивает поддержку Docker и позволяет отлаживать проект в локальном контейнере Docker.

1. Создайте проект консольного приложения .NET Framework.
2. В обозревателе решений щелкните правой кнопкой мыши узел проекта и выберите Добавить>Container Orchestration Support (Поддержка оркестрации контейнеров). В появившемся диалоговом окне выберите Docker Compose. Файл Dockerfile будет добавлен в проект, а проект Docker Compose со вспомогательными файлами будет добавлен в решение.

Отладка с использованием точек останова

1. В обозревателе решений откройте файл Program.cs.

2. Замените содержимое метода Main следующим кодом:

       System.Console.WriteLine("Hello, world!");
   

3. Установите точку останова слева от строки кода.

4. Чтобы начать отладку и достичь точки останова, нажмите клавишу F5.

5. Переключитесь в Visual Studio, чтобы просмотреть точку останова и проверить значения.

   

# This layer is to support debugging, VS's Token Proxy requires the runtime to be installed in the container
FROM mcr.microsoft.com/dotnet/runtime:8.0 AS runtime
FROM base as debug
COPY --from=runtime /usr/share/dotnet /usr/share/dotnet
RUN ln -s /usr/share/dotnet/dotnet /usr/bin/dotnet

# Set the stage to debug to use an image with the .NET runtime in it
services:
  functionappintegrated:
    build:
      target: debug

Повторное использование контейнеров

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

Если вы вручную изменили контейнер и хотите выполнить перезапуск с чистым образом контейнера, выберите команду Сборка>Очистить, а затем выполните сборку как обычную.

Если вы не используете быстрый режим, типичный для конфигурации выпуска, Visual Studio перестраивает контейнер при каждом построении проекта.

Можно настроить, когда используется быстрый режим; См. инструкции по настройке средств контейнеров Visual Studio.

Устранение неполадок

Узнайте, как устранять неполадки при разработке Docker в Visual Studio.

Связанный контент

Дополнительные сведения см. в статье Как Visual Studio создает контейнерные приложения.

Дополнительные сведения об использовании Docker с Visual Studio, Windows и Azure

• Дополнительные сведения о разработке контейнеров с помощью Visual Studio.
• Сведения о сборке и развертывании контейнера Docker см. в статье Интеграция Docker для Azure Pipelines.
• Указатель статей, посвященных Windows Server и Nano Server, см. на странице Контейнеры в документации Windows.
• Ознакомьтесь с общими сведениями о Службе Azure Kubernetes и документацией по Службе Azure Kubernetes.