community.general.random_words поиск – Возвращение нескольких случайных слов

Примечание

Этот плагин поиска входит в состав коллекции community.general (версия 9.5.0).

Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не включена в ansible-core. Чтобы проверить установку, выполните ansible-galaxy collection list.

Для установки используйте: ansible-galaxy collection install community.general. Для использования этого плагина поиска необходимы дополнительные требования. Подробнее см. Требования.

Для использования в книге задач укажите: community.general.random_words.

Добавлено в community.general 4.0.0

Обзор
Требования
Параметры ключевых слов
Примеры
Значение возврата

Обзор

Возвращает несколько случайных слов. Выходные данные, например, могут быть использованы для паролей.
См. https://xkcd.com/936/ для дополнительной информации.

Требования

Ниже перечислены требования, которые необходимы на узле локального контроллера, выполняющего этот поиск.

xkcdpass https://github.com/redacted/XKCD-password-generator

Параметры ключевых слов

Здесь описываются параметры ключевых слов поиска. Это значения key1=value1, key2=value2 и так далее в следующих примерах: lookup('community.general.random_words', key1=value1, key2=value2, ...) и query('community.general.random_words', key1=value1, key2=value2, ...)

Параметр	Комментарии
case строка	Метод установки регистра каждого слова в парольной фразе. Варианты: `"alternating"` `"upper"` `"lower"` ← (по умолчанию) `"random"` `"capitalize"`
delimiter строка	Разделительный символ между словами. По умолчанию: `" "`
max_length целое число	Максимальная длина слов для создания пароля. По умолчанию: `9`
min_length целое число	Минимальная длина слов для создания пароля. По умолчанию: `5`
numwords целое число	Количество слов. По умолчанию: `6`

Примеры

- name: Generate password with default settings
  ansible.builtin.debug:
    var: lookup('community.general.random_words')
  # Example result: 'traitor gigabyte cesarean unless aspect clear'

- name: Generate password with six, five character, words
  ansible.builtin.debug:
    var: lookup('community.general.random_words', min_length=5, max_length=5)
  # Example result: 'brink banjo getup staff trump comfy'

- name: Generate password with three capitalized words and the '-' delimiter
  ansible.builtin.debug:
    var: lookup('community.general.random_words', numwords=3, delimiter='-', case='capitalize')
  # Example result: 'Overlabor-Faucet-Coastline'

- name: Generate password with three words without any delimiter
  ansible.builtin.debug:
    var: lookup('community.general.random_words', numwords=3, delimiter='')
  # Example result: 'deskworkmonopolystriking'
  # https://www.ncsc.gov.uk/blog-post/the-logic-behind-three-random-words

Значение возврата

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

Авторы

Thomas Sjögren (@konstruktoid)

Подсказка

Элементы конфигурации для каждого типа имеют порядок приоритетов от низкого к высокому. Например, переменная, расположенная ниже в списке, переопределит переменную, расположенную выше.

Ссылки на коллекцию

© 2012–2018 Michael DeHaan
© 2018–2024 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/latest/collections/community/general/random_words_lookup.html