What I missed when I layed this out was that you setup a secret like
- secret:
name: rtd_credentials
data:
username: openstackci
password: foo
what you have in the job variables is a dictionary called
"rtd_credentials".
It makes it much simpler to use the role with the secret if it accepts
this variable, rather than having to extract the username/password etc
out of the secret dictionary into separate variables.
Additionally, turn on no_log for the uri calls, to avoid potentially
logging any credentials.
Change-Id: I514fb1285196aae0b49a98f0efc21326730e4179
1.1 KiB
Trigger readthedocs build for a project
Role Variables
The readthedocs webhook API ID. This needs to be taken from the project's "Integrations" dashboard page in RTD. The URL will look like
readthedocs.org/api/v2/webhook/<project-name>/<id>/.This may come from a secret, however it can not be triggered without authentication.
Complex argument which contains the RTD authentication credentials. This is expected to come from a secret.
The webhook integration token. You'll find this value on the project's "Integrations" dashboard page in RTD. This can be used instead of username/password combo.
The readthedocs username. If set, this will be used to authenticate in preference to any token set via
rtd_integration_token.Password for
username. Must be set if username is set.