Управление приложением функцииManage your function app

В функциях Azure приложение-функция предоставляет контекст выполнения для отдельных функций.In Azure Functions, a function app provides the execution context for your individual functions. Поведение приложения-функции применяется ко всем содержащимся в нем функциям.Function app behaviors apply to all functions hosted by a given function app. Все функции в приложении-функции должны иметь один и тот же язык.All functions in a function app must be of the same language.

Отдельные функции в приложении-функции развертываются вместе и масштабируются вместе.Individual functions in a function app are deployed together and are scaled together. Все функции в одном и том же приложении функции совместно используют ресурсы для каждого экземпляра, так как приложение функции масштабируется.All functions in the same function app share resources, per instance, as the function app scales.

Строки подключения, переменные среды и другие параметры приложения определяются отдельно для каждого приложения функции.Connection strings, environment variables, and other application settings are defined separately for each function app. Все данные, которые должны совместно использоваться приложениями-функциями, должны храниться извне в постоянном хранилище.Any data that must be shared between function apps should be stored externally in a persisted store.

В этой статье описывается настройка приложений функций и управление ими.This article describes how to configure and manage your function apps.

Совет

Многие параметры конфигурации можно также управлять с помощью Azure CLI.Many configuration options can also be managed by using the Azure CLI.

Начало работы на портале AzureGet started in the Azure portal

  1. Для начала перейдите на портал Azure и войдите, используя свою учетную запись Azure.To begin, go to the Azure portal and sign in to your Azure account. В строке поиска в верхней части портала введите имя приложения функции и выберите его из списка.In the search bar at the top of the portal, enter the name of your function app and select it from the list.

  2. В разделе Параметры в левой области выберите Конфигурация.Under Settings in the left pane, select Configuration.

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

Вы можете выбрать все необходимое для управления приложением-функцией на странице Обзор, в частности Параметры приложения и функции платформы.You can navigate to everything you need to manage your function app from the overview page, in particular the Application settings and Platform features.

Параметры приложенияApplication settings

На вкладке Параметры приложения хранятся параметры, используемые приложением функции.The Application settings tab maintains settings that are used by your function app. Эти параметры хранятся в зашифрованном виде, поэтому необходимо выбрать параметр Показать значения , чтобы просмотреть значения на портале.These settings are stored encrypted, and you must select Show values to see the values in the portal. Вы также можете получить доступ к параметрам приложения с помощью Azure CLI.You can also access application settings by using the Azure CLI.

ПорталPortal

Чтобы добавить параметр на портале, выберите параметр создать приложение и добавьте новую пару «ключ-значение».To add a setting in the portal, select New application setting and add the new key-value pair.

Параметры приложения функции в портал Azure.

Azure CLIAzure CLI

az functionapp config appsettings listКоманда возвращает существующие параметры приложения, как показано в следующем примере:The az functionapp config appsettings list command returns the existing application settings, as in the following example:

az functionapp config appsettings list --name <FUNCTION_APP_NAME> \
--resource-group <RESOURCE_GROUP_NAME>

az functionapp config appsettings setКоманда добавляет или обновляет параметр приложения.The az functionapp config appsettings set command adds or updates an application setting. В следующем примере создается параметр с именем ключа CUSTOM_FUNCTION_APP_SETTING и значением 12345 :The following example creates a setting with a key named CUSTOM_FUNCTION_APP_SETTING and a value of 12345:

az functionapp config appsettings set --name <FUNCTION_APP_NAME> \
--resource-group <RESOURCE_GROUP_NAME> \
--settings CUSTOM_FUNCTION_APP_SETTING=12345

Использовать параметры приложенияUse application settings

Эти значения параметров приложения-функции также могут считываться в коде как переменные среды.The function app settings values can also be read in your code as environment variables. Дополнительные сведения см. в разделе о переменных среды в этих справочниках для определенного языка:For more information, see the Environment variables section of these language-specific reference topics:

При разработке приложения-функции локально необходимо сохранить локальные копии этих значений в local.settings.jsв файле проекта.When you develop a function app locally, you must maintain local copies of these values in the local.settings.json project file. Дополнительные сведения см. в разделе локальный файл параметров.To learn more, see Local settings file.

Функции платформыPlatform features

Приложения функций выполняются в и обслуживаются платформой службы приложений Azure.Function apps run in, and are maintained by, the Azure App Service platform. Поэтому они имеют доступ к большинству функций базовой платформы веб-хостинга Azure.As such, your function apps have access to most of the features of Azure's core web hosting platform. В левой области вы можете получить доступ ко многим функциям платформы службы приложений, которые можно использовать в приложениях-функциях.The left pane is where you access the many features of the App Service platform that you can use in your function apps.

Примечание

Не все функции службы приложений доступны при выполнении приложения с планом размещения потребления.Not all App Service features are available when a function app runs on the Consumption hosting plan.

Оставшаяся часть этой статьи посвящена следующим функциям службы приложений в портал Azure, которые полезны для функций:The rest of this article focuses on the following App Service features in the Azure portal that are useful for Functions:

Дополнительные сведения о работе с параметрами службы приложений см. в статье Настройка параметров в службе приложений Azure.For more information about how to work with App Service settings, see Configure Azure App Service Settings.

Редактор службы приложенийApp Service editor

Редактор службы приложений

Редактор службы приложений — это расширенный редактор на портале, который можно использовать для изменения JSON-файлов конфигурации и файлов с кодом.The App Service editor is an advanced in-portal editor that you can use to modify JSON configuration files and code files alike. При выборе этого параметра откроется отдельная вкладка браузера с базовым редактором.Choosing this option launches a separate browser tab with a basic editor. Он позволяет выполнять интеграцию с репозиторием Git, запускать и отлаживать код и изменять параметры приложения-функции.This enables you to integrate with the Git repository, run and debug code, and modify function app settings. Этот редактор предоставляет улучшенную среду разработки для функций по сравнению с встроенным редактором функций.This editor provides an enhanced development environment for your functions compared with the built-in function editor.

Рекомендуется разрабатывать функции на локальном компьютере.We recommend that you consider developing your functions on your local computer. При разработке локально и публикации в Azure файлы проекта доступны только для чтения на портале.When you develop locally and publish to Azure, your project files are read-only in the portal. Дополнительные сведения см. в статье Использование кода и тестирование функций Azure в локальнойсреде.To learn more, see Code and test Azure Functions locally.

КонсольConsole

Консоль приложения-функции

Консоль на портале оптимально подходит разработчикам, желающим взаимодействовать с приложением-функцией из командной строки.The in-portal console is an ideal developer tool when you prefer to interact with your function app from the command line. Стандартные команды включают создание каталогов и файлов и навигацию по ним, а также выполнение пакетных файлов и сценариев.Common commands include directory and file creation and navigation, as well as executing batch files and scripts.

При разработке локально рекомендуется использовать Azure functions Core Tools и Azure CLI.When developing locally, we recommend using the Azure Functions Core Tools and the Azure CLI.

Дополнительные инструменты (Kudu)Advanced tools (Kudu)

Настройка Kudu

Дополнительные средства для службы приложений (которые также называются Kudu) предоставляют доступ к расширенным административным функциям для приложения-функции.The advanced tools for App Service (also known as Kudu) provide access to advanced administrative features of your function app. С помощью Kudu можно управлять системными сведениями, параметрами приложения, переменными среды, заголовками HTTP и переменными сервера.From Kudu, you manage system information, app settings, environment variables, site extensions, HTTP headers, and server variables. Кроме того, можно также запустить Kudu, перейдя на конечную точку SCM для приложения-функции, например https://<myfunctionapp>.scm.azurewebsites.net/.You can also launch Kudu by browsing to the SCM endpoint for your function app, like https://<myfunctionapp>.scm.azurewebsites.net/

Центр развертыванияDeployment Center

При использовании решения системы управления версиями для разработки и сопровождения кода функций центр развертывания позволяет выполнять сборку и развертывание из системы управления версиями.When you use a source control solution to develop and maintain your functions code, Deployment Center lets you build and deploy from source control. Проект будет создан и развернут в Azure при внесении обновлений.Your project is built and deployed to Azure when you make updates. Дополнительные сведения см. в статье технологии развертывания в службе "функции Azure".For more information, see Deployment technologies in Azure Functions.

Предоставление общего доступа к ресурсам независимо от источникаCross-origin resource sharing

Чтобы предотвратить выполнение вредоносного кода на клиенте, современные браузеры блокируют запросы от веб-приложений к ресурсам, выполняемым в отдельном домене.To prevent malicious code execution on the client, modern browsers block requests from web applications to resources running in a separate domain. Общий доступ к ресурсам между источниками (CORS) позволяет Access-Control-Allow-Origin заголовку объявить, какие источники могут вызывать конечные точки в приложении-функции.Cross-origin resource sharing (CORS) lets an Access-Control-Allow-Origin header declare which origins are allowed to call endpoints on your function app.

ПорталPortal

При настройке списка разрешенных источников для приложения Access-Control-Allow-Origin -функции заголовок автоматически добавляется ко всем ответам из конечных точек HTTP в приложении функции.When you configure the Allowed origins list for your function app, the Access-Control-Allow-Origin header is automatically added to all responses from HTTP endpoints in your function app.

Настройка списка CORS приложения функции

При использовании подстановочного знака ( * ) все остальные домены игнорируются.When the wildcard (*) is used, all other domains are ignored.

Используйте az functionapp cors add команду, чтобы добавить домен в список разрешенных источников.Use the az functionapp cors add command to add a domain to the allowed origins list. В следующем примере добавляется домен contoso.com:The following example adds the contoso.com domain:

az functionapp cors add --name <FUNCTION_APP_NAME> \
--resource-group <RESOURCE_GROUP_NAME> \
--allowed-origins https://contoso.com

Используйте az functionapp cors show команду для вывода списка текущих разрешенных источников.Use the az functionapp cors show command to list the current allowed origins.

АутентификацияAuthentication

Настройка проверки подлинности для приложения-функции

Если функции используют триггер HTTP, можно настроить обязательную предварительную проверку подлинности для вызовов.When functions use an HTTP trigger, you can require calls to first be authenticated. Служба приложений поддерживает Azure Active Directory проверку подлинности и вход с помощью поставщиков социальных сетей, таких как Facebook, Microsoft и Twitter.App Service supports Azure Active Directory authentication and sign-in with social providers, such as Facebook, Microsoft, and Twitter. Дополнительные сведения о настройке определенных поставщиков аутентификации см. в разделе Проверка подлинности и авторизация в службе приложений Azure.For details on configuring specific authentication providers, see Azure App Service authentication overview.

Дальнейшие шагиNext steps