ansible.builtin.shuffle 过滤器 – 随机化列表

注意

此过滤器插件是 ansible-core 的一部分，包含在所有 Ansible 安装中。在大多数情况下，您可以使用简短的插件名称 shuffle。但是，我们建议您使用完全限定集合名称 (FQCN) ansible.builtin.shuffle，以便轻松链接到插件文档，并避免与其他可能具有相同过滤器插件名称的集合冲突。

概要

  • 获取输入列表的元素并以随机顺序返回。

输入

这描述了过滤器的输入，即 | ansible.builtin.shuffle 之前的值。

参数

注释

输入

列表 / elements=any / 必填

要随机化的数字或列表。

关键字参数

这描述了过滤器的关键字参数。这些是以下示例中的 key1=value1, key2=value2 等值：input | ansible.builtin.shuffle(key1=value1, key2=value2, ...)

参数

注释

seed

字符串

如果指定，则使用伪随机选择（可重复）。

示例

randomized_list: "{{ ['a','b','c'] | shuffle}}"
per_host_repeatable: "{{ ['a','b','c'] | shuffle(seed=inventory_hostname) }}"

返回值

键

描述

返回值

列表 / elements=any

随机数或列表元素。

返回: 成功

提示

每个条目类型的配置条目具有从低到高的优先级顺序。例如，列表中较低的变量将覆盖较高的变量。