在单租户 Azure 逻辑应用中编辑标准逻辑应用的主机和应用设置

适用于：Azure 逻辑应用（标准）

在单租户 Azure 逻辑应用中，标准逻辑应用的应用设置指定会影响该逻辑应用中所有工作流的全局配置选项。 但是，这些设置仅在这些工作流在本地开发环境中运行时适用 。 在本地运行的工作流可以将这些应用设置作为本地环境变量来访问，本地开发工具将这些变量用于可能经常在环境之间更改的值。 例如，这些值可以包含连接字符串。 部署到 Azure 时，应用设置将被忽略并且不包含在部署中。

逻辑应用还具有主机设置，这些设置指定用于该逻辑应用中所有工作流的运行时配置设置和值，例如吞吐量、容量、数据大小等的默认值，无论它们是在本地运行还是在 Azure 中运行 。

应用设置、参数和部署

在多租户 Azure 逻辑应用中，部署依赖于 Azure 资源管理器模板（ARM 模板），这些模板组合并处理逻辑应用和基础结构的资源预配。 当需要维护各种不同的开发、测试和生产环境中的逻辑应用的环境变量时，这种设计会带来困难。 ARM 模板中的所有内容都是在部署时定义的。 如果只需更改单个变量，必须重新部署所有内容。

在单租户 Azure 逻辑应用中，部署会容易一些，因为可以将应用与基础结构的资源预配相分离。 可以使用参数来抽象化可能在环境之间发生更改的值。 通过定义工作流中使用的参数，可以先专注于工作流的设计，然后稍后插入特定于环境的变量。 可以使用应用设置和参数在运行时调用和引用环境变量。 这样，就不必经常重新部署。

应用设置与 Azure Key Vault 集成。 可以直接引用安全字符串，例如连接字符串和密钥。 与 Azure 资源管理器模板（ARM 模板）类似，可以在部署时定义环境变量，可以在逻辑应用工作流定义中定义应用设置。 然后，可以捕获动态生成的基础结构值，例如连接终结点、存储字符串等。 但是，应用设置具有大小限制，无法从 Azure 逻辑应用中的某些区域引用。

有关设置逻辑应用以进行部署的详细信息，请参阅以下文档：

• 为在不同单租户 Azure 逻辑应用环境的工作流中会有所不同的值创建参数
• 基于单租户的逻辑应用的 DevOps 部署概述
• 为基于单租户逻辑应用设置 DevOps 部署

Visual Studio Code 项目结构

在 Visual Studio Code 中，逻辑应用项目具有以下类型之一：

• 基于扩展捆绑包 (Node.js)（默认类型）
• 基于 NuGet 包 (.NET)（可从默认类型转换）

根据这些类型，项目包含略有不同的文件夹和文件。 基于 NuGet 的项目包含一个 .bin 文件夹，其中包含包和其他库文件。 基于捆绑包的项目不包括 .bin 文件夹和其他文件。 某些场景需要基于 NuGet 的项目以运行应用，例如，在想要开发和运行自定义内置操作时。 有关将项目转换为使用 NuGet 的详细信息，请参阅启用内置连接器创作。

默认的基于捆绑包的项目具有类型于以下示例的文件夹和文件结构：

MyBundleBasedLogicAppProjectName
| .vscode
| Artifacts
  || Maps 
     ||| MapName1
     ||| ...
  || Schemas
     ||| SchemaName1
     ||| ...
| WorkflowName1
  || workflow.json
  || ...
| WorkflowName2
  || workflow.json
  || ...
| workflow-designtime
| .funcignore
| connections.json
| host.json
| local.settings.json

你可以在项目的根级别找到包含其他项的以下文件和文件夹：

应用设置参考 - local.settings.json

在 Visual Studio Code 中逻辑应用项目的根级别，local.settings.json 文件包含全局配置选项，在本地开发环境中运行时这些选项会影响该逻辑应用中的所有工作流。 当工作流在本地运行时，系统将这些设置作为本地环境变量进行访问，并且它们的值通常在运行工作流的各种环境中会有所不同。 若要查看和管理这些设置，请查看管理应用设置 - local.settings.json。

Azure 逻辑应用中的应用设置的作用方式与 Azure Functions 或 Azure Web 应用中的应用设置的作用方式类似。 如果你以前使用过这些其他服务，可能已熟悉应用设置。 有关详细信息，请查看 Azure Functions 的应用设置参考和使用 Azure Functions Core Tools - 本地设置文件。

管理应用设置 - local.settings.json

若要添加、更新或删除应用设置，请选择并查看 Azure 门户、Visual Studio Code、Azure CLI 或 ARM (Bicep) 模板的以下部分。 有关特定于逻辑应用的应用设置，请查看可用应用设置的参考指南 - local.settings.json。

az logicapp config appsettings list --name MyLogicApp --resource-group MyResourceGroup

az logicapp config appsettings set --name MyLogicApp --resource-group MyResourceGroup --settings CUSTOM_LOGIC_APP_SETTING=12345 

主机设置参考 - host.json

在 Visual Studio Code 中逻辑应用项目的根级别，host.json 元数据文件包含运行时设置和默认值，这些设置将用于逻辑应用资源中的所有工作流，无论是在本地运行还是 Azure 中运行。 若要查看和管理这些设置，请查看管理主机设置 - host.json。 若要了解相关限制的信息，请参阅 Azure 逻辑应用的限制和配置文档。

作业业务流程吞吐量

这些设置会影响单租户 Azure 逻辑应用运行工作流操作时的吞吐量和容量。

以下两个设置都用于手动停止并立即删除标准逻辑应用中的指定工作流。

以下示例显示了这些设置的语法，其中每个工作流 ID 后跟一个冒号 (:)，并用分号 (;) 分隔：

"Jobs.CleanupJobPartitionPrefixes": "<workflow-ID-1>:; <workflow-ID-2:",
"Jobs.SuspendedJobPartitionPrefixes": "<workflow-ID-1>:; <workflow-ID-2>:"

基于目标的缩放

使用单租户 Azure 逻辑应用可以选择首选的计算资源，并设置逻辑应用资源，以便根据不同的工作负荷需求进行动态缩放。 Azure 逻辑应用使用的基于目标的缩放模型包括可用于微调模型的基础动态缩放机制的设置，这可能导致更短的横向扩展和横向缩减时间。 有关基于目标的缩放模型的详细信息，请参阅在单租户 Azure 逻辑应用中基于目标缩放标准工作流。

注意事项

• 对于在应用服务环境或消耗计划上运行的标准工作流，基于目标的缩放不可用或不受支持。

• 如果有横向缩减请求但没有任何横向扩展请求，Azure 逻辑应用将使用最大横向缩减值。 基于目标的缩放可以更快地纵向缩减未使用的辅助角色实例，从而提高资源使用率。

要求

• 逻辑应用必须使用 Azure Functions 运行时版本 4.3.0 或更高版本。

• 逻辑应用工作流必须使用单租户 Azure 逻辑应用运行时版本 1.55.1 或更高版本。

host.json 中基于目标的缩放设置

TargetConcurrency 示例

{
   "version": "2.0",
   "extensionBundle": {
      "id": "Microsoft.Azure.Functions.ExtensionBundle.Workflows",
      "version": "[1.*, 2.0.0)"
   },
   "extensions": {
      "workflow": {
         "Settings": {
            "Runtime.TargetScaler.TargetConcurrency": "280"
         }
      }
   }
}

TargetScalingCPU 示例

{
   "version": "2.0",
   "extensionBundle": {
      "id": "Microsoft.Azure.Functions.ExtensionBundle.Workflows",
      "version": "[1.*, 2.0.0)"
   },
   "extensions": {
      "workflow": {
         "Settings": {
            "Runtime.TargetScaler.TargetScalingCPU": "76"
         }
      }
   }
}

TargetScalingFactor 示例

{
   "version": "2.0",
   "extensionBundle": {
      "id": "Microsoft.Azure.Functions.ExtensionBundle.Workflows",
      "version": "[1.*, 2.0.0)"
   },
   "extensions": {
      "workflow": {
         "Settings": {
            "Runtime.TargetScaler.TargetScalingFactor": "0.62"
         }
      }
   }
}

禁用基于目标的缩放

默认情况下，会自动启用基于目标的缩放。 若要选择退出使用基于目标的缩放并恢复为增量缩放，请添加名为 TARGET_BASED_SCALING_ENABLED 的应用设置，并使用 Azure 门户在标准逻辑应用资源中或使用 Visual Studio Code 在逻辑应用项目的 local.settings.json 文件中将该值设置为 0。 有关详细信息，请参阅管理应用设置 - local.settings.json。

基于定期的触发器

触发器并发

以下设置仅适用于以定期触发器开始的工作流，该触发器用于基于服务提供程序的内置连接器。 对于以函数触发器开始的工作流，可以尝试在受支持时设置批处理。 但是，批处理并非始终都是正确的解决方案。 例如，使用 Azure 服务总线触发器时，批处理可能会保留超过锁定持续时间的消息。 因此，出现此类消息时，任何操作（如完成或放弃）都将失败。

运行持续时间和历史记录保留期

运行操作

输入和输出

分页

分块

以内联方式存储内容或使用 Blob

For each 循环

Until 循环

变量

内置 HTTP 操作

内置 HTTP Webhook 操作

内置 Azure 存储操作

Blob 存储

表和队列存储

文件共享

内置 Azure Functions 操作

内置 Azure 服务总线操作

内置 SFTP 操作

托管连接器操作

所有其他操作的重试策略

限制

• 最大内容大小

  默认情况下，内置触发器（如 HTTP 或请求）仅限于限制和配置参考 - 消息中描述的消息大小。 若要处理超出限制大小的文件，请尝试将内容作为 blob 上传到 Azure Blob 存储，然后使用 Azure Blob 连接器获取内容。

管理主机设置 - host.json

可以添加、更新或删除主机设置，这些设置指定将用于该逻辑应用中所有工作流的运行时配置设置和值，例如吞吐量、容量、数据大小等的默认值，无论它们是在本地运行还是 Azure 中运行 。 有关特定于逻辑应用的主机设置，请查看可用运行时和部署设置的参考指南 - host.json。

Azure 门户 - host.json

若要在 Azure 门户中查看基于单租户的逻辑应用的主机设置，请执行以下步骤：

1. 在 Azure 门户搜索框中，找到并打开你的逻辑应用。

2. 在逻辑应用菜单上的“开发工具”下，选择“高级工具”。

3. 在“高级工具”窗格上，选择“转到”，这将打开逻辑应用的 Kudu 环境 。

4. 在 Kudu 工具栏上，打开“调试控制台”菜单，然后选择“CMD” 。

5. 在 Azure 门户中，停止你的逻辑应用。

   1. 在逻辑应用菜单中，选择“概述”。

   2. 在“概述”窗格的工具栏上，选择“停止”。

6. 在逻辑应用菜单上的“开发工具”下，选择“高级工具”。

7. 在“高级工具”窗格上，选择“转到”，这将为你的逻辑应用打开 Kudu 环境。

8. 在 Kudu 工具栏上，打开“调试控制台”菜单，并选择“CMD”。

   此时将打开一个控制台窗口，以便你可使用命令提示符浏览到 wwwroot 文件夹。 另外，你可以浏览控制台窗口上方显示的目录结构。

9. 沿着以下路径浏览到 wwwroot 文件夹：...\home\site\wwwroot。

10. 在控制台窗口上方的目录表中，选择 host.json 文件旁边的“编辑” 。

11. 打开 host.json 后，查看之前为逻辑应用添加的所有主机设置。

    有关主机设置的详细信息，请查看可用主机设置的参考指南 - host.json。

若要添加设置，请执行以下步骤：

1. 在添加或编辑设置之前，请在 Azure 门户中停止逻辑应用。

   1. 在逻辑应用菜单中，选择“概述”。
   2. 在“概述”窗格的工具栏上，选择“停止”。

2. 返回到 host.json 文件。 在 extensionBundle 对象下，添加包含 workflow 和 settings 对象的 extensions 对象，例如：

   {
      "version": "2.0",
      "extensionBundle": {
         "id": "Microsoft.Azure.Functions.ExtensionBundle",
         "version": "[1.*, 2.0.0)"
      },
      "extensions": {
         "workflow": {
            "settings": {
            }
         }
      }
   }
   

3. 在 settings 对象中，添加一个包含要用于逻辑应用中所有工作流的主机设置的简单列表，无论这些工作流是在本地运行还是 Azure 中运行，例如：

   {
      "version": "2.0",
      "extensionBundle": {
         "id": "Microsoft.Azure.Functions.ExtensionBundle",
         "version": "[1.*, 2.0.0)"
      },
      "extensions": {
         "workflow": {
            "settings": {
               "Runtime.Trigger.MaximumWaitingRuns": "100"
            }
         }
      }
   }
   

4. 完成后，记得选择“保存”。

5. 现在，重启逻辑应用。 返回到逻辑应用的“概述”页，然后选择“重启” 。

Visual Studio Code - host.json

若要在 Visual Studio Code 中查看逻辑应用的主机设置，请执行以下步骤：

1. 在逻辑应用项目中的根项目级别，找到并打开 host.json 文件。

2. 在 extensions 对象中的 workflows 和 settings 下，查看以前为逻辑应用添加的所有主机设置。 否则 extensions 对象不会出现在文件中。

   有关主机设置的详细信息，请查看可用主机设置的参考指南 - host.json。

若要添加主机设置，请执行以下步骤：

1. 在 host.json 文件中的 extensionBundle 对象下，添加包含 workflow 和 settings 对象的 extensions 对象，例如：

   {
      "version": "2.0",
      "extensionBundle": {
         "id": "Microsoft.Azure.Functions.ExtensionBundle",
         "version": "[1.*, 2.0.0)"
      },
      "extensions": {
         "workflow": {
            "settings": {
            }
         }
      }
   }
   

2. 在 settings 对象中，添加一个包含要用于逻辑应用中所有工作流的主机设置的简单列表，无论这些工作流是在本地运行还是 Azure 中运行，例如：

   {
      "version": "2.0",
      "extensionBundle": {
         "id": "Microsoft.Azure.Functions.ExtensionBundle",
         "version": "[1.*, 2.0.0)"
      },
      "extensions": {
         "workflow": {
            "settings": {
               "Runtime.Trigger.MaximumWaitingRuns": "100"
            }
         }
      }
   }
   

后续步骤

• 为在不同单租户 Azure 逻辑应用环境的工作流中会有所不同的值创建参数
• 为单租户 Azure 逻辑应用设置 DevOps 部署