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

注意

此查找插件是 ansible-core 的一部分，包含在所有 Ansible 安裝中。 在大多數情況下，您可以使用簡短的插件名稱 items。 但是，我們建議您使用 完全限定的集合名稱 (FQCN) ansible.builtin.items 以便輕鬆鏈接到插件文檔，並避免與可能具有相同查找插件名稱的其他集合衝突。

摘要

  • 此查找返回給定的項目列表，如果任何頂級項目也是列表，它將將其展平，但不會遞歸

術語

參數

註釋

術語

字符串 / 必需

項目列表

注意事項

注意

  • 這是大多數示例中循環使用的標準查找

  • 查看“展平”查找以進行遞歸展平

  • 如果您不希望展平或任何其他轉換，請查看“列表”查找。

示例

- 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

提示

每種類型的配置條目都具有從低到高的優先級順序。 例如，列表中較低的變量將覆蓋列表中較高的變量。