Краткое руководство. Создание веб-приложения ASP.NET Core в AzureQuickstart: Create an ASP.NET Core web app in Azure

Из этого краткого руководства вы узнаете, как создать и развернуть первое веб-приложение ASP.NET Core в Службе приложений Azure.In this quickstart, you'll learn how to create and deploy your first ASP.NET Core web app to Azure App Service. Служба приложений поддерживает приложения .NET 5.0.App Service supports .NET 5.0 apps.

Когда вы закончите работу с ним, у вас будет создана группа ресурсов Azure с планом размещения Службы приложений и Службой приложений, где развернуто веб-приложение.When you're finished, you'll have an Azure resource group consisting of an App Service hosting plan and an App Service with a deployed web application.

Предварительные требованияPrerequisites

  • Учетная запись Azure с активной подпиской.An Azure account with an active subscription. Создайте учетную запись бесплатно.Create an account for free.

  • Установите Visual Studio 2019 с рабочей нагрузкой ASP.NET и веб-разработка.Install Visual Studio 2019 with the ASP.NET and web development workload.

    Если у вас уже установлена версия Visual Studio 2019, сделайте следующее.If you've installed Visual Studio 2019 already:

    • Установите последние обновления для Visual Studio, выбрав Справка > Проверить обновления.Install the latest updates in Visual Studio by selecting Help > Check for Updates. Последние обновления содержат пакет SDK для .NET 5.0.The latest updates contain the .NET 5.0 SDK.
    • Добавьте рабочую нагрузку, выбрав Инструменты > Получить средства и компоненты.Add the workload by selecting Tools > Get Tools and Features.

Создание веб-приложения ASP.NET CoreCreate an ASP.NET Core web app

Создайте веб-приложение ASP.NET Core в Visual Studio, выполнив следующие действия:Create an ASP.NET Core web app in Visual Studio by following these steps:

  1. Откройте Visual Studio и выберите Создать проект.Open Visual Studio and select Create a new project.

  2. В разделе Создание нового проекта выберите Веб-приложение ASP.NET Core и убедитесь, что в списке для этого варианта указан язык C# , а затем щелкните Далее.In Create a new project, select ASP.NET Core Web Application and confirm that C# is listed in the languages for that choice, then select Next.

  3. В окне Настройка нового проекта присвойте проекту веб-приложения имя myFirstAzureWebApp и щелкните Создать.In Configure your new project, name your web application project myFirstAzureWebApp, and select Create.

    Настройка проекта веб-приложения

  4. Вы можете развернуть в Azure веб-приложение ASP.NET Core любого типа, но для этого краткого руководства нам нужен шаблон Веб-приложение.You can deploy any type of ASP.NET Core web app to Azure, but for this quickstart, choose the Web Application template. В разделе Проверка подлинности выберите вариант Без проверки подлинности и убедитесь, что остальные варианты не выбраны.Make sure Authentication is set to No Authentication, and that no other option is selected. Затем выберите Создать.Then, select Create.

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

  5. В меню Visual Studio выберите Отладка > Запустить без отладки, чтобы запустить веб-приложение локально.From the Visual Studio menu, select Debug > Start Without Debugging to run your web app locally.

    Веб-приложение, выполняющееся локально

Публикация веб-приложенияPublish your web app

Прежде чем опубликовать веб-приложение, следует создать и настроить новую Службу приложений, в которой вы сможете опубликовать это приложение.To publish your web app, you must first create and configure a new App Service that you can publish your app to.

В процессе настройки Службы приложений вы создадите следующее:As part of setting up the App Service, you'll create:

  • Новая группа ресурсов для всех ресурсов Azure, которые потребуются для этой службы.A new resource group to contain all of the Azure resources for the service.
  • Новый план размещения, который позволяет определить расположение, размер и функции фермы веб-серверов для размещения приложения.A new Hosting Plan that specifies the location, size, and features of the web server farm that hosts your app.

Выполните следующие действия, чтобы создать Службу приложений и опубликовать веб-приложение:Follow these steps to create your App Service and publish your web app:

  1. Щелкните правой кнопкой мыши проект myFirstAzureWebApp в обозревателе решений и выберите Опубликовать.In Solution Explorer, right-click the myFirstAzureWebApp project and select Publish.

  2. В разделе Публикация выберите Azure и нажмите кнопку Далее.In Publish, select Azure and click Next.

  3. Доступные параметры зависят от того, вошли ли вы в Azure и есть ли у вас учетная запись Visual Studio, связанная с учетной записью Azure.Your options depend on whether you're signed in to Azure already and whether you have a Visual Studio account linked to an Azure account. Выберите Добавить учетную запись или Войти, чтобы войти в подписку Azure.Select either Add an account or Sign in to sign in to your Azure subscription. Если вы уже вошли, выберите нужную учетную запись.If you're already signed in, select the account you want.

    Вход в Azure

  4. Справа от экземпляров Службы приложений щелкните + .To the right of App Service instances, click +.

    Новое приложение Службы приложений

  5. Для параметра Подписка подтвердите предложенный вариант или выберите другой из раскрывающегося списка.For Subscription, accept the subscription that is listed or select a new one from the drop-down list.

  6. В разделе Группа ресурсов выберите Создать.For Resource group, select New. В разделе Новое имя группы ресурсов введите myResourceGroup и щелкните ОК.In New resource group name, enter myResourceGroup and select OK.

  7. В разделе План размещения щелкните Создать.For Hosting Plan, select New.

  8. В диалоговом окне План размещения. Создать новый введите значения, указанные в следующей таблице.In the Hosting Plan: Create new dialog, enter the values specified in the following table:

    ПараметрSetting Рекомендуемое значениеSuggested Value ОписаниеDescription
    План размещенияHosting Plan myFirstAzureWebAppPlanmyFirstAzureWebAppPlan Имя плана службы приложений.Name of the App Service plan.
    РасположениеLocation Западная ЕвропаWest Europe Центр обработки данных, где размещается веб-приложение.The datacenter where the web app is hosted.
    РазмерSize БесплатныйFree Ценовая категория определяет возможности размещения.Pricing tier determines hosting features.

    Создание нового плана размещения

  9. В поле Имя введите уникальное имя приложения, включающее только допустимые символы: a-z, A-Z, 0-9 и -.In Name, enter a unique app name that includes only the valid characters are a-z, A-Z, 0-9, and -. Вы можете использовать автоматически созданное уникальное имя.You can accept the automatically generated unique name. URL-адрес веб-приложения: http://<app-name>.azurewebsites.net, где <app-name> — имя приложения.The URL of the web app is http://<app-name>.azurewebsites.net, where <app-name> is your app name.

  10. Выберите Создать, чтобы создать ресурсы Azure.Select Create to create the Azure resources.

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

    После завершения работы мастера ресурсы Azure будут созданы и готовы к публикации.Once the wizard completes, the Azure resources are created for you and you are ready to publish.

  11. Выберите Готово, чтобы закрыть мастер.Select Finish to close the wizard.

  12. На странице Публикация щелкните Опубликовать.In the Publish page, click Publish. Visual Studio создает, упаковывает и публикует приложение в Azure, а затем запускает его в браузере по умолчанию.Visual Studio builds, packages, and publishes the app to Azure, and then launches the app in the default browser.

    Опубликованное веб-приложение ASP.NET, работающее в Azure

Поздравляем!Congratulations! Ваше веб-приложение ASP.NET Core работает в Службе приложений Azure в реальном времени.Your ASP.NET Core web app is running live in Azure App Service.

Обновление и повторное развертывание приложенияUpdate the app and redeploy

Чтобы обновить и повторно развернуть веб-приложение, сделайте следующее:Follow these steps to update and redeploy your web app:

  1. В обозревателе решений в проекте откройте Страницы > Index.cshtml.In Solution Explorer, under your project, open Pages > Index.cshtml.

  2. Замените весь тег <div> следующим кодом:Replace the entire <div> tag with the following code:

    <div class="jumbotron">
        <h1>ASP.NET in Azure!</h1>
        <p class="lead">This is a simple app that we've built that demonstrates how to deploy a .NET app to Azure App Service.</p>
    </div>
    
  3. Чтобы выполнить повторное развертывание в Azure, щелкните правой кнопкой мыши проект myFirstAzureWebApp в обозревателе решений, а затем выберите Опубликовать.To redeploy to Azure, right-click the myFirstAzureWebApp project in Solution Explorer and select Publish.

  4. На странице Публикация со сводными сведениями щелкните Опубликовать.In the Publish summary page, select Publish.

    По завершении публикации Visual Studio открывает в браузере страницу с URL-адресом веб-приложения.When publishing completes, Visual Studio launches a browser to the URL of the web app.

    Обновленное веб-приложение ASP.NET, работающее в Azure

Управление приложением AzureManage the Azure app

Чтобы управлять веб-приложением, перейдите на портал Azure, найдите и выберите Службы приложений.To manage your web app, go to the Azure portal, and search for and select App Services.

Выбор служб приложений

На странице Службы приложений выберите имя веб-приложения.On the App Services page, select the name of your web app.

Снимок экрана: страница служб приложений с примером выбранного веб-приложения.

На странице Обзор для веб-приложения вы можете выполнять базовые задачи управления: просмотр, завершение, запуск, перезагрузку и удаление.The Overview page for your web app, contains options for basic management like browse, stop, start, restart, and delete. В меню слева есть дополнительные страницы для настройки приложения.The left menu provides further pages for configuring your app.

Служба приложений на портале Azure

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

На предыдущем шаге вы создали ресурсы Azure в группе ресурсов.In the preceding steps, you created Azure resources in a resource group. Если вы считаете, что в будущем эти ресурсы вам не понадобятся, их можно удалить, удалив группу ресурсов.If you don't expect to need these resources in the future, you can delete them by deleting the resource group.

В меню или на странице Главная портала Azure выберите Группы ресурсов.From the Azure portal menu or Home page, select Resource groups. Затем на странице Группы ресурсов выберите myResourceGroup.Then, on the Resource groups page, select myResourceGroup.

На странице myResourceGroup убедитесь, что перечислены те ресурсы, которые нужно удалить.On the myResourceGroup page, make sure that the listed resources are the ones you want to delete.

Выберите Удалить группу ресурсов, введите myResourceGroup в текстовое поле для подтверждения и щелкните Удалить.Select Delete resource group, type myResourceGroup in the text box to confirm, and then select Delete.

Дальнейшие действияNext steps

В этом кратком руководстве вы применили Visual Studio, чтобы создать и развернуть веб-приложение ASP.NET Core в Службе приложений Azure.In this quickstart, you used Visual Studio to create and deploy an ASP.NET Core web app to Azure App Service.

Переходите к следующей статье, чтобы узнать, как создать приложение .NET Core и подключить его к Базе данных SQL.Advance to the next article to learn how to create a .NET Core app and connect it to a SQL Database:

Служба приложений на платформе Linux — это высокомасштабируемая служба размещения с самостоятельной установкой исправлений на основе операционной системы Linux.App Service on Linux provides a highly scalable, self-patching web hosting service using the Linux operating system. В этом кратком руководстве показано, как создать приложение .NET Core и развернуть его в размещенной Службе приложений Linux с помощью Azure CLI.This quickstart shows how to create a .NET Core app and deploy to a Linux hosted App Service using the Azure CLI.

Пример приложения, выполняющегося в Azure

Выполните инструкции, приведенные в этом руководстве, с помощью компьютера Mac, Windows или Linux.You can follow the steps in this article using a Mac, Windows, or Linux machine.

Если у вас еще нет подписки Azure, создайте бесплатную учетную запись Azure, прежде чем начать работу.If you don't have an Azure subscription, create a free account before you begin.

Настройка начальной средыSet up your initial environment

Возникли проблемы? Сообщите нам!Having issues? Let us know.

Локальное создание приложенияCreate the app locally

В окне терминала на компьютере создайте каталог hellodotnetcore и перейдите в него.In a terminal window on your machine, create a directory named hellodotnetcore and change the current directory to it.

mkdir hellodotnetcore
cd hellodotnetcore

Создание нового приложения .NET CoreCreate a new .NET Core app.

dotnet new web

Локальный запуск приложенияRun the app locally

Запустите приложение локально, чтобы увидеть, как оно будет выглядеть после развертывания в Azure.Run the application locally so that you see how it should look when you deploy it to Azure.

dotnet run

Откройте веб-браузер и перейдите к приложению в http://localhost:5000.Open a web browser, and navigate to the app at http://localhost:5000.

На странице отобразится сообщение Hello World из примера приложения.You see the Hello World message from the sample app displayed in the page.

Тестирование с помощью браузера

Возникли проблемы? Сообщите нам!Having issues? Let us know.

Вход в AzureSign into Azure

В окне терминала войдите в Azure с помощью следующей команды:In your terminal window, log into Azure with the following command:

az login

Развертывание приложенияDeploy the app

Разверните код в локальной папке (hellodotnetcore) с помощью команды az webapp up.Deploy the code in your local folder (hellodotnetcore) using the az webapp up command:

az webapp up --sku F1 --name <app-name>
  • Если команда az не распознана, проверьте, установили ли вы Azure CLI согласно сведениям, указанным в разделе Настройка начальной среды.If the az command isn't recognized, be sure you have the Azure CLI installed as described in Set up your initial environment.
  • Замените <app-name> именем, уникальным для всех регионов Azure (допустимыми символами являются a-z, 0-9и - ).Replace <app-name> with a name that's unique across all of Azure (valid characters are a-z, 0-9, and -). Рекомендуется использовать сочетание названия компании и идентификатора приложения.A good pattern is to use a combination of your company name and an app identifier.
  • Аргумент --sku F1 создает веб-приложение в ценовой категории "Бесплатный".The --sku F1 argument creates the web app on the Free pricing tier. Этот аргумент можно опустить, чтобы использовать более быструю ценовую категорию "Премиум" с почасовой оплатой.Omit this argument to use a faster premium tier, which incurs an hourly cost.
  • При необходимости вы можете использовать аргумент --location <location-name>, где <location-name> является доступным регионом Azure.You can optionally include the argument --location <location-name> where <location-name> is an available Azure region. Список допустимых регионов для учетной записи Azure можно получить, выполнив команду az account list-locations.You can retrieve a list of allowable regions for your Azure account by running the az account list-locations command.

Выполнение этой команды может занять несколько минут.The command may take a few minutes to complete. Во время выполнения она предоставляет сообщения о создании группы ресурсов, плане службы приложений и приложении размещения, настройке ведения журнала и последующем выполнении развертывания ZIP-файла.While running, it provides messages about creating the resource group, the App Service plan and hosting app, configuring logging, then performing ZIP deployment. Затем оно выдает сообщение You can launch the app at http://<app-name>.azurewebsites.net (Вы можете запустить приложение по адресу http://.azurewebsites.net). Это URL-адрес приложения в Azure.It then gives the message, "You can launch the app at http://<app-name>.azurewebsites.net", which is the app's URL on Azure.

Возникли проблемы? Сообщите нам!Having issues? Let us know.

Примечание

Команда az webapp up выполняет следующие действия:The az webapp up command does the following actions:

Переход в приложениеBrowse to the app

Перейдите в развертываемое приложение с помощью веб-браузера.Browse to the deployed application using your web browser.

http://<app_name>.azurewebsites.net

Пример кода .NET Core выполняется в службе приложений в Linux со встроенным образом.The .NET Core sample code is running in App Service on Linux with a built-in image.

Пример приложения, выполняющегося в Azure

Поздравляем!Congratulations! Вы развернули свое первое приложение .NET Core в службе приложений в Linux.You've deployed your first .NET Core app to App Service on Linux.

Возникли проблемы? Сообщите нам!Having issues? Let us know.

Обновление и повторное развертывание кодаUpdate and redeploy the code

В локальном каталоге откройте файл Startup.cs.In the local directory, open the Startup.cs file. Внесите некоторые изменения в текст в вызове метода context.Response.WriteAsync:Make a small change to the text in the method call context.Response.WriteAsync:

await context.Response.WriteAsync("Hello Azure!");

Сохраните изменения, а затем повторно разверните приложение с помощью команды az webapp up.Save your changes, then redeploy the app using the az webapp up command again:

az webapp up --os-type linux

Эта команда использует значения, которые кэшируются локально в файле .azure/config, включая имя приложения, группу ресурсов и план службы приложений.This command uses values that are cached locally in the .azure/config file, including the app name, resource group, and App Service plan.

После завершения развертывания переключитесь в окно браузера, открытое на этапе перехода в приложение, и щелкните "Обновить".Once deployment has completed, switch back to the browser window that opened in the Browse to the app step, and hit refresh.

Обновленный пример приложения, выполняющегося в Azure

Возникли проблемы? Сообщите нам!Having issues? Let us know.

Управление новым приложением AzureManage your new Azure app

Перейдите на портал Azure, чтобы управлять созданным приложением.Go to the Azure portal to manage the app you created.

В меню слева щелкните Службы приложений, а затем — имя своего приложения Azure.From the left menu, click App Services, and then click the name of your Azure app.

Снимок экрана: страница служб приложений, на которой выбран пример приложения Azure.

Отобразится страница обзора вашего приложения.You see your app's Overview page. Вы можете выполнять базовые задачи управления: обзор, завершение, запуск, перезагрузку и удаление.Here, you can perform basic management tasks like browse, stop, start, restart, and delete.

Страница службы приложений на портале Azure

В меню слева доступно несколько страниц для настройки приложения.The left menu provides different pages for configuring your app.

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

На предыдущем шаге вы создали ресурсы Azure в группе ресурсов.In the preceding steps, you created Azure resources in a resource group. Если эти ресурсы вам не понадобятся в будущем, вы можете удалить группу ресурсов, выполнив следующую команду в Cloud Shell:If you don't expect to need these resources in the future, delete the resource group by running the following command in the Cloud Shell:

az group delete --name myResourceGroup

Ее выполнение может занять до минуты.This command may take a minute to run.

Возникли проблемы? Сообщите нам!Having issues? Let us know.

Дальнейшие действияNext steps