From d27d956d71428315397b855e1b094a9caddfa3fd Mon Sep 17 00:00:00 2001 From: Alicia Cozine <879121+acozine@users.noreply.github.com> Date: Fri, 9 Nov 2018 13:31:29 -0600 Subject: [PATCH] clarifies FAQ answer about env vars (#48432) --- docs/docsite/rst/reference_appendices/faq.rst | 10 +++++----- .../rst/user_guide/playbooks_special_topics.rst | 6 ++++-- 2 files changed, 9 insertions(+), 7 deletions(-) diff --git a/docs/docsite/rst/reference_appendices/faq.rst b/docs/docsite/rst/reference_appendices/faq.rst index 639bbc255e4..4882c2df6b1 100644 --- a/docs/docsite/rst/reference_appendices/faq.rst +++ b/docs/docsite/rst/reference_appendices/faq.rst @@ -401,14 +401,14 @@ For environment variables on the TARGET machines, they are available via facts i {{ ansible_env.SOME_VARIABLE }} -If you need to set environment variables for TASK execution, see the Advanced Playbooks section about environments. -There is no set way to set environment variables on your target machines, you can use template/replace/other modules to do so, -but the exact files to edit vary depending on your OS and distribution and local configuration. +If you need to set environment variables for TASK execution, see :ref:`playbooks_environment` in the :ref:`Advanced Playbooks ` section. +There are several ways to set environment variables on your target machines. You can use the :ref:`template `, :ref:`replace `, or :ref:`lineinfile ` modules to introduce environment variables into files. +The exact files to edit vary depending on your OS and distribution and local configuration. .. _user_passwords: -How do I generate crypted passwords for the user module? -++++++++++++++++++++++++++++++++++++++++++++++++++++++++ +How do I generate encrypted passwords for the user module? +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ Ansible ad-hoc command is the easiest option: diff --git a/docs/docsite/rst/user_guide/playbooks_special_topics.rst b/docs/docsite/rst/user_guide/playbooks_special_topics.rst index bfb7a8ca3f4..95761f51a59 100644 --- a/docs/docsite/rst/user_guide/playbooks_special_topics.rst +++ b/docs/docsite/rst/user_guide/playbooks_special_topics.rst @@ -1,8 +1,10 @@ +.. _playbooks_special_topics: + Advanced Playbooks Features =========================== -Here are some playbook features that not everyone may need to learn, but can be quite useful for particular applications. -Browsing these topics is recommended as you may find some useful tips here, but feel free to learn the basics of Ansible first +Here are some playbook features that not everyone may need to learn, but can be quite useful for particular applications. +Browsing these topics is recommended as you may find some useful tips here, but feel free to learn the basics of Ansible first and adopt these only if they seem relevant or useful to your environment. .. toctree::