New in version 2.3.
| Parameter | Choices/Defaults | Configuration | Comments |
|---|---|---|---|
|
_terms
required |
query key
|
||
|
create
bool |
|
flag to create the password
|
|
| directory |
env:PASSWORD_STORE_DIR
|
directory of the password store
|
|
|
length
integer |
Default: 16
|
password length
|
|
|
overwrite
bool |
|
flag to overwrite the password
|
|
| passwordstore |
Default: ~/.password-store
|
location of the password store
|
|
|
returnall
bool |
|
flag to return all the contents of the password store
|
|
| subkey |
Default: password
|
subkey to return
|
|
| userpass |
user password
|
# 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.