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

Чтобы просмотреть параметры приложения, см. статью Get started in the Azure portal.

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

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 найдите страницу приложения-функции, разверните Settings>Configuration в левом столбце.

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

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

   

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

3. В файле найдите элемент publishProfile, имеющий атрибут publishMethod="FTP". В этом элементе атрибуты publishUrl, userName и 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> на группу ресурсов. Возвращаемые URL, username и 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> на группу ресурсов. Возвращаемые URL, username и 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, на левой панели разверните App Service plan и выберите App Service plan.

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

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

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

Используйте следующую процедуру, чтобы перейти от плана потребления к плану Premium на 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>
   

Используйте следующую процедуру, чтобы перейти от плана потребления к плану Premium на 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.