Управление приложением-функцией

Чтобы просмотреть параметры приложения, см. статью "Начало работы" в портал Azure.

Вкладка "Параметры приложения" поддерживает параметры, используемые приложением-функцией:

1. Чтобы просмотреть значения параметров приложения, выберите "Показать значения".

2. Чтобы добавить параметр, нажмите кнопку +Добавить, а затем введите имя и значение новой пары "ключ-значение".

   

Команда az functionapp config appsettings list возвращает существующие параметры приложения, например:

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

Команда az functionapp config appsettings set добавляет или обновляет параметр приложения. В следующем примере создается параметр с именем ключа CUSTOM_FUNCTION_APP_SETTING и значением 12345:

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

Командлет Get-AzFunctionAppSetting возвращает существующие параметры приложения, например:

Get-AzFunctionAppSetting -Name <FUNCTION_APP_NAME> -ResourceGroupName <RESOURCE_GROUP_NAME>

Команда Update-AzFunctionAppSetting добавляет или обновляет параметр приложения. В следующем примере создается параметр с именем ключа CUSTOM_FUNCTION_APP_SETTING и значением 12345:

Update-AzFunctionAppSetting -Name <FUNCTION_APP_NAME> -ResourceGroupName <RESOURCE_GROUP_NAME> -AppSetting @{"CUSTOM_FUNCTION_APP_SETTING" = "12345"}

Учетные данные публикации FTPS можно получить в портал Azure, скачав профиль публикации для приложения-функции.

Чтобы скачать профиль публикации приложения-функции, сделайте следующее:

1. В портал Azure найдите страницу для приложения-функции, разверните раздел "Параметры>конфигурации" в левом столбце.

2. На странице "Конфигурация" выберите вкладку "Общие параметры" и убедитесь, что учетные данные публикации SCM Basic Auth включены. Если этот параметр отключен, вы не можете использовать профили публикации, поэтому нажмите кнопку "Вкл." и "Сохранить".

3. Вернитесь на страницу обзора приложения-функции и выберите "Получить профиль публикации".

   

4. Сохраните и скопируйте содержимое файла.

3. В файле найдите publishProfile элемент с атрибутом publishMethod="FTP". В этом элементе publishUrluserNameатрибуты и userPWD атрибуты содержат целевой URL-адрес и учетные данные для публикации FTPS.

Выполните следующую команду Azure CLI, которая возвращает учетные данные FTPS из профиля публикации.

az functionapp deployment list-publishing-profiles --name <APP_NAME> --resource-group <GROUP_NAME> --query "[?publishMethod=='FTP'].{URL:publishUrl, username:userName, password:userPWD}" -o table

В этом примере замените <APP_NAME> имя приложения-функции и <GROUP_NAME> группу ресурсов. Возвращаемые URLusernameстолбцы и password столбцы содержат целевой URL-адрес и учетные данные для публикации FTPS.

Выполните эту команду Azure PowerShell, которая возвращает учетные данные FTPS из профиля публикации.

$profile = [xml](Get-AzWebAppPublishingProfile -ResourceGroupName "<GROUP_NAME>" -Name "<APP_NAME>" -Format "Ftp") 
$profile.publishData.publishProfile | Where-Object -Property publishMethod -eq Ftp | Select-Object -Property @{Name="URL"; Expression = {$_.publishUrl}}, 
@{Name="username"; Expression = {$_.userName}}, @{Name="password"; Expression = {$_.userPWD}} | Format-Table

В этом примере замените <APP_NAME> имя приложения-функции и <GROUP_NAME> группу ресурсов. Возвращаемые URLusernameстолбцы и password столбцы содержат целевой URL-адрес и учетные данные для публикации FTPS.

1. Чтобы определить тип плана, используемого приложением-функцией, см. раздел Служба приложений План на странице обзора приложения-функции в портал Azure.

   

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

Выполните следующую команду Azure CLI, чтобы получить тип плана размещения:

functionApp=<FUNCTION_APP_NAME>
resourceGroup=FunctionMonitoringExamples
appServicePlanId=$(az functionapp show --name $functionApp --resource-group $resourceGroup --query appServicePlanId --output tsv)
az appservice plan list --query "[?id=='$appServicePlanId'].sku.tier" --output tsv

В предыдущем примере замените <RESOURCE_GROUP> группу <FUNCTION_APP_NAME> ресурсов и имена приложений-функций соответственно.

Выполните следующую команду Azure PowerShell, чтобы получить тип плана размещения:

$FunctionApp = '<FUNCTION_APP_NAME>'
$ResourceGroup = '<RESOURCE_GROUP>'

$PlanID = (Get-AzFunctionApp -ResourceGroupName $ResourceGroup -Name $FunctionApp).AppServicePlan
(Get-AzFunctionAppPlan -Name $PlanID -ResourceGroupName $ResourceGroup).SkuTier

В предыдущем примере замените <RESOURCE_GROUP> группу <FUNCTION_APP_NAME> ресурсов и имена приложений-функций соответственно.

Вы можете использовать портал Azure для перехода на другой план.

Команды Azure CLI можно использовать для ручного создания нового плана, переключения приложения на использование нового плана и удаления исходного плана.

Команды Azure PowerShell можно использовать для ручного создания нового плана, переключения приложения на использование нового плана и удаления исходного плана.

1. На портале Azure перейдите к приложению плана потребления и в левой области разверните план службы приложений и выберите план службы приложений.

2. На странице плана службы приложений выберите "Изменить план " в разделе "Текущий план службы приложений".

3. В разделе "Изменение плана службы приложений" выберите "Премиум" для типа плана, создайте новый план "Премиум" и нажмите кнопку "ОК".

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

1. На портале Azure перейдите к приложению плана Elastic Premium и в левой области разверните план службы приложений и выберите план службы приложений.

2. На странице плана службы приложений выберите "Изменить план " в разделе "Текущий план службы приложений".

3. В разделе "Изменение плана службы приложений" выберите " Потребление " в разделе " Тип плана", создайте новый план потребления и нажмите кнопку "ОК".

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

Для переноса из плана "Потребление" в план "Премиум" в системе Windows используйте следующую процедуру.

1. Выполните команду az functionapp create, как показано ниже, чтобы создать новый план Служба приложений (Elastic Premium) в том же регионе и группе ресурсов, что и существующее приложение-функцию:

   az functionapp plan create --name <NEW_PREMIUM_PLAN_NAME> --resource-group <MY_RESOURCE_GROUP> --location <REGION> --sku EP1
   

2. Выполните команду az functionapp update, чтобы перенести существующее приложение-функцию в новый план "Премиум".

   az functionapp update --name <MY_APP_NAME> --resource-group <MY_RESOURCE_GROUP> --plan <NEW_PREMIUM_PLAN>
   

3. Если вам больше не нужен план потребления, первоначально используемый приложением, удалите исходный план после подтверждения успешной миграции на новый. Выполните команду az functionapp plan list, чтобы получить список всех планов "Потребление" в группе ресурсов.

   az functionapp plan list --resource-group <MY_RESOURCE_GROUP> --query "[?sku.family=='Y'].{PlanName:name,Sites:numberOfSites}" -o table
   

   Вы можете безопасно удалить план с нулевым количеством сайтов (это тот план, из которого вы перешли).

4. Выполните команду az functionapp plan delete, как показано ниже, чтобы удалить перенесенный план "Потребление".

   az functionapp plan delete --name <CONSUMPTION_PLAN_NAME> --resource-group <MY_RESOURCE_GROUP>
   

Для переноса из плана "Премиум" в план "Потребление" в системе Windows используйте следующую процедуру.

1. Выполните команду az functionapp create, как показано ниже, чтобы создать новое приложение-функцию (потребление) в том же регионе и группе ресурсов, что и существующее приложение-функцию. Эта команда также создает новый план потребления, в котором запускается приложение-функция:

   az functionapp create --resource-group <MY_RESOURCE_GROUP> --name <NEW_CONSUMPTION_APP_NAME> --consumption-plan-location <REGION> --runtime <LANGUAGE_RUNTIME> --functions-version 4 --storage-account <STORAGE_NAME>
   

2. Выполните команду az functionapp show, как показано ниже, чтобы получить имя плана потребления, созданного с помощью нового приложения-функции:

   az functionapp show --resource-group <MY_RESOURCE_GROUP> --name <NEW_CONSUMPTION_APP_NAME> --query "{appServicePlanId}" -o tsv
   

   Имя плана потребления — это окончательный сегмент возвращаемого полного идентификатора ресурса.

3. Выполните команду az functionapp update следующим образом, чтобы перенести существующее приложение-функцию в новый план потребления:

   az functionapp update --name <MY_APP_NAME> --resource-group <MY_RESOURCE_GROUP> --plan <NEW_CONSUMPTION_PLAN> --force
   

4. Выполните команду az functionapp delete, как показано ниже, чтобы удалить приложение-функцию, созданное на шаге 1, так как вам нужен только план, созданный для запуска существующего приложения-функции:

   az functionapp delete --name <NEW_CONSUMPTION_APP_NAME> --resource-group <MY_RESOURCE_GROUP>
   

5. Если вам больше не нужен план Premium, используемый приложением, удалите исходный план после успешной миграции в новый. Пока план Premium не будет удален, плата за него будет взиматься. Выполните команду az functionapp plan list, как показано ниже, чтобы получить список всех планов Premium в группе ресурсов:

   az functionapp plan list --resource-group <MY_RESOURCE_GROUP> --query "[?sku.family=='EP'].{PlanName:name,Sites:numberOfSites}" -o table
   

6. Выполните команду az functionapp plan delete, как показано ниже, чтобы удалить план Premium, из который вы перенесены:

   az functionapp plan delete --name <PREMIUM_PLAN> --resource-group <MY_RESOURCE_GROUP>
   

Для переноса из плана "Потребление" в план "Премиум" в системе Windows используйте следующую процедуру.

1. Выполните команду New-AzFunctionAppPlan следующим образом, чтобы создать новый план Служба приложений (Elastic Premium) в том же регионе и группе ресурсов, что и существующее приложение-функцию:

   New-AzFunctionAppPlan -Name <NEW_PREMIUM_PLAN_NAME> -ResourceGroupName <MY_RESOURCE_GROUP> -Location <REGION> -Sku EP1 -WorkerType Windows
   

2. Выполните команду Update-AzFunctionApp следующим образом, чтобы перенести существующее приложение-функцию в новый план Premium:

   Update-AzFunctionApp -Name <MY_APP_NAME> -ResourceGroupName <MY_RESOURCE_GROUP> -PlanName <NEW_PREMIUM_PLAN> -Force
   

3. Если вам больше не нужен план потребления, используемый приложением, можно выполнить команду Remove-AzFunctionAppPlan следующим образом, чтобы удалить план потребления, из который вы перенесены:

   Remove-AzFunctionAppPlan -Name <CONSUMPTION_PLAN_NAME> -ResourceGroupName <MY_RESOURCE_GROUP> -Force
   

Для переноса из плана "Премиум" в план "Потребление" в системе Windows используйте следующую процедуру.

1. Выполните команду New-AzFunctionApp следующим образом, чтобы создать новое приложение-функцию (потребление) в том же регионе и группе ресурсов, что и существующее приложение-функцию. Эта команда также создает новый план потребления, в котором запускается приложение-функция:

   New-AzFunctionApp -Name <NEW_CONSUMPTION_APP_NAME> -StorageAccountName <STORAGE_NAME> -Location <REGION> -ResourceGroupName <MY_RESOURCE_GROUP> -Runtime <LANGUAGE_RUNTIME> -RuntimeVersion <LANGUAGE_VERSION> -FunctionsVersion 4 -OSType Windows
   

2. Выполните команду Get-AzFunctionApp следующим образом, чтобы получить имя плана потребления, созданного с помощью нового приложения-функции:

   Get-AzFunctionApp -ResourceGroupName <MY_RESOURCE_GROUP> -Name <NEW_CONSUMPTION_APP_NAME> | Select-Object -Property AppServicePlan | Format-List
   

3. Выполните команду Update-AzFunctionApp следующим образом, чтобы перенести существующее приложение-функцию в новый план потребления:

   Update-AzFunctionApp -Name <MY_APP_NAME> -ResourceGroupName <MY_RESOURCE_GROUP> -PlanName <NEW_CONSUMPTION_PLAN> -Force
   

4. Если вам больше не нужен план потребления, используемый приложением, можно выполнить команду Remove-AzFunctionAppPlan следующим образом, чтобы удалить план потребления, из который вы перенесены:

   Remove-AzFunctionAppPlan -Name <CONSUMPTION_PLAN_NAME> -ResourceGroupName <MY_RESOURCE_GROUP> -Force
   

При настройке списка разрешенных источников для приложения-функции ко всем ответам от конечных точек HTTP в приложении-функции автоматически добавляется заголовок Access-Control-Allow-Origin.

Если есть другая запись домена, подстановочный знак (*) игнорируется.

Используйте команду az functionapp cors add, чтобы добавить домен в список разрешенных источников. В следующем примере добавляется домен contoso.com:

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

Используйте команду az functionapp cors show для вывода списка текущих разрешенных источников.

В настоящее время невозможно обновить параметры CORS с помощью Azure PowerShell.