etcd3 – Set or delete key value pairs from an etcd3 cluster¶
New in version 2.5.
Synopsis¶
Sets or deletes values in etcd3 cluster using its v3 api.
Needs python etcd3 lib to work
Requirements¶
The below requirements are needed on the host that executes this module.
etcd3
Parameters¶
Examples¶
# Store a value "bar" under the key "foo" for a cluster located "http://localhost:2379"
- etcd3:
key: "foo"
value: "baz3"
host: "localhost"
port: 2379
state: "present"
# Authenticate using user/password combination with a timeout of 10 seconds
- etcd3:
key: "foo"
value: "baz3"
state: "present"
user: "someone"
password: "password123"
timeout: 10
# Authenticate using TLS certificates
- etcd3:
key: "foo"
value: "baz3"
state: "present"
ca_cert: "/etc/ssl/certs/CA_CERT.pem"
client_cert: "/etc/ssl/certs/cert.crt"
client_key: "/etc/ssl/private/key.pem"
Return Values¶
Common return values are documented here, the following are the fields unique to this module:
Key | Returned | Description |
---|---|---|
key
string
|
always |
The key that was queried
|
old_value
string
|
always |
The previous value in the cluster
|
Status¶
This module is not guaranteed to have a backwards compatible interface. [preview]
This module is maintained by the Ansible Community. [community]