Add examples for various inventory setups to the documentation

[zerok]

Fixes: #12480.

[ansibot]

cc @acozine
click here for bot help

[acozine]

Thanks @zerok for submitting these examples. We appreciate the time and effort you've put in. If you're interested in documentation, please consider joining the Docs Working Group!

Can you take a look at the comments above? If you have questions, need clarification, etc., feel free to reach out on the #ansible-docs channel on freenode IRC.

[zerok]

Thank you 😊I will try to find time for implementing your comments tomorrow 🙂

…

On 17.09.2019, at 16:04, Sandra McCann ***@***.***> wrote: @samccann commented on this pull request. In docs/docsite/rst/user_guide/intro_inventory.rst: > +nodes inside the "test" environment when you actually wanted to update +some "staging" servers. + +For the example mentioned above you could have an +:file:`inventory_test` file:: + + [database-servers] + db01.test.example.com + db02.test.example.com + + [app-servers] + app01.test.example.com + app02.test.example.com + app03.test.example.com + +In there are only host that are part of the "test" ⬇️ Suggested change -In there are only host that are part of the "test" +That file only includes hosts that are part of the "test" In docs/docsite/rst/user_guide/intro_inventory.rst: > +some "staging" servers. + +For the example mentioned above you could have an +:file:`inventory_test` file:: + + [database-servers] + db01.test.example.com + db02.test.example.com + + [app-servers] + app01.test.example.com + app02.test.example.com + app03.test.example.com + +In there are only host that are part of the "test" +environment. "Staging" machines would be defined in another file ⬇️ Suggested change -environment. "Staging" machines would be defined in another file +environment. Define the "staging" machines in another file In docs/docsite/rst/user_guide/intro_inventory.rst: > + app03.test.example.com + +In there are only host that are part of the "test" +environment. "Staging" machines would be defined in another file +called :file:`inventory_staging`:: + + [database-servers] + db01.staging.example.com + db02.staging.example.com + + [app-servers] + app01.staging.example.com + app02.staging.example.com + app03.staging.example.com + +If you then have a playbook called :file:`site.yml`, then you'd apply ⬇️ Suggested change -If you then have a playbook called :file:`site.yml`, then you'd apply +To apply a playbook called :file:`site.yml` In docs/docsite/rst/user_guide/intro_inventory.rst: > + +In there are only host that are part of the "test" +environment. "Staging" machines would be defined in another file +called :file:`inventory_staging`:: + + [database-servers] + db01.staging.example.com + db02.staging.example.com + + [app-servers] + app01.staging.example.com + app02.staging.example.com + app03.staging.example.com + +If you then have a playbook called :file:`site.yml`, then you'd apply +that to all the app-servers in the test environment using the ⬇️ Suggested change -that to all the app-servers in the test environment using the +to all the app-servers in the test environment, use the In docs/docsite/rst/user_guide/intro_inventory.rst: > + +If you then have a playbook called :file:`site.yml`, then you'd apply +that to all the app-servers in the test environment using the +following command:: + + ansible-playbook -i inventory_test site.yml -l app-servers + +.. _inventory_setup-per_function: + +Example: Group by function +-------------------------- + +In the previous section you already saw an example for using groups in +order to cluster hosts that have the same function. This allows you, +for instance, to define firewall rules inside a playbook or role +without affecting database servers:: please use code-block here — You are receiving this because you authored the thread. Reply to this email directly, view it on GitHub, or mute the thread.

[samccann]

leftover nit from removing the dash from the groups :-)

[samccann]

Thanks @zerok for the inventory examples!

[zerok]

Thank you 😊

…

On 19.09.2019, at 15:33, Sandra McCann ***@***.***> wrote: Thanks @zerok for the inventory examples! — You are receiving this because you were mentioned. Reply to this email directly, view it on GitHub, or mute the thread.