Краткое руководство. Развертывание веб-приложения ASP.NET

Если вы уже установили Visual Studio 2022:

1. Установите последние обновления для Visual Studio, выбрав Справка>Проверить обновления.
2. Добавьте рабочую нагрузку, выбрав Инструменты>Получить средства и компоненты.

• Учетная запись Azure с активной подпиской. Создайте учетную запись бесплатно .
• Visual Studio Code.
• Расширение Azure Tools.
• Последний пакет SDK для .NET 8.0.
• (Необязательно) Чтобы попробовать GitHub Copilot, учетная запись GitHub Copilot. Доступна 30-дневная бесплатная пробная версия.

• Учетная запись Azure с активной подпиской. Создайте учетную запись бесплатно .
• Интерфейс командной строки Azure.
• Последний пакет SDK для .NET 8.0.
• (Необязательно) Чтобы попробовать GitHub Copilot, учетная запись GitHub Copilot. Доступна 30-дневная бесплатная пробная версия.

• Учетная запись Azure с активной подпиской. Создайте учетную запись бесплатно .
• Azure PowerShell.
• Последний пакет SDK для .NET 8.0.

• Учетная запись Azure с активной подпиской. Создайте учетную запись бесплатно .
• Учетная запись GitHub Создайте учетную запись бесплатно.

• Учетная запись Azure с активной подпиской. Создайте учетную запись бесплатно .
• Интерфейс командной строки разработчика Azure
• Последний пакет SDK для .NET 8.0.

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

1. Инициализация шаблона веб-приложения ASP.NET

1. Откройте окно терминала на компьютере и перейдите в рабочую папку. Создайте новое веб-приложение .NET с помощью команды dotnet new webapp, а затем измените каталоги для только что созданного приложения.

   dotnet new webapp -n MyFirstAzureWebApp --framework net8.0
   cd MyFirstAzureWebApp
   

2. В том же сеансе терминала запустите приложение локально с помощью команды dotnet run.

   dotnet run --urls=https://localhost:5001/
   

3. Откройте веб-браузер и перейдите к приложению в https://localhost:5001.

   На странице отображается веб-приложение ASP.NET Core 8.0.

   

На этом шаге вы создайте демонстрационный проект для развертывания.

В этом кратком руководстве используется интерфейс командной строки разработчика Azure (azd) для создания ресурсов Azure и развертывания кода в нем. Дополнительные сведения о интерфейсе командной строки разработчика Azure см. в документации или пути обучения.

Получите и инициализировать шаблон веб-приложения ASP.NET Core для этого краткого руководства, выполнив следующие действия.

1. Откройте окно терминала на компьютере в пустой рабочий каталог. Инициализировать azd шаблон с помощью azd init команды.

   azd init --template https://github.com/Azure-Samples/quickstart-deploy-aspnet-core-app-service.git
   

   При появлении запроса на имя среды введите dev.

2. В том же сеансе терминала запустите приложение локально с помощью команды dotnet run. --project Используйте параметр, чтобы указать src каталог azd шаблона, который находится в коде приложения.

   dotnet run --project src --urls=https://localhost:5001/
   

3. Откройте веб-браузер и перейдите к приложению по адресу https://localhost:5001. На странице отображается шаблон веб-приложения ASP.NET Core 8.0.

   

1. Щелкните правой кнопкой мыши проект MyFirstAzureWebApp в Обозревателе решений и выберите Опубликовать.

2. В разделе Публикация выберите Azure и нажмите кнопку Далее.

   

3. Выберите Указанный целевой объект: Служба приложений Azure (Linux) или Служба приложений Azure (Windows). Затем выберите Далее.

   Внимание

   Если предполагается использовать ASP.NET Framework 4.8 вы используйте Службу приложений Azure (Windows).

4. Доступные параметры зависят от того, вошли ли вы в Azure и есть ли у вас учетная запись Visual Studio, связанная с учетной записью Azure. Выберите Добавить учетную запись или Войти, чтобы войти в подписку Azure. Если вы уже вошли, выберите нужную учетную запись.

   

5. Справа от списка Экземпляры Службы приложений выберите +.

   

6. Для параметра Подписка подтвердите предложенный вариант или выберите другой из раскрывающегося списка.

7. В разделе Группа ресурсов выберите Создать. В разделе Новое имя группы ресурсов введите myResourceGroup и щелкните ОК.

8. В разделе План размещения щелкните Создать.

9. В плане размещения: создайте диалоговое окно, введите значения, указанные в следующей таблице:

   Параметр	Предлагаемое значение	Description
   План размещения	MyFirstAzureWebAppPlan	Имя плана службы приложений.
   Местонахождение	Западная Европа	Центр обработки данных, где размещается веб-приложение.
   Размер	Выберите самый низкий уровень.	Ценовые категории определяют функции размещения.

10. В поле Имя введите уникальное имя приложения, включающее только допустимые символы: a-z, A-Z, 0-9 и -. Вы можете использовать автоматически созданное уникальное имя. URL-адрес веб-приложения: http://<app-name>.azurewebsites.net, где <app-name> — имя приложения.

11. Выберите Создать, чтобы создать ресурсы Azure.

    

    После завершения работы мастера будут созданы ресурсы Azure и готовы опубликовать проект ASP.NET Core.

12. В диалоговом окне "Публикация" убедитесь, что выбрано новое приложение Служба приложений, а затем нажмите кнопку "Готово", а затем нажмите кнопку "Закрыть". Visual Studio создаст профиль публикации для выбранного приложения Службы приложений.

13. На странице Публикация выберите Опубликовать. Если появилось сообщение с предупреждением нажмите кнопку Продолжить.

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

    • .NET 8.0
    • .NET Framework 4.8

    На странице отображается веб-приложение ASP.NET Core 8.0.

    

1. Откройте Visual Studio Code из корневого каталога проекта.

   code .
   

2. Если появится запрос, выберите "Да", я доверяю авторам.

   Совет

   Если у вас есть учетная запись GitHub Copilot, попробуйте получить функции GitHub Copilot для Visual Studio Code.

3. В Visual Studio Code откройте палитру команд, выбрав палитру команд представления.>

4. Найдите и выберите "Служба приложение Azure: создать веб-приложение (дополнительно)".

5. Ответьте на запросы следующим образом:

   1. Если отобразится запрос на вход в учетную запись Azure, выполните его.
   2. Выберите Подписка.
   3. Щелкните Создать веб-приложение... Дополнительно.
   4. В поле Введите глобально уникальное имя введите имя, которое еще не используется в Azure (допускаются символы a-z, 0-9 и -). Рекомендуется использовать сочетание названия компании и идентификатора приложения.
   5. Выберите Создать группу ресурсов и укажите имя, например myResourceGroup.
   6. При появлении запроса на выбор стека среды выполнения выберите .NET 8 (LTS).
   7. Выберите операционную систему (Windows или Linux):
   8. Выберите ближайшее расположение.
   9. Выберите "Создать новый план Служба приложений", укажите имя и выберите ценовую категорию "Бесплатный" (F1).
   10. Выберите Пропустить для ресурса Application Insights.
   11. При появлении запроса нажмите кнопку "Развернуть".
   12. Выберите для развертывания папку MyFirstAzureWebApp.
   13. При появлении запроса выберите Добавить конфигурацию.

6. Во всплывающем окне всегда развертывайте рабочую область "MyFirstAzureWebApp" в <app-name> , нажмите Да, чтобы Visual Studio Code развертывался в одном приложении службы приложений каждый раз, когда вы находитесь в этой рабочей области.

7. Когда публикация завершится, щелкните Обзор веб-сайта в открывшемся уведомлении и нажмите кнопку Открыть при появлении запроса.

   На странице отображается веб-приложение ASP.NET Core 8.0.

   

1. Войдите в учетную запись Azure с помощью команды az login и выполните следующий запрос:

   az login
   

   • Если команда az не распознается, проверьте, установили ли вы Azure CLI, как описано в разделе Предварительные требования.

2. Разверните код в локальном каталоге MyFirstAzureWebApp с помощью команды az webapp up:

   az webapp up --sku F1 --name <app-name> --os-type <os>
   

   • Замените <app-name> именем, уникальным для всех регионов Azure (допустимыми символами являются a-z, 0-9и -). Рекомендуется использовать сочетание названия компании и идентификатора приложения.
   • Аргумент --sku F1 создает веб-приложение с ценовой категорией Бесплатный. Этот аргумент можно опустить, чтобы использовать более быструю ценовую категорию "Премиум" с почасовой оплатой.
   • Измените <os> на linux или windows.
   • При необходимости вы можете использовать аргумент --location <location-name>, где <location-name> является доступным регионом Azure. Список допустимых регионов для учетной записи Azure можно получить, выполнив команду az account list-locations.

   Выполнение команды может занять несколько минут. Во время выполнения команда предоставляет сообщения о создании группы ресурсов, плане Служба приложений и размещении приложения, настройке ведения журнала, а затем выполнении развертывания ZIP. Затем отображается сообщение с URL-адресом приложения:

   You can launch the app at http://<app-name>.azurewebsites.net
   

3. Откройте браузер и перейдите по этому URL-адресу:

   На странице отображается веб-приложение ASP.NET Core 8.0.

   

1. Войдите в учетную запись Azure с помощью команды Connect-AzAccount и выполните следующий запрос:

   Connect-AzAccount
   

2. Создайте приложение с помощью команды New-AzWebApp:

   New-AzWebApp -ResourceGroupName myResourceGroup -Name <app-name> -Location westeurope
   

   • Замените <app-name> именем, уникальным для всех регионов Azure (допустимыми символами являются a-z, 0-9и -). Рекомендуется использовать сочетание названия компании и идентификатора приложения.
   • При необходимости вы можете использовать параметр -Location <location-name>, где <location-name> является доступным регионом Azure. Список допустимых регионов для учетной записи Azure можно получить, выполнив команду Get-AzLocation.

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

3. В корневой папке приложения подготовьте свое локальное приложение MyFirstAzureWebApp к развертыванию, выполнив команду dotnet publish:

   dotnet publish --configuration Release
   

4. Перейдите в каталог версии и создайте ZIP-файл из содержимого:

   cd bin\Release\net8.0\publish
   Compress-Archive -Path * -DestinationPath deploy.zip
   

5. Опубликуйте ZIP-файл в приложении Azure с помощью команды Publish-AzWebApp:

   Publish-AzWebApp -ResourceGroupName myResourceGroup -Name <app-name> -ArchivePath (Get-Item .\deploy.zip).FullName -Force
   

   Примечание.

   -ArchivePath нужно предоставить полный путь к ZIP-файлу.

6. Откройте браузер и перейдите по этому URL-адресу:

   На странице отображается веб-приложение ASP.NET Core 8.0.

   

1. В поле поиска введите службы приложений. В разделе Службы выберите Службы приложений.

   

2. На странице Служба приложений выберите "Создать>веб-приложение".

3. На вкладке Основные сведения задайте следующие параметры:

   • .NET 8.0
   • .NET Framework 4.8

   • Для параметра Группа ресурсов выберите Создать. Введите myResourceGroup в качестве имени.
   • В разделе Имя введите глобально уникальное имя веб-приложения.
   • В разделе Опубликовать выберите Код.
   • В стеке среды выполнения выберите .NET 8 (LTS).
   • В разделе "Операционная система" выберите Windows. Если выбрать Linux, вы не можете настроить развертывание GitHub на следующем шаге, но после создания приложения на странице Центра развертывания его можно сделать.
   • Выберите регион для обслуживания приложения.
   • В разделе Служба приложений План выберите "Создать" и введите myAppServicePlan для имени.
   • В разделе "Тарифный план" выберите "Бесплатный F1".

   

4. Выберите вкладку "Развертывание" в верхней части страницы

5. В разделе Параметров GitHub Actions установите для параметра "Включить непрерывное развертывание".

6. В разделе Сведения о GitHub Actions проверьте подлинность с помощью своей учетной записи GitHub и выберите следующие параметры:

   • .NET 8.0
   • .NET Framework 4.8

   • Для организации выберите организацию, в которой вы вилировали демонстрационный проект.
   • Для параметра Репозиторий выберите проект dotnetcore-docs-hello-world .
   • Для параметра "Ветвь " выберите main.

   

   Примечание.

   По умолчанию мастер создания отключает базовую проверку подлинности и развертывание GitHub Actions создается с помощью удостоверения, назначаемого пользователем. Если во время создания ресурса возникает ошибка разрешений, у вашей учетной записи Azure может быть недостаточно разрешений. Вы можете настроить развертывание GitHub Actions позже с помощью удостоверения, созданного администратором Azure, или включить обычную проверку подлинности.

7. В нижней части страницы нажмите кнопку Просмотр и создание.

8. После выполнения проверки нажмите кнопку Создать в нижней части страницы.

9. По завершении развертывания нажмите кнопку Перейти к ресурсу.

   

10. Найдите развернутое приложение в веб-браузере по URL-адресу http://<app-name>.azurewebsites.net. Если появится сообщение "Веб-приложение запущено и ожидает содержимого", развертывание GitHub по-прежнему выполняется. Подождите несколько минут и обновите страницу.

    • .NET 8.0
    • .NET Framework 4.8

    

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

• Новая группа ресурсов для всех ресурсов Azure, которые потребуются для этой службы.
• Новый план Служба приложений, указывающий расположение, размер и функции фермы веб-серверов, на котором размещено приложение.
• Новый экземпляр приложения Служба приложений для запуска развернутого приложения.

1. Войдите в учетную запись Azure с помощью команды azd auth login и выполните следующий запрос:

   azd auth login
   

2. Создайте ресурсы Azure и разверните приложение с помощью azd up команды:

   azd up
   

   Выполнение azd up команды может занять несколько минут. azd upиспользует файлы Bicep в проектах для создания группы ресурсов, Служба приложений плана и размещения приложения. Он также выполняет определенные конфигурации, такие как включение ведения журнала и развертывание скомпилированного кода приложения. Во время выполнения команда предоставляет сообщения о процессе подготовки и развертывания, включая ссылку на развертывание в Azure. По завершении команда также отображает ссылку на приложение развертывания.

3. Откройте браузер и перейдите по этому URL-адресу:

   На странице отображается веб-приложение ASP.NET Core 8.0.

   

1. В Обозревателе решений откройте файл Index.cshtml вашего проекта.

2. Замените первый элемент <div> следующим кодом:

   <div class="jumbotron">
       <h1>.NET 💜 Azure</h1>
       <p class="lead">Example .NET app to Azure App Service.</p>
   </div>
   

   Совет

   Если GitHub Copilot включен в Visual Studio, попробуйте следующее:

   1. <div> Выберите элемент и введите ALT+/.
   2. Спросите Copilot: "Перейдите на карточку начальной загрузки, которая говорит .NET 💜 Azure".

   Сохранение изменений.

3. Чтобы выполнить повторное развертывание в Azure, щелкните правой кнопкой мыши проект MyFirstAzureWebApp в Обозревателе решений, а затем выберите Опубликовать.

4. На странице Публикация со сводными сведениями щелкните Опубликовать.

   По завершении публикации Visual Studio открывает в браузере страницу с URL-адресом веб-приложения.

   • .NET 8.0
   • .NET Framework 4.8

   На странице отображается обновленное веб-приложение ASP.NET Core 8.0.

   

1. Откройте Pages/Index.cshtml.

2. Замените первый элемент <div> следующим кодом:

   <div class="jumbotron">
       <h1>.NET 💜 Azure</h1>
       <p class="lead">Example .NET app to Azure App Service.</p>
   </div>
   

   Совет

   Попробуйте использовать GitHub Copilot:

   1. Выберите весь <div> элемент и нажмите кнопку .
   2. Спросите Copilot: "Перейдите на карточку начальной загрузки, которая говорит .NET 💜 Azure".

   Сохранение изменений.

3. В Visual Studio Code откройте раздел Палитра команд и нажмите клавиши CTRL+SHIFT+P.

4. Найдите и выберите "Служба приложений Azure: развернуть в веб-приложении".

5. Выберите подписку и веб-приложение, которое вы использовали ранее.

6. При появлении запроса нажмите кнопку "Развернуть".

7. После завершения публикации выберите "Обзор веб-сайта " в уведомлении.

   На странице отображается обновленное веб-приложение ASP.NET Core 8.0.

   

В локальном каталоге откройте файл Pages/Index.cshtml . Замените первый элемент <div> следующим кодом:

<div class="jumbotron">
    <h1>.NET 💜 Azure</h1>
    <p class="lead">Example .NET app to Azure App Service.</p>
</div>

Сохраните изменения, а затем повторно разверните приложение с помощью az webapp up команды и замените <os> либоwindowslinux.

az webapp up --os-type <os>

Эта команда использует значения, которые кэшируются локально в файле .azure/config, включая имя приложения, группу ресурсов и план службы приложений.

После завершения развертывания вернитесь в окно браузера, которое открылось на шаге "Обзор приложения " и нажмите кнопку обновления.

На странице отображается обновленное веб-приложение ASP.NET Core 8.0.

1. В локальном каталоге откройте файл Pages/Index.cshtml . Замените первый элемент <div> следующим кодом:

   <div class="jumbotron">
       <h1>.NET 💜 Azure</h1>
       <p class="lead">Example .NET app to Azure App Service.</p>
   </div>
   

2. В корневой папке приложения подготовьте свое локальное приложение MyFirstAzureWebApp к развертыванию, выполнив команду dotnet publish:

   dotnet publish --configuration Release
   

3. Перейдите в каталог версии и создайте ZIP-файл из содержимого:

   cd bin\Release\net8.0\publish
   Compress-Archive -Path * -DestinationPath deploy.zip
   

4. Опубликуйте ZIP-файл в приложении Azure с помощью команды Publish-AzWebApp:

   Publish-AzWebApp -ResourceGroupName myResourceGroup -Name <app-name> -ArchivePath (Get-Item .\deploy.zip).FullName -Force
   

   Примечание.

   -ArchivePath нужно предоставить полный путь к ZIP-файлу.

5. После завершения развертывания вернитесь в окно браузера, которое открылось на шаге "Обзор приложения " и нажмите кнопку обновления.

   На странице отображается обновленное веб-приложение ASP.NET Core 8.0.

   

1. Перейдите к вилке GitHub примера кода.

2. На странице репозитория создайте пространство кода, выбрав "Создать код>" на главном сайте.

   • .NET 8.0
   • .NET Framework 4.8

   

   Совет

   Если у вас есть учетная запись GitHub Copilot, попробуйте получить функции GitHub Copilot в вашем пространстве кода.

3. Откройте Index.cshtml.

   • .NET 8.0
   • .NET Framework 4.8

   Index.cshtml находится в папке Pages.

   

4. Замените первый элемент <div> следующим кодом:

   <div class="jumbotron">
       <h1>.NET 💜 Azure</h1>
       <p class="lead">Example .NET app to Azure App Service.</p>
   </div>
   

   Изменения сохраняются автоматически.

   Совет

   Попробуйте использовать GitHub Copilot:

   1. Выберите весь <div> элемент и нажмите кнопку .
   2. Спросите Copilot: "Перейдите на карточку начальной загрузки, которая говорит .NET 💜 Azure".

5. В меню "Управление версиями" введите сообщение о фиксации, напримерModify homepage. Затем нажмите кнопку "Фиксация " и подтвердите промежуточные изменения, нажав кнопку "Да".

   • .NET 8.0
   • .NET Framework 4.8

   

   Совет

   Позвольте GitHub Copilot создать сообщение фиксации для вас, выбрав в окне сообщения.

6. Нажмите кнопку "Синхронизировать изменения 1", а затем нажмите кнопку "ОК".

7. Выполнение развертывания занимает несколько минут. Чтобы просмотреть ход выполнения, перейдите в раздел https://github.com/<your-github-alias>/dotnetcore-docs-hello-world/actions.

8. Вернитесь к окну браузера, открывшемуся во время перехода к шагу приложения , и обновите страницу.

   • .NET 8.0
   • .NET Framework 4.8

   На странице отображается обновленное веб-приложение ASP.NET Core 8.0.

   

В локальном каталоге откройте файл src/Pages/Index.cshtml . Замените первый элемент <div> следующим кодом:

<div class="jumbotron">
    <h1>.NET 💜 Azure</h1>
    <p class="lead">Example .NET app to Azure App Service.</p>
</div>

Сохраните изменения, а затем повторно разверните приложение с помощью команды azd up.

azd up

azd up пропускает шаг подготовки ресурсов на этот раз и повторно развертывает код, так как в файлах Bicep нет изменений.

После завершения развертывания браузер откроется обновленное веб-приложение ASP.NET Core 8.0.

Очистка ресурсов

На предыдущем шаге вы создали ресурсы Azure в группе ресурсов. Если вы считаете, что в будущем эти ресурсы вам не понадобятся, их можно удалить, удалив группу ресурсов.

1. На странице Обзор веб-приложения на портале Azure щелкните ссылку myResourceGroup в разделе Группы ресурсов.
2. На странице группы ресурсов убедитесь, что перечислены ресурсы, которые нужно удалить.
3. Выберите "Удалить группу ресурсов", введите myResourceGroup в текстовом поле и нажмите кнопку "Удалить".
4. Подтвердите еще раз, нажав кнопку "Удалить".

Очистка ресурсов

На предыдущем шаге вы создали ресурсы Azure в группе ресурсов. Если вы считаете, что в будущем эти ресурсы вам не понадобятся, их можно удалить, удалив группу ресурсов.

1. На странице Обзор веб-приложения на портале Azure щелкните ссылку myResourceGroup в разделе Группы ресурсов.
2. На странице группы ресурсов убедитесь, что перечислены ресурсы, которые нужно удалить.
3. Выберите "Удалить группу ресурсов", введите myResourceGroup в текстовом поле и нажмите кнопку "Удалить".
4. Подтвердите еще раз, нажав кнопку "Удалить".

На предыдущем шаге вы создали ресурсы Azure в группе ресурсов. Если эти ресурсы вам не понадобятся в будущем, вы можете удалить группу ресурсов, выполнив следующую команду в Cloud Shell:

az group delete

Для удобства команда, выполняемая ранее в этом проекте, az webapp up сохраняет имя группы ресурсов в качестве значения по умолчанию при выполнении az команд из этого проекта.

Очистка ресурсов

На предыдущем шаге вы создали ресурсы Azure в группе ресурсов. Если эти ресурсы вам не понадобятся в будущем, удалите группу ресурсов, выполнив следующую команду PowerShell:

Remove-AzResourceGroup -Name myResourceGroup

Ее выполнение может занять до минуты.

Очистка ресурсов

На предыдущем шаге вы создали ресурсы Azure в группе ресурсов. Если вы считаете, что в будущем эти ресурсы вам не понадобятся, их можно удалить, удалив группу ресурсов.

1. На странице Обзор веб-приложения на портале Azure щелкните ссылку myResourceGroup в разделе Группы ресурсов.
2. На странице группы ресурсов убедитесь, что перечислены ресурсы, которые нужно удалить.
3. Выберите "Удалить группу ресурсов", введите myResourceGroup в текстовом поле и нажмите кнопку "Удалить".
4. Подтвердите еще раз, нажав кнопку "Удалить".

Очистка ресурсов

azd down Используйте команду, чтобы удалить группу ресурсов и все связанные с ней ресурсы:

azd down

Ознакомьтесь с документацией по интерфейсу командной строки разработчика Azure, чтобы перейти к следующим шагам по работе с azd шаблонами и дополнительными функциями.