Быстрый старт: Развертывание веб-приложения ASP.NET

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

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

• Учетная запись Azure с активной подпиской. Create an account for free.
• Visual Studio Code.
• The Azure Tools extension.
• The latest .NET 8.0 SDK.
• (Опционально) Чтобы попробовать GitHub Copilot, нужен аккаунт GitHub Copilot. Доступна 30-дневная бесплатная пробная версия.

• Учетная запись Azure с активной подпиской. Create an account for free.
• The Azure CLI.
• The latest .NET 8.0 SDK.
• (Необязательно) Чтобы попробовать GitHub Copilot, вам нужен аккаунт GitHub Copilot. Доступна бесплатная 30-дневная пробная версия.

• Учетная запись Azure с активной подпиской. Create an account for free.
• The Azure PowerShell.
• The latest .NET 8.0 SDK.

• Аккаунт Azure с активной подпиской. Create an account for free.
• Аккаунт GitHub Создайте аккаунт бесплатно.

• Учетная запись Azure с активной подпиской. Create an account for free.
• The Azure Developer CLI.
• The latest .NET 8.0 SDK.

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

Инициализируйте шаблон веб-приложения 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 Developer CLI (azd) как для создания ресурсов Azure, так и для развертывания кода на них. Для получения дополнительной информации, смотрите Установите Azure Developer CLI и Создание и развертывание приложений с помощью Azure Developer CLI.

To get and initialize the ASP.NET Core web app template, use the following steps:

1. Откройте окно терминала на вашем компьютере в пустой рабочий каталог. Выполните следующую команду:

   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. In Solution Explorer, right-click the MyFirstAzureWebApp project and select Publish.

2. В Publish выберите Azure, а затем Next.

   

3. Выберите конкретную цель, либо Azure App Service (Linux), либо Azure App Service (Windows). Select Next.

   Важно

   При использовании целевого ASP.NET Framework 4.8 используйте Azure App Service (Windows).

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

   

5. Справа от экземпляров App Service выберите +.

   

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

7. Для группы ресурсов выберите Создать. Введите myResourceGroup в поле Название новой группы ресурсов и нажмите OK.

8. Для плана хостинга выберите новый.

9. В диалоге Hosting Plan: Create new введите значения, указанные в следующей таблице.

   Настройки	Рекомендуемое значение	Описание
   Hosting Plan	MyFirstAzureWebAppPlan	Название плана App Service.
   Location	West Europe	Центр обработки данных, где размещено веб-приложение.
   Размер	Выберите самый низкий уровень.	Уровни ценообразования определяют функции хостинга.

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

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

    

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

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

13. In the Publish page, select Publish. Если вы увидите предупреждающее сообщение, выберите Продолжить.

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

    • .NET 8.0
    • .NET Framework 4.8

    Вы видите веб-приложение ASP.NET Core 8.0, отображаемое на странице.

    

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

   code .
   

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

   Tip

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

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

4. Найдите и выберите Azure App Service: Create New Web App (Advanced).

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

   1. Если будет предложено, войдите в свою учетную запись Azure.
   2. Выберите вашу подписку.
   3. Выберите Create new Web App... Advanced.
   4. Для введите глобально уникальное имя для нового веб-приложения, используйте имя, которое уникально для всей платформы Azure. Допустимые символы: a-z, 0-9 и -. Хорошим шаблоном является использование комбинации названия вашей компании и идентификатора приложения.
   5. Выберите Создать новую группу ресурсов и укажите имя, например myResourceGroup.
   6. При появлении запроса Выбрать стек выполнения, выберите .NET 8 (LTS).
   7. Select an operating system (Windows or Linux).
   8. Выберите местоположение рядом с вами.
   9. Выберите Создать новый план службы приложений, укажите имя и выберите уровень цен Бесплатный (F1).
   10. Для ресурса Application Insights выберите Пропустить пока для ресурса Application Insights.
   11. When prompted, select Deploy.
   12. Выберите MyFirstAzureWebApp в качестве папки для развертывания.
   13. Выберите Add Config, когда будет предложено.

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

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

   Вы видите веб-приложение ASP.NET Core 8.0, отображенное на странице.

   

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

   az login
   

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

2. Используйте az webapp up, чтобы развернуть код в локальном каталоге MyFirstAzureWebApp.

   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.

   Команда может занять несколько минут для выполнения. Пока команда выполняется, она предоставляет сообщения о создании группы ресурсов, плана App Service и хостинга приложения, настраивает ведение журнала, а затем выполняет развертывание через 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.

   Команда может занять несколько минут для завершения. Команда создаёт группу ресурсов, план App Service и ресурс App Service.

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

   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. Введите app services в поиск. Under Services, select App Services.

   

2. In the App Services page, select Create>Web App.

3. In the Basics tab:

   • .NET 8.0
   • .NET Framework 4.8

   • В разделе Группа ресурсов выберите Создать новую. Введите myResourceGroup в качестве имени.
   • В разделе Имя введите уникальное глобальное имя для вашего веб-приложения.
   • Under Publish, select Code.
   • Under Runtime stack select .NET 8 (LTS).
   • Under Operating System, select Windows. Если вы выберете Linux, вы не сможете настроить развертывание GitHub на следующем шаге, но можете сделать это после создания приложения на странице Deployment Center.
   • Выберите регион, из которого вы хотите обслуживать свое приложение.
   • В разделе App Service Plan выберите Создать новый и введите myAppServicePlan в качестве имени.
   • Под План тарифов выберите Бесплатный F1.

   

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

5. В разделе настроек GitHub Actions установите непрерывное развертывание в положение Включено.

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

   • .NET 8.0
   • .NET Framework 4.8

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

   

7. Выберите Обзор + создание внизу страницы.

8. После завершения проверок выберите Создать внизу страницы.

9. Завершив развертывание, выберите Перейти к ресурсу.

   

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

    • .NET 8.0
    • .NET Framework 4.8

    

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

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

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

   azd auth login
   

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

   azd up
   

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

3. Откройте веб-браузер и перейдите по URL-адресу. Вы видите веб-приложение ASP.NET Core 8.0, отображенное на странице.

   

1. В Solution Explorer, под вашим проектом, дважды щелкните Pages>Index.cshtml, чтобы открыть.

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

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

   Tip

   С включенной GitHub Copilot в Visual Studio выполните следующие действия:

   1. Выберите элемент <div> и введите Alt+/.
   2. Попросите Copilot: «Измените на карточку Bootstrap, на которой написано .NET 💜 Azure.»

   Сохраните изменения.

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

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

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

   • .NET 8.0
   • .NET Framework 4.8

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

   

1. Open Pages/Index.cshtml.

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

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

   Tip

   Попробуйте этот метод с GitHub Copilot:

   1. Выберите весь элемент <div> и выберите .
   2. Спросите Copilot: "Измените на карточку Bootstrap с текстом .NET 💜 Azure."

   Сохраните изменения.

3. In Visual Studio Code, open the Command Palette: Ctrl+Shift+P.

4. Найдите и выберите Azure App Service: Deploy to Web App.

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

6. When prompted, select Deploy.

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> либо на linux, либо на windows.

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 -Force
   

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. На странице репозитория создайте пространство кода, выбрав Код>Создать пространство кода в main.

   • .NET 8.0
   • .NET Framework 4.8

   

3. Open 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>
   

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

   Tip

   Попробуйте этот подход с GitHub Copilot:

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

5. Из меню Управление версиями введите сообщение коммита, такое как Modify homepage. Затем выберите Commit и подтвердите подготовку изменений, выбрав Да.

   • .NET 8.0
   • .NET Framework 4.8

   

6. Выберите Sync changes 1, затем подтвердите, выбрав OK.

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. Confirm again by selecting Delete.

Очистить ресурсы

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

1. На странице Обзор вашего веб-приложения в портале Azure выберите ссылку myResourceGroup в разделе Группа ресурсов.
2. На странице группы ресурсов убедитесь, что перечислены именно те ресурсы, которые вы хотите удалить.
3. Выберите Удалить группу ресурсов, введите myResourceGroup в текстовое поле, а затем выберите Удалить.
4. Confirm again by selecting Delete.

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

az group delete

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

Освободить ресурсы

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

Remove-AzResourceGroup -Name myResourceGroup

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

Очистить ресурсы

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

1. На странице Обзор вашего веб-приложения в портале Azure выберите ссылку myResourceGroup в разделе Группа ресурсов.
2. На странице группы ресурсов убедитесь, что перечисленные ресурсы - именно те, которые вы хотите удалить.
3. Выберите Удалить группу ресурсов, введите myResourceGroup в текстовое поле, и затем выберите Удалить.
4. Confirm again by selecting Delete.

Очистить ресурсы

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

azd down

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