';
*/
// Create a banner if we're not on the official docs site
if (location.host == "docs.testing.ansible.com") {
document.write('
' +
'
This is the testing site for Ansible Documentation. Unless you are reviewing pre-production changes, please visit the official documentation website.
' +
'
');
}
// Create a banner
current_url_path = window.location.pathname;
var important = false;
var msg = '
';
if (startsWith(current_url_path, "/ansible-core/")) {
msg += 'You are reading documentation for Ansible Core, which contains no plugins except for those in ansible.builtin. For documentation of the Ansible package, go to the latest documentation.';
} else if (startsWithOneOf(current_url_path, ["/ansible/latest/", "/ansible/11/"])) {
/* temp extra banner to advertise something */
banner += extra_banner;
msg += 'This is the latest (stable) Ansible community documentation. For Red Hat Ansible Automation Platform subscriptions, see Life Cycle for version details.';
} else if (startsWith(current_url_path, "/ansible/2.9/")) {
msg += 'You are reading the latest Red Hat released version of the Ansible documentation. Community users can use this version, or select latest from the version selector to the left for the most recent community version.';
} else if (startsWith(current_url_path, "/ansible/devel/")) {
/* temp extra banner to advertise something */
banner += extra_banner;
msg += 'You are reading the devel version of the Ansible documentation - this version is not guaranteed stable. Use the version selection to the left if you want the latest (stable) released version.';
} else {
msg += 'You are reading an older version of the Ansible documentation. Use the version selection to the left if you want the latest (stable) released version.';
/* temp extra banner to advertise something - this is for testing*/
banner += extra_banner;
}
msg += '
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.
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:
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.