summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorToshio Kuratomi <a.badger@gmail.com>2016-08-31 09:33:33 -0700
committerToshio Kuratomi <a.badger@gmail.com>2016-08-31 09:33:33 -0700
commit33245b20117c73eef53baa383fffc0e0bd71328e (patch)
tree7560f3ac32e5d6923e68ac0bf24a21de7ffb3be9
parent71ef25d5e8e4690a5fda974c6f0dd70699433d34 (diff)
downloadansible-33245b20117c73eef53baa383fffc0e0bd71328e.tar.gz
Add checklist item on how to use env vars with basic auth helpers
-rw-r--r--docsite/rst/developing_modules.rst6
1 files changed, 6 insertions, 0 deletions
diff --git a/docsite/rst/developing_modules.rst b/docsite/rst/developing_modules.rst
index d7a5ba7ecb..aa801c7168 100644
--- a/docsite/rst/developing_modules.rst
+++ b/docsite/rst/developing_modules.rst
@@ -729,6 +729,12 @@ The following checklist items are important guidelines for people who want to c
playbooks which conditionalize based on fact information will only
conditionalize correctly in check_mode if the facts are returned in
check_mode).
+* Basic auth: module_utils.api has some helpers for doing basic auth with
+ module_utils.urls.fetch_url(). If you use those you may find you also want
+ to fallback on environment variables for default values. If you do that,
+ be sure to use non-generic environment variables (like
+ :envvar:`API_<MODULENAME>_USERNAME`). Using generic environment variables
+ like :envvar:`API_USERNAME` would conflict between modules.
Windows modules checklist
`````````````````````````