community.general.random_words lookup — возвращает заданное количество случайных слов

Примечание

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

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

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

Чтобы использовать плагин в плейбуке, укажите: community.general.random_words.

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

Краткое описание
Требования
Параметры-ключевые слова
Примеры
Возвращаемое значение

Краткое описание

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

Требования

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

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

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

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

Параметр	Комментарии
case string	Способ задания регистра каждого слова в парольной фразе. Варианты: `"alternating"` `"upper"` `"lower"` ← (по умолчанию) `"random"` `"capitalize"`
delimiter string	Символ-разделитель между словами. По умолчанию: `" "`
max_length integer	Максимальная длина слов, используемых для создания пароля. По умолчанию: `9`
min_length integer	Минимальная длина слов, используемых для создания пароля. По умолчанию: `5`
numwords integer	Количество слов. По умолчанию: `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

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

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

Авторы

Thomas Sjögren (@konstruktoid)

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

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