summaryrefslogtreecommitdiffstats
path: root/docs/docsite/rst/network/getting_started/intermediate_concepts.rst
diff options
context:
space:
mode:
Diffstat (limited to 'docs/docsite/rst/network/getting_started/intermediate_concepts.rst')
-rw-r--r--docs/docsite/rst/network/getting_started/intermediate_concepts.rst39
1 files changed, 39 insertions, 0 deletions
diff --git a/docs/docsite/rst/network/getting_started/intermediate_concepts.rst b/docs/docsite/rst/network/getting_started/intermediate_concepts.rst
new file mode 100644
index 0000000..3496f22
--- /dev/null
+++ b/docs/docsite/rst/network/getting_started/intermediate_concepts.rst
@@ -0,0 +1,39 @@
+*****************
+Beyond the basics
+*****************
+
+This page introduces some concepts that help you manage your Ansible workflow with directory structure and source control. Like the Basic Concepts at the beginning of this guide, these intermediate concepts are common to all uses of Ansible.
+
+.. contents::
+ :local:
+
+
+A typical Ansible filetree
+==========================
+
+Ansible expects to find certain files in certain places. As you expand your inventory and create and run more network playbooks, keep your files organized in your working Ansible project directory like this:
+
+.. code-block:: console
+
+ .
+ ├── backup
+ │   ├── vyos.example.net_config.2018-02-08@11:10:15
+ │   ├── vyos.example.net_config.2018-02-12@08:22:41
+ ├── first_playbook.yml
+ ├── inventory
+ ├── group_vars
+ │   ├── vyos.yml
+ │   └── eos.yml
+ ├── roles
+ │   ├── static_route
+ │   └── system
+ ├── second_playbook.yml
+ └── third_playbook.yml
+
+The ``backup`` directory and the files in it get created when you run modules like ``vyos_config`` with the ``backup: yes`` parameter.
+
+
+Tracking changes to inventory and playbooks: source control with git
+====================================================================
+
+As you expand your inventory, roles and playbooks, you should place your Ansible projects under source control. We recommend ``git`` for source control. ``git`` provides an audit trail, letting you track changes, roll back mistakes, view history and share the workload of managing, maintaining and expanding your Ansible ecosystem. There are plenty of tutorials and guides to using ``git`` available.