community.general.random_pet 查找 – 生成随机宠物名称

注意

此查找插件是 community.general 集合（版本 10.1.0）的一部分。

如果您正在使用 ansible 包，您可能已经安装了此集合。它不包含在 ansible-core 中。要检查是否已安装，请运行 ansible-galaxy collection list。

要安装它，请使用：ansible-galaxy collection install community.general。您需要进一步的要求才能使用此查找插件，请参阅要求了解详细信息。

要在 playbook 中使用它，请指定：community.general.random_pet。

community.general 3.1.0 中的新功能

概要 

生成可作为资源唯一标识符的随机宠物名称。

要求 

在执行此查找的本地控制器节点上需要以下要求。

petname https://github.com/dustinkirkland/python-petname

关键字参数 

这描述了查找的关键字参数。这些是以下示例中的 key1=value1、 key2=value2 等值：lookup('community.general.random_pet', key1=value1, key2=value2, ...) 和 query('community.general.random_pet', key1=value1, key2=value2, ...)

参数	注释
length 整数	宠物名称的每个组成部分的最大长度。小于 3 的值将由 petname 设置为 3。默认值: `6`
prefix 字符串	要作为名称前缀的字符串。
separator 字符串	分隔宠物名称中单词的字符。默认值: `"-"`
words 整数	宠物名称中的单词数。默认值: `2`

示例 

- name: Generate pet name
  ansible.builtin.debug:
    var: lookup('community.general.random_pet')
  # Example result: 'loving-raptor'

- name: Generate pet name with 3 words
  ansible.builtin.debug:
    var: lookup('community.general.random_pet', words=3)
  # Example result: 'fully-fresh-macaw'

- name: Generate pet name with separator
  ansible.builtin.debug:
    var: lookup('community.general.random_pet', separator="_")
  # Example result: 'causal_snipe'

- name: Generate pet name with length
  ansible.builtin.debug:
    var: lookup('community.general.random_pet', length=7)
  # Example result: 'natural-peacock'

返回值 

键	描述
返回值列表 / 元素=字符串	包含随机宠物名称的单元素列表返回: 成功

作者

Abhijeet Kasurde (@Akasurde)

提示

每个条目类型的配置条目都具有从低到高的优先级顺序。例如，列表中较低的变量将覆盖较高的变量。