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

注意

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

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

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

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

概要

  • 从 etcd 服务器检索数据

术语

参数

注释

术语

列表 / 元素=字符串 / 必需

要在 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') }}"

返回值

键

描述

返回值

列表 / 元素=字符串

与输入键关联的值的列表。

返回： 成功

作者

  • Jan-Piet Mens (@jpmens)

提示

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