大网数据广告活动
Azure 网站与应用

配置 Azure Functions 中的函数应用设置

· 52CE 我爱测

了解如何配置 Azure Functions 中的函数应用设置。

在 Azure Functions 中,Function App 提供各个函数的执行上下文。 Function App 行为适用于由给定 Function App 托管的所有函数。 函数应用中的所有函数必须使用同一语言。

函数应用中的各个函数一起部署并一起缩放。 同一函数应用中的所有函数在函数应用缩放时共享每个实例的资源。

将为每个函数应用单独定义连接字符串、环境变量以及其他应用程序设置。 必须在函数应用之间共享的任何数据都应该以外部方式存储在持久存储中。

在 Azure 门户中开始

  1. 要开始,请转到 Azure 门户,并使用 Azure 帐户登录。 在门户顶端的搜索栏中,输入函数应用的名称,并从列表中将其选中。

  2. 在左窗格的“配置”下,选择“配置” 。

    Azure 门户中的函数应用概述

可以从概述页导航到管理函数应用所需的所有内容,特别是 应用程序设置 和 平台功能 。

使用应用程序设置

应用程序设置可以从 Azure 门户 管理,并且可以通过使用 Azure CLI 和 Azure PowerShell来管理。 你还可以从 Visual Studio Code 和 Visual Studio中管理应用程序设置。

这些设置以加密的存储。 若要了解详细信息,请参阅 应用程序设置安全性。

门户

若要查找应用程序设置,请参阅 开始 Azure 门户。

“应用程序设置”选项卡维护函数应用使用的设置。 你必须选择 " 显示值 " 才能在门户中查看值。 若要在门户中添加设置,请选择“新建应用程序设置”并添加新的键值对。

Azure 门户中的函数应用设置。

Azure CLI

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

Azure PowerShell

该 Get-AzFunctionAppSetting cmdlet 返回现有的应用程序设置,如以下示例中所示:

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"}

使用应用程序设置

还可以在代码中将函数应用设置值读取为环境变量。 有关详细信息,请参阅以下特定于语言的参考主题的“环境变量”部分:

在本地开发函数应用时,必须将这些值的本地副本保留在 local.settings.json 项目文件中。 若要了解详细信息,请参阅本地设置文件。

托管计划类型

创建 function app 时,还会创建一个运行应用的托管计划。 一个计划可以有一个或多个函数应用。 函数的功能、缩放和定价取决于计划的类型。 若要了解详细信息,请参阅 Azure Functions 宿主选项。

可以从 Azure 门户中或通过使用 Azure CLI 或 Azure PowerShell API 确定函数应用所使用的计划类型。

以下值指示计划类型:

计划类型 门户 Azure CLI/PowerShell
消耗 消耗 Dynamic
高级 ElasticPremium ElasticPremium
专用(应用服务) 各种 各种

Portal

要确定你的函数应用所使用的计划的类型,请在 Azure 门户中查看该函数应用的“概述”选项卡中的“应用服务计划” 。 若要查看定价层,请选择“应用服务计划”的名称,然后从左侧窗格中选择“属性” 。

在门户中查看缩放计划

Azure CLI

运行以下 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

运行以下 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 CLI 命令在消耗计划和 Windows 上的高级计划之间迁移函数应用。 具体的命令取决于迁移的方向。 当前不支持直接迁移到专用 (应用服务) 计划。

Linux 不支持这种迁移。

对高级版的消耗

使用以下过程从消耗计划迁移到 Windows 上的高级计划:

  1. 运行以下命令,在与现有 function App 相同的区域和资源组中创建新的应用服务计划 (弹性高级) 。

    az functionapp plan create --name <NEW_PREMIUM_PLAN_NAME> --resource-group <MY_RESOURCE_GROUP> --location <REGION> --sku EP1
    
  2. 运行以下命令,将现有函数应用迁移到新的高级计划

    az functionapp update --name <MY_APP_NAME> --resource-group <MY_RESOURCE_GROUP> --plan <NEW_PREMIUM_PLAN>
    
  3. 如果不再需要以前的消耗函数应用计划,请在确认已成功迁移到新计划后,删除原始 function app 计划。 运行以下命令,获取资源组中所有消耗计划的列表。

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

    您可以安全地删除包含零个站点的计划,这是从迁移的站点。

  4. 运行以下命令以删除迁移的消耗计划。

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

高级到消耗

使用以下过程从高级计划迁移到 Windows 上的消耗计划:

  1. 运行以下命令,在与现有 function app 相同的区域和资源组中创建新的 function app (消耗) 。 此命令还会创建函数应用运行的新消耗计划。

    az functionapp create --resource-group <MY_RESOURCE_GROUP> --name <NEW_CONSUMPTION_APP_NAME> --consumption-plan-location <REGION> --runtime dotnet --functions-version 3 --storage-account <STORAGE_NAME>
    
  2. 运行以下命令,将现有函数应用迁移到新的消耗计划。

    az functionapp update --name <MY_APP_NAME> --resource-group <MY_RESOURCE_GROUP> --plan <NEW_CONSUMPTION_PLAN>
    
  3. 删除你在步骤1中创建的函数应用,因为你只需要为运行现有函数应用而创建的计划。

    az functionapp delete --name <NEW_CONSUMPTION_APP_NAME> --resource-group <MY_RESOURCE_GROUP>
    
  4. 如果不再需要以前的高级函数应用计划,请在确认已成功迁移到新应用计划后,将其删除。 请注意,如果未删除该计划,则仍将按高级计划收费。 运行以下命令,获取资源组中所有高级计划的列表。

    az functionapp plan list --resource-group <MY_RESOURCE_GROUP> --query "[?sku.family=='EP'].{PlanName:name,Sites:numberOfSites}" -o table
    
  5. 运行以下命令以删除迁移的高级计划。

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

平台功能

函数应用在 Azure 应用服务平台中运行,并由该平台维护。 在这种情况下,Function App 有权访问 Azure 核心 Web 托管平台的大多数功能。 可在左侧窗格中访问可用于函数应用的应用服务平台中的许多功能。

Note: Function App 运行于消耗托管计划中时,并非所有应用服务功能均可用。

本文的其余部分侧重于 Azure 门户中以下可用于 Functions 的应用服务功能:

若要深入了解如何使用应用服务设置,请参阅配置 Azure 应用服务设置。

应用服务编辑器

应用服务编辑器

应用服务编辑器是一种高级的门户内编辑器,可用于修改诸如 JSON 配置文件和代码文件等内容。 选择此选项会启动单独的浏览器选项卡和基本编辑器。 借此,可与 Git 存储库集成、运行和调试代码,并可修改 Function App 设置。 同内置的函数编辑器相比,此编辑器为 Functions 提供了增强的开发环境。

建议你考虑在本地计算机上开发函数。 在本地开发项目并将其发布到 Azure 时,项目文件在门户中处于只读状态。 若要了解详细信息,请参阅在本地对 Azure Functions 进行编码和测试。

控制台

Function App 控制台

要从命令行与 Function App 交互时,门户内控制台就是非常合适的开发人员工具。 常见命令包括创建和导航目录与文件,以及执行批处理文件和脚本。

在本地进行开发时,建议使用 Azure Functions Core Tools 和 Azure CLI。

高级工具 (Kudu)

配置 Kudu

应用服务的高级工具(也称为 Kudu)提供对 Function App 高级管理功能的访问。 从 Kudu 中,可以管理系统信息、应用设置、环境变量、站点扩展、HTTP 头和服务器变量。 也可以通过浏览到 Function App 的 SCM 终结点(如 https://<myfunctionapp>.scm.azurewebsites.net/),启动 Kudu

部署中心

使用源代码管理解决方案来开发和维护函数代码时,可以使用部署中心通过源代码管理进行生成和部署。 进行更新时,会生成项目并将其部署到 Azure。 有关详细信息,请参阅 Azure Functions 中的部署技术。

跨域资源共享

为了防止在客户端执行恶意代码,新式的浏览器会阻止 Web 应用程序向正在单独的域中运行的资源发送请求。 跨域资源共享 (CORS) 允许 Access-Control-Allow-Origin 标头声明允许哪些域调用函数应用上的终结点。

门户

配置函数应用的“允许的域”列表时,Access-Control-Allow-Origin 标头会自动添加到函数应用中 HTTP 终结点发出的所有响应。

配置函数应用的 CORS 列表

使用星号 (*) 时,会忽略所有其他的域。

使用 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 命令列出目前允许的域。

身份验证

配置 Function App 的身份验证

函数使用 HTTP 触发器时,可以要求首先对调用进行身份验证。 应用服务支持通过社交提供商(例如 Facebook、Microsoft 和 Twitter)进行 Azure Active Directory 身份验证和登录。 有关配置特定身份验证提供程序的详细信息,请参阅 Azure 应用服务身份验证概述。

后续步骤

历史资料。此文对应 2022-08-12 的中文文档快照,适用产品版本和命令行为以原文为准。

来源与署名:Microsoft 和文档贡献者。固定版本原文。文档采用 CC BY 4.0,示例代码采用 MIT 授权。本站将 Markdown 转为 HTML,规范化链接,移除外部媒体、发布器占位标签和导航标记。

资料来源与适用范围

资料来源
Microsoft / Azure 中文运维文档历史快照
适用范围
历史中文快照 2022-08-12;详见原文产品版本;文档日期 04/13/2020
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-16
授权说明
CC BY 4.0(文档)/ MIT(示例代码)

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。