community.general.flattened 查找 – 返回完全展平的单个列表

注意

此查找插件是 community.general 集合 (版本 10.1.0) 的一部分。

如果您使用的是 ansible 包,则您可能已经安装了此集合。它不包含在 ansible-core 中。要检查它是否已安装,请运行 ansible-galaxy collection list

要安装它,请使用: ansible-galaxy collection install community.general

要在剧本中使用它,请指定: community.general.flattened

概要

  • 给定一个或多个列表,此查找将递归地展平找到的任何列表元素,直到只剩下一个列表为止。

术语

参数

注释

术语

列表 / 元素=任意 / 必需

要展平的列表

备注

注意

  • 与仅展平 1 层的 ansible.builtin.items 查找不同,此插件将继续展平,直到找不到列表为止。

  • 又名高地人插件,只能有一个(列表)。

示例

- name: "'unnest' all elements into single list"
  ansible.builtin.debug:
    msg: "all in one list {{lookup('community.general.flattened', [1,2,3,[5,6]], ['a','b','c'], [[5,6,1,3], [34,'a','b','c']])}}"

返回值

描述

返回值

列表 / 元素=字符串

展平的列表

返回:成功

作者

  • Serge van Ginderachter

提示

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