ansible.builtin.sequence – генерация списка на основе числовой последовательности

Примечание

Этот модуль является частью ansible-base и включён во все установки Ansible. В большинстве случаев вы можете использовать короткое имя модуля sequence даже без указания ключевого слова collections:. Несмотря на это, мы рекомендуем использовать FQCN для лёгкой ссылки на документацию по модулю и для избежания конфликтов с другими коллекциями, которые могут иметь то же имя модуля.

Новое в версии 1.0: модуля ansible.builtin

Обзор
Параметры
Примеры
Возвращаемые значения

Обзор

генерирует последовательность элементов. Вы можете указать начальное значение, конечное значение, необязательное значение «шага», которое определяет количество шагов для увеличения последовательности, и необязательную строку формата в стиле printf.
Аргументы могут быть указаны в виде строк пар ключ=значение или в сокращённом виде, также принимается строка аргументов: [начало-]конец[/шаг][:формат].
Числовые значения могут быть указаны в десятичной, шестнадцатеричной (0x3f8) или восьмеричной (0600) системах счисления.
Начиная с версии 1.9.2, разрешены отрицательные шаги.
Сгенерированные элементы являются строками. Используйте фильтры Jinja2 для преобразования элементов в предпочитаемый тип, например {{ 1 + item|int }}.
См. также фильтр Jinja2 range в качестве альтернативы.

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
count целое число	Значение по умолчанию: 0	количество элементов в последовательности, не использовать с end
end целое число	Значение по умолчанию: 0	число, на котором должна закончиться последовательность, не использовать с count
format строка		возвращает строку с сгенерированным числом, отформатированным в
start целое число	Значение по умолчанию: 0	число, с которого должна начаться последовательность
stride целое число		приращение между числами последовательности, значение по умолчанию 1, если конец меньше начала, то -1.

Примеры

- name: create some test users
  user:
    name: "{{ item }}"
    state: present
    groups: "evens"
  with_sequence: start=0 end=32 format=testuser%02x

- name: create a series of directories with even numbers for some reason
  file:
    dest: "/var/stuff/{{ item }}"
    state: directory
  with_sequence: start=4 end=16 stride=2

- name: a simpler way to use the sequence plugin create 4 groups
  group:
    name: "group{{ item }}"
    state: present
  with_sequence: count=4

- name: the final countdown
  debug:
    msg: "{{item}} seconds to detonation"
  with_sequence: start=10 end=0 stride=-1

- name: Use of variable
  debug:
    msg: "{{ item }}"
  with_sequence: start=1 end="{{ end_at }}"
  vars:
    - end_at: 10

Возвращаемые значения

Общие значения, возвращаемые модулем, описаны здесь, следующие поля уникальны для данного модуля:

Ключ	Возвращаемое значение	Описание
_list список / элементы=строка	успех	Список, содержащий сгенерированную последовательность элементов

Авторы

Jayson Vantuyl (!UNKNOWN) <jayson@aggressive.ly>

© 2012–2018 Michael DeHaan
© 2018–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.11/collections/ansible/builtin/sequence_lookup.html