New in version 2.3.
| Parameter | Choices/Defaults | Configuration | Comments |
|---|---|---|---|
| _terms required | query key | ||
| backup bool (added in 2.7) |
| Used with overwrite=yes. Backup the previous password in a subkey. | |
| create bool |
| Create the password if it does not already exist. | |
| directory | env:PASSWORD_STORE_DIR | The directory of the password store. | |
| length integer | Default: 16 | The length of the generated password | |
| overwrite bool |
| Overwrite the password if it does already exist. | |
| passwordstore | Default: ~/.password-store | location of the password store | |
| returnall bool |
| Return all the content of the password, not only the first line. | |
| subkey | Default: password | Return a specific subkey of the password. | |
| userpass | Specify a password to save, instead of a generated one. |
# Debug is used for examples, BAD IDEA to show passwords on screen
- name: Basic lookup. Fails if example/test doesn't exist
debug:
msg: "{{ lookup('passwordstore', 'example/test')}}"
- name: Create pass with random 16 character password. If password exists just give the password
debug:
var: mypassword
vars:
mypassword: "{{ lookup('passwordstore', 'example/test create=true')}}"
- name: Different size password
debug:
msg: "{{ lookup('passwordstore', 'example/test create=true length=42')}}"
- name: Create password and overwrite the password if it exists. As a bonus, this module includes the old password inside the pass file
debug:
msg: "{{ lookup('passwordstore', 'example/test create=true overwrite=true')}}"
- name: Return the value for user in the KV pair user, username
debug:
msg: "{{ lookup('passwordstore', 'example/test subkey=user')}}"
- name: Return the entire password file content
set_fact:
passfilecontent: "{{ lookup('passwordstore', 'example/test returnall=true')}}"
Common return values are documented here, the following are the fields unique to this lookup:
| Key | Returned | Description |
|---|---|---|
| _raw | a password |
Hint
If you notice any issues in this documentation you can edit this document to improve it.
© 2012–2018 Michael DeHaan
© 2018 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.7/plugins/lookup/passwordstore.html