community.general.etcd3 – Get key values from etcd3 server

• Synopsis
• Requirements
• Parameters
• Notes
• See Also
• Examples
• Return Values

Synopsis

• Retrieves key values and/or key prefixes from etcd3 server using its native gRPC API.
• Try to reuse community.general.etcd3 options for connection parameters, but add support for some ETCDCTL_* environment variables.
• See https://github.com/etcd-io/etcd/tree/master/Documentation/op-guide for etcd overview.

Requirements

The below requirements are needed on the local controller node that executes this lookup.

• etcd3 >= 0.10

Parameters

Notes

See Also

Examples

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

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

- name: "look for a key prefix"
  ansible.builtin.debug:
    msg: "{{ lookup('community.general.etcd3', '/foo/bar', prefix=True) }}"

- name: "connect to etcd3 with a client certificate"
  ansible.builtin.debug:
    msg: "{{ lookup('community.general.etcd3', 'foo/bar', cert_cert='/etc/ssl/etcd/client.pem', cert_key='/etc/ssl/etcd/client.key') }}"

Return Values

Common return values are documented here, the following are the fields unique to this lookup:

Authors

• Eric Belhomme (@eric-belhomme) <ebelhomme@fr.scc.com>