последовательность – сгенерировать список на основе числовой последовательности
Описание
- генерирует последовательность элементов. Вы можете указать начальное значение, конечное значение, необязательное значение «шага», которое указывает количество шагов для увеличения последовательности, и необязательную строку формата в стиле 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.8/plugins/lookup/sequence.html