community.general.heroku_collaborator – Add or delete app collaborators on Heroku¶
Note
This plugin is part of the community.general collection (version 2.5.1).
To install it use: ansible-galaxy collection install community.general
.
To use it in a playbook, specify: community.general.heroku_collaborator
.
Synopsis¶
Manages collaborators for Heroku apps.
If set to
present
and heroku user is already collaborator, then do nothing.If set to
present
and heroku user is not collaborator, then add user to app.If set to
absent
and heroku user is collaborator, then delete user from app.
Parameters¶
Notes¶
Note
HEROKU_API_KEY
andTF_VAR_HEROKU_API_KEY
env variable can be used instead settingapi_key
.If you use –check, you can also pass the -v flag to see affected apps in
msg
, e.g. [“heroku-example-app”].
Examples¶
- name: Create a heroku collaborator
community.general.heroku_collaborator:
api_key: YOUR_API_KEY
user: [email protected]
apps: heroku-example-app
state: present
- name: An example of using the module in loop
community.general.heroku_collaborator:
api_key: YOUR_API_KEY
user: '{{ item.user }}'
apps: '{{ item.apps | default(apps) }}'
suppress_invitation: '{{ item.suppress_invitation | default(suppress_invitation) }}'
state: '{{ item.state | default("present") }}'
with_items:
- { user: '[email protected]' }
- { state: 'absent', user: '[email protected]', suppress_invitation: false }
- { user: '[email protected]', apps: ["heroku-example-app"] }
Authors¶
Marcel Arns (@marns93)