community.general.etcd 查找 – 从 etcd 服务器获取信息

注意

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

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

要安装它，请使用：ansible-galaxy collection install community.general。

要在剧本中使用它，请指定：community.general.etcd。

概要

  • 从 etcd 服务器检索数据

术语

参数

注释

术语

list / elements=string / required

要在 etcd 服务器上查找的键列表

关键字参数

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

参数

注释

url

字符串

包含 etcd 服务器 URL 的环境变量

默认值： "http://127.0.0.1:4001"

配置

validate_certs

布尔值

切换是否验证 ssl 证书是否有效，通常只在自签名证书时才关闭此项。

选择

  • false

  • true ← (默认)

version

字符串

包含 etcd 协议版本的环境变量

默认值： "v1"

配置

注意事项

注意

  • 当关键字参数和位置参数一起使用时，位置参数必须在关键字参数之前列出： lookup('community.general.etcd', term1, term2, key1=value1, key2=value2) 和 query('community.general.etcd', term1, term2, key1=value1, key2=value2)

另请参阅

另请参阅

community.general.etcd3

从 etcd3 集群设置或删除键值对。

community.general.etcd3 查找插件

从 etcd3 服务器获取键值。

示例

- name: "a value from a locally running etcd"
  ansible.builtin.debug:
    msg: "{{ lookup('community.general.etcd', 'foo/bar') }}"

- name: "values from multiple folders on a locally running etcd"
  ansible.builtin.debug:
    msg: "{{ lookup('community.general.etcd', 'foo', 'bar', 'baz') }}"

- name: "you can set server options inline"
  ansible.builtin.debug:
    msg: "{{ lookup('community.general.etcd', 'foo', version='v2', url='http://192.168.0.27:4001') }}"

返回值

键

描述

返回值

list / elements=string

与输入键关联的值列表。

返回： 成功

作者

  • Jan-Piet Mens (@jpmens)

提示

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