ansible.builtin.items 查找 – 项目列表

注意

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

概要

  • 此查找返回传递给它的项目列表，如果任何顶级项目也是列表，它将将其扁平化，但不会递归。

术语

参数

注释

术语

字符串 / 必需

项目列表

注释

注意

  • 这是大多数示例中循环使用的标准查找。

  • 请查看 ‘flattened’ 查找以进行递归扁平化。

  • 如果您不想要扁平化或任何其他转换，请查看 ‘list’ 查找。

示例

- name: "loop through list"
  ansible.builtin.debug:
    msg: "An item: {{ item }}"
  with_items:
    - 1
    - 2
    - 3

- name: add several users
  ansible.builtin.user:
    name: "{{ item }}"
    groups: "wheel"
    state: present
  with_items:
     - testuser1
     - testuser2

- name: "loop through list from a variable"
  ansible.builtin.debug:
    msg: "An item: {{ item }}"
  with_items: "{{ somelist }}"

- name: more complex items to add several users
  ansible.builtin.user:
    name: "{{ item.name }}"
    uid: "{{ item.uid }}"
    groups: "{{ item.groups }}"
    state: present
  with_items:
     - { name: testuser1, uid: 1002, groups: "wheel, staff" }
     - { name: testuser2, uid: 1003, groups: staff }

返回值

键

描述

返回值

列表 / 元素=字符串

扁平化后的列表

返回: 成功

作者

  • Michael DeHaan

提示

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