Публикация приложения ASP.NET Core в Azure с помощью Visual Studio Code

С помощью этого руководства вы узнаете, как создать приложение MVC ASP.Net Core и развернуть его в Visual Studio Code. В этом руководстве предполагается, что вы умеете работать с VS Code. Дополнительные сведения см. в статье Начало работы с VS Code. Этот учебник применим к средам Windows, macOS или Linux. Обязательно используйте правильные символы-разделители пути (\, а не /) для вашей среды.

В статье Устранение неполадок ASP.NET Core в Службе приложений Azure и IIS описывается устранение проблемы с развертыванием Службы приложений.

Prerequisites

• Подписка Azure. Создайте бесплатную учетную запись Azure, если у вас ее нет.
• .NET SDK (latest stable release).
• Visual Studio Code.
  • C# Extension.
  • Расширение Службы приложений Azure. Прежде чем продолжить, используйте расширение для входа в Azure.

Создайте проект ASP.Net Core MVC

1. Open the integrated terminal.

2. Задайте в качестве рабочего каталога (cd) тот каталог, который будет содержать проект.

3. Выполните следующие команды:

   dotnet new mvc -o MyMVCapp
   code -r MyMVCapp
   

   Предыдущие команды:

   • dotnet new mvc -o MyMVCapp
     • Creates a new ASP.NET Core MVC project in the MyMVCapp folder.
   • code -r MyMVCapp
     • Загружает файл проекта MyMVCapp.csproj в Visual Studio Code.
     • Visual Studio Code обновляет интегрированный терминал в каталоге проекта.

A new ASP.NET Core MVC project is created in a MyMVCapp folder with a structure similar to the following:

      appsettings.Development.json
      appsettings.json
<DIR> bin
<DIR> Controllers
<DIR> Models
      MyMVCapp.csproj
<DIR> obj
      Program.cs
<DIR> Properties
<DIR> Views
<DIR> wwwroot

Папка .vscode будет создана в структуре проекта. Она будет содержать служебные файлы, которые помогут вам создавать и отлаживать веб-приложение ASP.NET Core.

Тестирование проекта

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

1. Open the integrated terminal (if needed).

2. Настройте доверенный сертификат разработки HTTPS:

   • Настройте доверие сертификату разработки HTTPS с помощью следующей команды:

     dotnet dev-certs https --trust
     

     Для предыдущей команды требуется пакет SDK для .NET 9 или более поздней версии в Linux. Для Linux в SDK .NET 8.0.401 или более ранней версии обратитесь к документации вашего дистрибутива Linux, чтобы доверять сертификату.

     Приведенная выше команда отображает следующее диалоговое окно, если сертификат не был ранее доверенным:

     

   • Select Yes if you agree to trust the development certificate.

     Дополнительные сведения см. в разделе "Доверие сертификату разработки ASP.NET Core HTTPS" статьи "Принудительное применение SSL".

   Сведения о доверии к браузеру Firefox см. в разделе Ошибка сертификата браузера Firefox SEC_ERROR_INADEQUATE_KEY_USAGE.

3. Выполните следующую команду:

   dotnet run
   

   Предыдущая команда:

   • Запускает Kestrel, встроенный веб-сервер ASP.NET Core.
   • Отображает URL-адрес для тестирования веб-приложения, например http://localhost:<port>, где <port> — это случайный номер порта, заданный в Properties\launchSettings.json при создании проекта.

   В выходных данных отображаются сообщения, подобные приведенным ниже, указывающие на то, что приложение запущено и ожидает запросов:

   $ dotnet run
   Building...
   info: Microsoft.Hosting.Lifetime[14]
       Now listening on: https://localhost:7064
   info: Microsoft.Hosting.Lifetime[14]
       Now listening on: http://localhost:5119
   info: Microsoft.Hosting.Lifetime[0]
       Application started. Press Ctrl+C to shut down.
   info: Microsoft.Hosting.Lifetime[0]
       Hosting environment: Development
   info: Microsoft.Hosting.Lifetime[0]
       Content root path: D:\Src\MyMVCapp\
   

4. Ctrl+click the HTTPS URL in the output to test the web app in a browser. В приведенном выше примере URL-адрес — https://localhost:7064.

5. Press Ctrl+C in the integrated terminal to shut down the web app after testing it.

Создание пакета развертывания локально

1. Во встроенном терминале используйте следующую команду, чтобы создать пакет Release в папке, расположенной по адресу bin/Publish:

   dotnet publish -c Release -o ./bin/Publish
   

   В папке Publish будет создана новая вложенная папка bin. Эта папка содержит файлы для развертывания в Azure.

   

Публикация в Службе приложений Azure

Используя расширение службы приложений Azure для Visual Studio Code, выполните следующие действия, чтобы опубликовать веб-сайт непосредственно в службе приложений Azure.

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

Если у вас нет ресурса веб-приложения Azure для публикации, необходимо создать его.

1. In the Azure extension tab, in the RESOURCES pane, expand the subscription you wish to use.
2. Right-click App Services and select Create New Web App....
3. Следуйте инструкциям.
   1. Введите уникальное имя для веб-приложения.
   2. Выберите последнюю стабильную среду выполнения .NET (например, .NET 6 (LTS)). Не выбирайте среду выполнения ASP.NET, предназначенную для приложений платформы .NET Framework.
   3. Выберите ценовую категорию. Бесплатный (F1) приемлем для этого учебника.

Публикация в Azure

1. Щелкните папку bin\Publish правой кнопкой мыши, выберите Deploy to Web App... и следуйте инструкциям.

   1. Выберите подписку, в которой расположен ресурс веб-приложения Azure.
   2. Выберите ресурс веб-приложения Azure, в котором вы будете размещать публикацию.
   3. Select Deploy when prompted with a confirmation dialog.

2. После завершения развертывания щелкните Browse Website, чтобы проверить развертывание.

   

   После нажатия кнопки Browse Website вы перейдете к веб-сайту с помощью браузера по умолчанию:

   

Next steps

• Создание первого конвейера DevOps в Azure

Additional resources

• Служба приложений Azure
• группы ресурсов Azure.