sequence – сгенерировать список на основе числовой последовательности
Описание
- генерирует последовательность элементов. Вы можете указать начальное значение, конечное значение, необязательное значение «шага», которое определяет количество шагов для увеличения последовательности, и необязательную строку формата в стиле 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: end=0 start=10
Возвращаемые значения
Общие возвращаемые значения документированы здесь, следующие поля уникальны для данного поиска:
| Ключ | Возвращено | Описание |
|---|---|---|
| _list
список
|
Список, содержащий сгенерированную последовательность элементов
|
Статус
- Этот поиск не гарантирует обратную совместимость интерфейса. [превью]
- Этот поиск поддерживается сообществом Ansible. [community]
Авторы
- Jayson Vantuyl <jayson@aggressive.ly>
Подсказка
Если вы заметите какие-либо проблемы в этой документации, вы можете отредактировать этот документ для улучшения.
Подсказка
Элементы конфигурации для каждого типа имеют порядок приоритета от низкого к высокому. Например, переменная, расположенная ниже в списке, переопределит переменную, расположенную выше.
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.9/plugins/lookup/sequence.html