Создание первой функции на портале AzureCreate your first function in the Azure portal

Решение "Функции Azure" позволяет выполнять код в бессерверной среде без необходимости создавать виртуальную машину или публиковать веб-приложение.Azure Functions lets you execute your code in a serverless environment without having to first create a VM or publish a web application. В этой статье описано, как создать функцию Hello World на портале Azure с помощью Функций.In this article, learn how to use Functions to create a "hello world" function in the Azure portal.

Создание приложения-функции на портале Azure

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

Примечание

Разработчики C# могут создать функцию в Visual Studio 2019, а не на портале.C# developers should consider creating your first function in Visual Studio 2019 instead of in the portal.

Вход в AzureLog in to Azure

Войдите на портал Azure по адресу https://portal.azure.com с помощью своей учетной записи Azure.Sign in to the Azure portal at https://portal.azure.com with your Azure account.

Создание приложения-функцииCreate a function app

Для выполнения функций вам понадобится приложение-функция,You must have a function app to host the execution of your functions. позволяющее группировать функции в логические единицы и упростить развертывание и совместное использование ресурсов, а также управление ими.A function app lets you group functions as a logic unit for easier management, deployment, and sharing of resources.

  1. Выберите команду Создать ресурс в меню на портале Azure.From the Azure portal menu, select Create a resource.

    Добавление ресурса с помощью меню на портале Azure

  2. На странице Создать щелкните Вычислительные ресурсы > Приложение-функция.In the New page, select Compute > Function App.

  3. Используйте настройки приложения-функции, указанные в таблице под рисунком.Use the function app settings as specified in the table below the image.

    Основы

    ПараметрSetting Рекомендуемое значениеSuggested value ОписаниеDescription
    ПодпискаSubscription Ваша подпискаYour subscription Подписка, в которой создано приложение-функция.The subscription under which this new function app is created.
    Группа ресурсовResource Group myResourceGroupmyResourceGroup Имя новой группы ресурсов, в которой создается приложение-функция.Name for the new resource group in which to create your function app.
    Имя приложения-функцииFunction App name Глобально уникальное имяGlobally unique name Имя, которое идентифицирует ваше новое приложение-функцию.Name that identifies your new function app. Допустимые символы: a-z (без учета регистра), 0-9и -.Valid characters are a-z (case insensitive), 0-9, and -.
    ОпубликоватьPublish КодCode Параметр для публикации файлов кода или контейнера Docker.Option to publish code files or a Docker container.
    Стек среды выполненияRuntime stack Предпочитаемый языкPreferred language Выберите среду выполнения, которая поддерживает нужный функциональный язык программирования.Choose a runtime that supports your favorite function programming language. Выберите .NET для функций C# и F#.Choose .NET for C# and F# functions.
    РегионRegion Предпочтительный регионPreferred region Выберите ближайший регион или регион рядом с другими службами, к которому получают доступ ваши функции.Choose a region near you or near other services your functions access.

    Нажмите кнопку Далее: размещение > .Select the Next : Hosting > button.

  4. Введите следующие параметры размещения.Enter the following settings for hosting.

    Hosting

    ПараметрSetting Рекомендуемое значениеSuggested value ОПИСАНИЕDescription
    Учетная запись храненияStorage account Глобально уникальное имяGlobally unique name Создайте учетную запись хранения для использования приложением-функцией.Create a storage account used by your function app. Имя учетной записи хранения должно содержать от 3 до 24 символов и состоять только из цифр и строчных букв.Storage account names must be between 3 and 24 characters in length and may contain numbers and lowercase letters only. Можно также использовать существующую учетную запись при условии, что она соответствует требованиям учетной записи хранилища.You can also use an existing account, which must meet the storage account requirements.
    Операционная системаOperating system Предпочтительная операционная системаPreferred operating system Операционная система предварительно выбирается с учетом выбранного стека среды выполнения, но при необходимости ее можно изменить.An operating system is pre-selected for you based on your runtime stack selection, but you can change the setting if necessary.
    ПланPlan План потребленияConsumption plan План размещения, который определяет выделение ресурсов в приложении-функции.Hosting plan that defines how resources are allocated to your function app. В плане потребления по умолчанию ресурсы добавляются динамически в соответствии с потребностями функций.In the default Consumption Plan, resources are added dynamically as required by your functions. При таком бессерверном размещении вы платите только за время выполнения функций.In this serverless hosting, you only pay for the time your functions run. Когда выполняется план службы приложений необходимо управлять масштабированием приложения-функции.When you run in an App Service plan, you must manage the scaling of your function app.

    Нажмите кнопку Далее: мониторинг > .Select the Next : Monitoring > button.

  5. Введите следующие параметры мониторинга.Enter the following settings for monitoring.

    Мониторинг

    ПараметрSetting Рекомендуемое значениеSuggested value ОПИСАНИЕDescription
    Application InsightsApplication Insights значение по умолчаниюDefault Создает ресурс Application Insights с таким же именем приложения в ближайшем поддерживаемом регионе.Creates an Application Insights resource of the same App name in the nearest supported region. Развернув этот параметр, можно задать новое имя ресурса или выбрать другое расположение в географическом регионе Azure, где будут хранится данные.By expanding this setting, you can change the New resource name or choose a different Location in an Azure geography where you want to store your data.

    Выберите Просмотр и создание , чтобы просмотреть выбранные параметры конфигурации приложения.Select Review + Create to review the app configuration selections.

  6. Выберите Создать, чтобы подготовить и развернуть приложение-функцию.Select Create to provision and deploy the function app.

  7. Выберите значок уведомления в правом верхнем углу портала. Вы должны увидеть сообщение Развертывание выполнено.Select the Notification icon in the upper-right corner of the portal and watch for the Deployment succeeded message.

    Развертывание уведомления

  8. Выберите Перейти к ресурсу для просмотра нового приложения-функции.Select Go to resource to view your new function app. Можно также установить флажок Закрепить на панели мониторинга.You can also select Pin to dashboard. Это упростит возвращение к этому ресурсу приложения-функции из панели мониторинга.Pinning makes it easier to return to this function app resource from your dashboard.

Затем создайте функцию в новом приложении-функции.Next, you create a function in the new function app.

Создание функции, активируемой HTTPCreate an HTTP triggered function

  1. Раскройте свое приложение-функцию, а затем нажмите кнопку + рядом с Функции, выберите На портале и далее Продолжить.Expand your new function app, then select the + button next to Functions, choose In-portal, and select Continue.

    Краткое руководство по выбору платформы в Функциях.

  2. Выберите Веб-перехватчик + API, а затем нажмите Создать.Choose WebHook + API and then select Create.

    Быстрое начало работы с Функциями на портале Azure.

Будет создана функция на основе шаблона функции с активацией по HTTP для конкретного языка.A function is created using a language-specific template for an HTTP triggered function.

Теперь вы можете запустить новую функцию, отправив HTTP-запрос.Now, you can run the new function by sending an HTTP request.

Проверка функцииTest the function

  1. В новой функции щелкните </> Get function URL (Получить URL-адрес функции), выберите default (Function key) (По умолчанию (ключ функции)) и щелкните Копировать.In your new function, click </> Get function URL at the top right, select default (Function key), and then click Copy.

    Копирование URL-адреса функции с портала Azure

  2. Вставьте URL-адрес функции в адресную строку браузера.Paste the function URL into your browser's address bar. Добавьте значение строки запроса &name=<yourname> в конец этого URL-адреса и нажмите клавишу Enter на клавиатуре, чтобы выполнить этот запрос.Add the query string value &name=<yourname> to the end of this URL and press the Enter key on your keyboard to execute the request. В браузере должен отобразиться ответ, возращенный функцией.You should see the response returned by the function displayed in the browser.

    Следующий пример демонстрирует ответ в браузере:The following example shows the response in the browser:

    Ответ функции в браузере.

    URL-адрес запроса включает ключ, который по умолчанию необходим для доступа к функции по протоколу HTTP.The request URL includes a key that is required, by default, to access your function over HTTP.

  3. При выполнении функции сведения о трассировке записываются в журналы.When your function runs, trace information is written to the logs. Для просмотра выходных данных трассировки из предыдущего выполнения вернитесь к своей функции на портале и щелкните стрелку в нижней части экрана, чтобы развернуть раздел Журналы.To see the trace output from the previous execution, return to your function in the portal and click the arrow at the bottom of the screen to expand the Logs.

    Средство просмотра журналов Функций на портале Azure.

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

Другие краткие руководства в этой коллекции созданы на основе этого документа.Other quick starts in this collection build upon this quick start. Если вы планируете работать с последующими краткими руководствами или с любыми службами, созданными при работе с этим руководством, не очищайте ресурсы.If you plan to work with subsequent quick starts, tutorials, or with any of the services you have created in this quick start, do not clean up the resources.

Под ресурсами в Azure подразумеваются приложения-функции, функции, учетные записи хранения и т. д.Resources in Azure refers to function apps, functions, storage accounts, and so forth. Они объединяются в группы ресурсов, при удалении которых удаляются и все данные в них.They are grouped into resource groups, and you can delete everything in a group by deleting the group.

Вы создали ресурсы для завершения этих кратких руководств.You created resources to complete these quickstarts. Вам могут быть выставлены счета за эти ресурсы в зависимости от состояния учетной записи и цен на службы.You may be billed for these resources, depending on your account status and service pricing. Если вам больше не нужны ресурсы, их можно удалить следующим образом:If you don't need the resources anymore, here's how to delete them:

  1. На портале Azure перейдите на страницу Resource group (Группа ресурсов).In the Azure portal, go to the Resource group page.

    Чтобы перейти на эту страницу со страницы приложения-функции, выберите вкладку Обзор, а затем выберите ссылку в разделе Resource group (Группа ресурсов).To get to that page from the function app page, select the Overview tab and then select the link under Resource group.

    Выберите группу ресурсов, которую требуется удалить со страницы приложения-функции.

    Чтобы перейти на эту страницу с панели управления, выберите Resource groups (Группы ресурсов), а затем выберите группу ресурсов, которая использовалась в этом кратком руководстве.To get to that page from the dashboard, select Resource groups, and then select the resource group that you used for this quickstart.

  2. На странице Resource group (Группа ресурсов) просмотрите список включенных ресурсов и убедитесь, что именно их требуется удалить.In the Resource group page, review the list of included resources, and verify that they are the ones you want to delete.

  3. Выберите Удалить группу ресурсов и следуйте инструкциям.Select Delete resource group, and follow the instructions.

    Удаление может занять несколько минут.Deletion may take a couple of minutes. После этого на несколько секунд появится уведомление.When it's done, a notification appears for a few seconds. Кроме того, можно выбрать значок колокольчика в верхней части страницы, чтобы просмотреть уведомление.You can also select the bell icon at the top of the page to view the notification.

Дополнительная информацияNext steps

Вы создали приложение-функцию с простой функцией, активируемой HTTP.You've created a function app with a simple HTTP triggered function.

Итак, вы создали первую функцию. Теперь давайте добавим к ней выходную привязку, которая позволяет записывать сообщения в очередь службы хранилища.Now that you have created your first function, let's add an output binding to the function that writes a message to a Storage queue.

Дополнительные сведения см. в статье Привязки HTTP функций Azure.For more information, see Azure Functions HTTP bindings.