第 18 章 实例和容器组

在定义节点时使用以下条件：

您可以在清单文件中定义自定义组，将组命名为 instance_group solutions，其中 * 成为 API 中的组名称。您还可以在安装完成后在 API 中创建自定义实例组。

当前的行为需要 instance_groupEscalation 的一个成员是 automationcontroller 或 execution_nodes 组的成员。

[automationcontroller]
126-addr.tatu.home ansible_host=192.168.111.126  node_type=control

[automationcontroller:vars]
peers=execution_nodes

[execution_nodes]

[instance_group_test]
110-addr.tatu.home ansible_host=192.168.111.110 receptor_listener_port=8928

运行安装程序后，会出现以下错误：

TASK [ansible.automation_platform_installer.check_config_static : Validate mesh topology] ***
fatal: [126-addr.tatu.home -> localhost]: FAILED! => {"msg": "The host '110-addr.tatu.home' is not present in either [automationcontroller] or [execution_nodes]"}

要解决这个问题，请将 110-addr.tatu.home 框移到 execution_node 组：

[automationcontroller]
126-addr.tatu.home ansible_host=192.168.111.126  node_type=control

[automationcontroller:vars]
peers=execution_nodes

[execution_nodes]
110-addr.tatu.home ansible_host=192.168.111.110 receptor_listener_port=8928

[instance_group_test]
110-addr.tatu.home

结果：

TASK [ansible.automation_platform_installer.check_config_static : Validate mesh topology] ***
ok: [126-addr.tatu.home -> localhost] => {"changed": false, "mesh": {"110-addr.tatu.home": {"node_type": "execution", "peers": [], "receptor_control_filename": "receptor.sock", "receptor_control_service_name": "control", "receptor_listener": true, "receptor_listener_port": 8928, "receptor_listener_protocol": "tcp", "receptor_log_level": "info"}, "126-addr.tatu.home": {"node_type": "control", "peers": ["110-addr.tatu.home"], "receptor_control_filename": "receptor.sock", "receptor_control_service_name": "control", "receptor_listener": false, "receptor_listener_port": 27199, "receptor_listener_protocol": "tcp", "receptor_log_level": "info"}}}

从自动化控制器 4.0 或更早版本升级后，旧的 instance_group_ 成员可能会安装 awx 代码。这会将该节点放置在 automationcontroller 组中。

您可以作为系统管理员 POST 到 /api/v2/instance_groups 来创建实例组。

创建后，您可以使用以下命令将实例与实例组关联：

HTTP POST /api/v2/instance_groups/x/instances/ {'id': y}`

添加到实例组中的实例会自动重新配置自身，以侦听组的工作队列。如需更多信息，请参阅以下 实例组策略 部分。

您可以通过定义策略，将自动化控制器实例配置为在其上线时自动加入实例组。这些策略会针对上线的每个新实例进行评估。

实例组策略由一个实例组中的以下三个可选字段控制：

自动化控制器用户界面(UI)中的 实例组 列表视图根据实例组策略为每个实例组提供容量级别的概述：

请考虑以下策略注意事项：

如果您有一个特殊的实例，它只需要分配给特定的实例组，但不想根据"百分比"或"最小"策略自动加入其他组：

这可防止实例根据百分比和最小策略自动添加到其他组中。它仅属于您手动为其分配的组：

HTTP PATCH /api/v2/instance_groups/N/
{
"policy_instance_list": ["special-instance"]
}
HTTP PATCH /api/v2/instances/X/
{
"managed_by_policy": False
}

当您运行与实例组关联的作业时，请注意以下行为：

如果您将实例组与作业模板、清单或机构关联，则从该作业模板运行的作业不符合默认行为。这意味着，如果与这三个资源关联的实例组中的所有实例都没有容量，则作业会一直处于 pending 状态，直到容量可用为止。

决定哪个实例组提交该作业的优先顺序如下：

如果您将实例组与作业模板关联，并且所有这些实例组都满负荷，则该作业将提交到清单上指定的实例组，然后提交到机构。在资源可用时，作业必须在这些组中以优先顺序执行。

您仍然可以将全局 默认组 与一个资源关联，如 playbook 中定义的任何自定义实例组。您可以使用它来指定作业模板或清单上的首选实例组，但仍然启用将作业提交到任何实例（如果它们没有容量）。

这提供了以下两个示例：

以这种方式安排资源为您提供了灵活性。您还可以只使用一个实例创建实例组，允许您将工作直接指向自动化控制器集群中的特定主机。

有外部业务逻辑可以驱动发送到实例组的作业并发性，或者要消耗的 fork 数量上限。

对于传统实例和实例组，您可能希望使两个机构能够在同一底层实例上运行作业，但限制每个机构的并发作业总数。这可以通过为每个机构创建一个实例组并为 max_concurrent_jobs 分配值来实现。

对于自动化控制器组，自动化控制器通常不知道 OpenShift 集群的资源限值。您可以设置命名空间中 pod 数量的限制，或者如果没有自动扩展，则一次只能调度特定 pod 数量的资源。在这种情况下，您可以调整 max_concurrent_jobs 的值。

另一个可用的参数是 max_forks。这为限制实例组或容器组消耗的容量提供了额外的灵活性。如果作业具有各种清单大小，并且正在运行"forks"值，则可以使用它。您可以把机构限制为同时运行最多 10 个作业，但一次不消耗超过 50 个 fork：

max_concurrent_jobs: 10
max_forks: 50

如果运行了 10 个作业，每个作业都使用 5 个 fork，则作业会等待到其中一个完成以在该组上运行（或调度到具有容量的其他组中）。

如果 2 个作业使用 20 个 fork 运行，则每个作业有 20 个 fork，然后有一个 task_impact 为 11 个作业，直到其中一个完成以在该组上运行（或调度到具有容量的其他组中）。

对于容器组，使用 max_forks 值时，如果所有作业都使用相同的资源请求的 pod_spec 提交，无论作业的"forks"值如何。默认 pod_spec 设置请求而不是限制，因此 pod 可以在请求的值上"burst"，而无需节流或恢复。通过设置 max_forks 值，您可以帮助防止同时调度具有大量 fork 值的作业的情况，并导致 OpenShift 节点使用比请求的值更多的资源超额订阅。

要在实例组中为并发作业和分叉设置最大值，请参阅创建实例组。

重新运行设置 playbook 不会取消置备实例，因为集群目前不会区分您有意关闭的实例与因故障而关闭的实例。相反，请关闭自动化控制器实例上的所有服务，然后从任何其他实例运行取消置备工具。

在自动化控制器中取消置备实例组不会自动取消置备或删除实例组，即使重新置备通常会导致这些实例组没有被使用。它们仍然可以显示在 API 端点和统计监控中。您可以使用以下命令删除这些组：

awx-manage unregister_queue --queuename=<name>

从清单文件中的实例组中删除实例成员资格，并重新运行 setup playbook 并不确保实例没有重新添加到组中。为确保实例没有添加回组中，请通过 API 将其移除，并在清单文件中删除。您还可以停止在清单文件中定义实例组。您可以通过自动化控制器 UI 管理实例组拓扑。有关在 UI 中管理实例组的更多信息，请参阅管理实例组。