函数应用中的应用设置包含对该函数应用的所有函数产生影响的全局配置选项。 在本地运行时,这些设置将作为本地环境变量进行访问。 本文列出可在函数应用中使用的应用设置。
可以通过以下几种方法添加、更新和删除函数应用设置:
如果更改函数应用设置,则需要重启函数应用。
host.json 文件和 local.settings.json 文件中提供了其他全局配置选项。
Note:
可以使用应用程序设置替代 host.json 设置值,而不必更改 host.json 文件本身。 这对于需要针对特定环境配置或修改特定 host.json 设置的方案很有用。 这也让你可以更改 host.json 设置,而不必重新发布项目。 若要了解详细信息,请参阅 host.json 参考文章。 如果更改函数应用设置,则需要重启函数应用。
APPINSIGHTS_INSTRUMENTATIONKEY
Application Insights 的检测密钥。 仅使用 APPINSIGHTS_INSTRUMENTATIONKEY 或 APPLICATIONINSIGHTS_CONNECTION_STRING 中的一个。 当 Application Insights 在主权云中运行时,请使用 APPLICATIONINSIGHTS_CONNECTION_STRING。 有关详细信息,请参阅如何配置对 Azure Functions 的监视。
| 键 | 示例值 |
|---|---|
| APPINSIGHTS_INSTRUMENTATIONKEY | 55555555-af77-484b-9032-64f83bb83bb |
APPLICATIONINSIGHTS_CONNECTION_STRING
Application Insights 的连接字符串。 在以下情况下使用 APPLICATIONINSIGHTS_CONNECTION_STRING 而不是 APPINSIGHTS_INSTRUMENTATIONKEY:
- 当函数应用需要通过连接字符串提供支持的已添加自定义项时。
- 当 Application Insights 实例在需要自定义终结点的主权云中运行时。
有关详细信息,请参阅连接字符串。
| 键 | 示例值 |
|---|---|
| APPLICATIONINSIGHTS_CONNECTION_STRING | InstrumentationKey=[key];IngestionEndpoint=[url];LiveEndpoint=[url];ProfilerEndpoint=[url];SnapshotEndpoint=[url]; |
AZURE_FUNCTION_PROXY_DISABLE_LOCAL_CALL
默认情况下,Functions 代理使用快捷方式从代理直接将 API 调用发送到同一函数应用中的函数。 使用此快捷方式取代创建新的 HTTP 请求。 此设置让你能够禁用该快捷方式行为。
| 键 | “值” | 说明 |
|---|---|---|
| AZURE_FUNCTION_PROXY_DISABLE_LOCAL_CALL | 是 | 具有指向本地函数应用中函数的后端 URL 的调用不会直接发送到函数, 相反,请求会定向回函数应用的 HTTP 前端。 |
| AZURE_FUNCTION_PROXY_DISABLE_LOCAL_CALL | false | 具有指向本地函数应用中函数的后端 URL 的调用会直接转发到函数。 这是默认值。 |
AZURE_FUNCTION_PROXY_BACKEND_URL_DECODE_SLASHES
此设置控制字符 %2F 在路由参数插入后端 URL 时是否在路由参数中解码为斜杠。
| 键 | “值” | 说明 |
|---|---|---|
| AZURE_FUNCTION_PROXY_BACKEND_URL_DECODE_SLASHES | 是 | 包含编码斜杠的路由参数已解码。 |
| AZURE_FUNCTION_PROXY_BACKEND_URL_DECODE_SLASHES | false | 所有路由参数均原样传递,这是默认行为。 |
例如,考虑位于 myfunction.com 域的函数应用的 proxies.json 文件。
{
"$schema": "http://json.schemastore.org/proxies",
"proxies": {
"root": {
"matchCondition": {
"route": "/{*all}"
},
"backendUri": "example.com/{all}"
}
}
}
如果 AZURE_FUNCTION_PROXY_BACKEND_URL_DECODE_SLASHES 设置为 true,则 URL example.com/api%2ftest 解析为 example.com/api/test。 默认情况下,URL 保持为 example.com/test%2fapi 不变。 有关详细信息,请参阅 Functions 代理。
AZURE_FUNCTIONS_ENVIRONMENT
在 2.x 和更高版本的 Functions 运行时中,基于运行时环境配置应用行为。 在初始化期间读取此值。 可以将 AZURE_FUNCTIONS_ENVIRONMENT 设置为任何值,但支持三个值:Development、Staging 和 Production。 如果未设置 AZURE_FUNCTIONS_ENVIRONMENT,则在本地环境中默认为 Development,在 Azure 中默认为 Production。 应使用此设置(而不是 ASPNETCORE_ENVIRONMENT)来设置运行时环境。
AzureFunctionsJobHost__*
在 Functions 运行时的版本 2.x 和更高版本中,应用程序设置可以替代当前环境中的 host.json 设置。 这些替代表示为名为 AzureFunctionsJobHost__path__to__setting 的应用程序设置。 有关详细信息,请参阅替代 host.json 值。
AzureWebJobsDashboard
用于存储日志并在门户上的“监视”选项卡中显示这些日志的可选存储帐户连接字符串。 此设置仅对面向 Azure Functions 运行时版本 1.x 的应用有效。 存储帐户必须是支持 Blob、队列和表的通用帐户。 有关详细信息,请参阅存储帐户要求。
| 键 | 示例值 |
|---|---|
| AzureWebJobsDashboard | DefaultEndpointsProtocol=https;AccountName=<name>;AccountKey=<key> |
Note: 为了获得更好的性能和体验,运行时版本 2.x 及更高版本使用 APPINSIGHTS_INSTRUMENTATIONKEY 和 App Insights 进行监视,而不是使用
AzureWebJobsDashboard。
AzureWebJobsDisableHomepage
true 表示禁用针对函数应用根 URL 显示的默认登录页。 默认值为 false。
| 键 | 示例值 |
|---|---|
| AzureWebJobsDisableHomepage | 是 |
如果省略此应用设置或将其设置为 false,则会显示类似于以下示例的页来响应 URL <functionappname>.azurewebsites.net。
函数应用登录页
AzureWebJobsDotNetReleaseCompilation
true 表示在编译 .NET 代码时使用“发布”模式;false 表示使用“调试”模式。 默认值为 true。
| 键 | 示例值 |
|---|---|
| AzureWebJobsDotNetReleaseCompilation | 是 |
AzureWebJobsFeatureFlags
要启用的 beta 功能的逗号分隔列表。 由这些标志启用的 Beta 功能尚未准备好用于生产,但在发布这些功能之前可针对试验目的启用这些功能。
| 键 | 示例值 |
|---|---|
| AzureWebJobsFeatureFlags | feature1,feature2 |
AzureWebJobsSecretStorageType
指定用于密钥存储的存储库或提供程序。 目前,支持的存储库包括 blob 存储(“Blob”)和本地文件系统(“Files”)。 默认为在版本 2 中使用 blob,在版本 1 中使用文件系统。
| 键 | 示例值 |
|---|---|
| AzureWebJobsSecretStorageType | 文件 |
AzureWebJobsStorage
Azure Functions 运行时使用此存储帐户连接字符串执行常规操作。 此存储帐户的一些用途包括密钥管理、计时器触发器管理和事件中心检查点。 存储帐户必须是支持 Blob、队列和表的通用帐户。 请参阅存储帐户和存储帐户要求。
| 键 | 示例值 |
|---|---|
| AzureWebJobsStorage | DefaultEndpointsProtocol=https;AccountName=[name];AccountKey=[key] |
AzureWebJobs_TypeScriptPath
用于 TypeScript 的编译器的路径。 允许根据需要重写默认值。
| 键 | 示例值 |
|---|---|
| AzureWebJobs_TypeScriptPath | %HOME%\typescript |
FUNCTION_APP_EDIT_MODE
指示是否在 Azure 门户中启用了编辑。 有效值为“readwrite”和“readonly”。
| 键 | 示例值 |
|---|---|
| FUNCTION_APP_EDIT_MODE | readonly |
FUNCTIONS_EXTENSION_VERSION
要在此函数应用中使用的 Functions 运行时版本。 波浪符加主要版本号表示使用该主要版本的最新版本(例如“~2”)。 当同一主要版本的新版本可用时,会自动在函数应用中安装新版本。 若要让应用固定使用特定的版本,请使用完整版本号(例如“2.0.12345”)。 默认值为“~2”。 值 ~1 让应用固定使用运行时版本 1.x。
| 键 | 示例值 |
|---|---|
| FUNCTIONS_EXTENSION_VERSION | ~2 |
FUNCTIONS_V2_COMPATIBILITY_MODE
此设置使函数应用能够在版本 3.x 运行时上以版本 2.x 兼容模式运行。 仅当在将函数应用从运行时版本 2.x 升级到版本 3.x 时遇到问题的情况下,才使用此设置。
Important: 在更新应用以便在版本 3.x 上正常运行时,此设置仅用作短期解决方法。 只要 2.x 运行时受支持,此设置就受支持。 如果在不使用此设置的情况下遇到阻止应用在版本 3.x 上运行的问题,请报告问题。
需要 FUNCTIONS_EXTENSION_VERSION 设置为 ~3。
| 键 | 示例值 |
|---|---|
| FUNCTIONS_V2_COMPATIBILITY_MODE | 是 |
FUNCTIONS_WORKER_PROCESS_COUNT
指定语言工作进程的最大数量,其默认值为 1。 允许的最大值为 10。 函数调用均匀地分布在语言工作进程中。 语言工作进程每 10 秒生成一次,直到达到 FUNCTIONS_WORKER_PROCESS_COUNT 设置的计数。 使用多个语言工作进程与缩放不同。 当工作负荷混合使用 CPU 绑定和 I/O 绑定调用时,请考虑使用此设置。 此设置适用于所有非 .NET 语言。
| 键 | 示例值 |
|---|---|
| FUNCTIONS_WORKER_PROCESS_COUNT | 2 |
PYTHON _ THREADPOOL _ 线程 _ 计数
指定 Python 语言辅助角色将用于执行函数调用的最大线程数,其默认值 1 为 Python 版本及更高版本 3.8 。 对于 Python 版本 3.9 及更高版本,该值设置为 None 。 请注意,此设置不能保证在执行过程中设置的线程数。 此设置允许 Python 将线程数扩展到指定的值。 此设置仅适用于 Python 函数应用。 此外,此设置还适用于同步函数调用,不适用于协同程序。
| 键 | 示例值 | 最大值 |
|---|---|---|
| PYTHON _ THREADPOOL _ 线程 _ 计数 | 2 | 32 |
FUNCTIONS_WORKER_RUNTIME
要在函数应用中加载的语言辅助角色运行时。 这将对应于应用程序中使用的语言(例如,“dotnet”)。 对于使用多种语言的函数,需要将这些函数发布到多个应用(每个应用程序都有相应的辅助角色运行时值)。 有效值为 dotnet (C#/F#)、node (JavaScript/TypeScript)、java (Java)、powershell (PowerShell) 和 python (Python)。
| 键 | 示例值 |
|---|---|
| FUNCTIONS_WORKER_RUNTIME | dotnet |
PIP _ 额外 _ 索引 _ URL
此设置的值指示 Python 应用的自定义包索引 URL。 如果需要使用在额外的包索引中找到的自定义依赖项运行远程生成,请使用此设置。
| 键 | 示例值 |
|---|---|
| PIP _ 额外 _ 索引 _ URL | http://my.custom.package.repo/simple |
若要了解详细信息,请参阅 Python 开发人员参考中的 自定义依赖项 。
扩展 _ 控制器 _ 日志记录 _ 已启用
此设置当前处于预览状态。
此设置控制 Azure Functions 缩放控制器中的日志记录。 有关详细信息,请参阅缩放控制器日志。
| 键 | 示例值 |
|---|---|
| SCALE_CONTROLLER_LOGGING_ENABLED | AppInsights:Verbose |
此键的值以 <DESTINATION>:<VERBOSITY> 格式提供,其定义如下:
<DESTINATION> |
日志发送到的目标。 有效值为 AppInsights 和 Blob。使用 AppInsights 时,请确保在函数应用中启用 Application Insights。将目标设置为 Blob 时,将在名为 azure-functions-scale-controller 的 blob 容器中创建日志,该容器位于 AzureWebJobsStorage 应用程序设置中设置的默认存储帐户中。 |
<VERBOSITY> |
指定日志记录级别。 支持的值为 None、Warning 和 Verbose。设置为 Verbose 时,缩放控制器将记录辅助角色计数每次更改的原因,以及有关将这些因素纳入决策的触发器的信息。 详细日志包含触发器警告和缩放控制器运行前后触发器使用的哈希。 |
Tip: 请记住,在启用缩放控制器日志记录的同时,它会影响 监视函数应用的潜在成本。 请考虑启用日志记录,直到收集了足够的数据来了解规模控制器的行为方式,然后再将其禁用。
WEBSITE_CONTENTAZUREFILECONNECTIONSTRING
存储帐户的连接字符串,该帐户的函数应用代码和配置存储在 Windows 上运行的事件驱动缩放计划中。 有关详细信息,请参阅创建函数应用。
| 键 | 示例值 |
|---|---|
| WEBSITE_CONTENTAZUREFILECONNECTIONSTRING | DefaultEndpointsProtocol=https;AccountName=[name];AccountKey=[key] |
仅在部署到高级计划或在 Windows 上运行的消耗计划时使用。 对于运行 Linux 的使用量计划不支持。 更改或删除此设置可能会导致函数应用无法启动。 若要了解详细信息,请参阅此故障排除文章。
WEBSITE_CONTENTOVERVNET
仅用于高级计划。 将存储帐户限制在虚拟网络中时,值 1 允许函数应用进行缩放。 将存储帐户限制于一个虚拟网络时,应启用此设置。 若要了解详细信息,请参阅将存储帐户限制在虚拟网络中。
| 键 | 示例值 |
|---|---|
| WEBSITE_CONTENTOVERVNET | 1 |
WEBSITE_CONTENTSHARE
Windows 上事件驱动的缩放计划中函数应用代码和配置的文件路径。 与 WEBSITE_CONTENTAZUREFILECONNECTIONSTRING 结合使用。 默认值是以函数应用名称开头的唯一字符串。 请参阅创建函数应用。
| 键 | 示例值 |
|---|---|
| WEBSITE_CONTENTSHARE | functionapp091999e2 |
仅在部署到高级计划或在 Windows 上运行的消耗计划时使用。 对于运行 Linux 的使用量计划不支持。 更改或删除此设置可能会导致函数应用无法启动。 若要了解详细信息,请参阅此故障排除文章。
在部署期间使用 Azure 资源管理器创建函数应用时,请不要在模板中包括 WEBSITE_CONTENTSHARE。 此应用程序设置是在部署过程中生成的。 若要了解详细信息,请参阅为函数应用自动执行资源部署。
WEBSITE_MAX_DYNAMIC_APPLICATION_SCALE_OUT
函数应用可以横向扩展到的最大实例数。 默认值为无限制。
Important: 此设置处于预览状态。 添加了一个函数应用横向扩展上限属性,建议使用此方法限制横向扩展。
| 键 | 示例值 |
|---|---|
| WEBSITE_MAX_DYNAMIC_APPLICATION_SCALE_OUT | 5 |
WEBSITE_NODE_DEFAULT_VERSION
仅限 Windows。
设置在 Windows 上运行函数应用时要使用的 Node.js 版本。 应使用波形符 (~) 让运行时使用目标主版本的最新可用版本。 例如,当设置为 ~10 时,将使用最新版本 Node.js 10。 当目标主版本带有波形符时,无需手动更新次版本。
| 键 | 示例值 |
|---|---|
| WEBSITE_NODE_DEFAULT_VERSION | ~10 |
WEBSITE_RUN_FROM_PACKAGE
让函数应用从已装载的包文件运行。
| 键 | 示例值 |
|---|---|
| WEBSITE_RUN_FROM_PACKAGE | 1 |
有效值是解析为部署包文件位置的 URL 或 1。 设置为 1 时,包必须位于 d:\home\data\SitePackages 文件夹中。 使用此设置的 zip 部署时,包将自动上传到此位置。 在预览版中,此设置名为 WEBSITE_RUN_FROM_ZIP。 有关详细信息,请参阅从包文件运行函数。
WEBSITE_TIME_ZONE
允许为函数应用设置时区。
| 键 | (OS) | 示例值 |
|---|---|---|
| WEBSITE_TIME_ZONE | Windows | 东部标准时间 |
| WEBSITE_TIME_ZONE | Linux | 美洲/New_York |
CRON 表达式使用的默认时区为协调世界时 (UTC)。 若要让 CRON 表达式基于其他时区,请为你的函数应用创建一个名为 WEBSITE_TIME_ZONE 的应用设置。
此设置的值取决于运行函数应用的操作系统和计划。
| 操作系统 | 计划 | 值 |
|---|---|---|
| Windows | All | 将值设置为所需时区的名称,由 Windows 命令给定的每个对中的第二行给定 tzutil.exe /L |
| Linux | 高级专用 | 将值设置为所需时区的名称,如 tz 数据库中所示。 |
Note: Linux 消耗计划目前不支持
WEBSITE_TIME_ZONE。
例如,美国东部时间 (由 Eastern Standard Time (Windows) 或 (Linux 表示, America/New_York) # A5 目前在标准时间04:00 和在夏令时期间使用 utc-05:00。 若要使计时器触发器每天凌晨10:00 触发,请创建名为的函数应用的应用设置 WEBSITE_TIME_ZONE ,将此值设置为 Eastern Standard Time (Windows) 或 America/New_York (Linux) ,然后使用以下 NCRONTAB 表达式:
"0 0 10 * * *"
当使用 WEBSITE_TIME_ZONE 时间时,将针对特定时区中的时间更改(包括夏令时和标准时间更改)进行调整。
后续步骤
历史资料。此文对应 2022-08-12 的中文文档快照,适用产品版本和命令行为以原文为准。
来源与署名:Microsoft 和文档贡献者。固定版本原文。文档采用 CC BY 4.0,示例代码采用 MIT 授权。本站将 Markdown 转为 HTML,规范化链接,移除外部媒体和导航标记。
