Ansible/Directory Layout/Details - Revision history

Admin: /* Creating the directory structure */

2018-12-09T18:56:01Z

Creating the directory structure

← Older revision		Revision as of 18:56, 9 December 2018
Line 66:		Line 66:

	<pre>		<pre>
	ansible-galaxy init -p playbooks/roles x		ansible-galaxy init --init-path=playbooks/roles x
	</pre>		</pre>

2018-12-09T18:55:51Z

Creating the directory structure

← Older revision		Revision as of 18:55, 9 December 2018
Line 60:		Line 60:

	<pre>		<pre>
	$ ansible-galaxy init -p <path-to-roles-directory> <name-of-role>		$ ansible-galaxy init --init-path=<path-to-roles-directory> <name-of-role>
	</pre>		</pre>

2018-12-08T18:45:08Z

Example Playbooks Directory

← Older revision		Revision as of 18:45, 8 December 2018
Line 54:		Line 54:

	We will go through this step by step.		We will go through this step by step.

			==Creating the directory structure==

			To make the directory structure above, you can also run:

			<pre>
			$ ansible-galaxy init -p <path-to-roles-directory> <name-of-role>
			</pre>

			For example,

			<pre>
			ansible-galaxy init -p playbooks/roles x
			</pre>

			This will fill in the appropriate directory structure in the directory <code>playbooks/roles/x/*</code>

	==Hosts==		==Hosts==

2018-12-08T09:26:55Z

Database servers playbook: dbservers.yml

@@ Line 162: / Line 162: @@
 ===Database servers playbook: dbservers.yml===
-{{Main|Ansible/Roles}}
+The database servers in the dbservers group can be connected to the db role:
 '''<code>dbservers.yml</code>:'''
@@ Line 178: / Line 174: @@
      - db
 </pre>
 ==Roles==

2018-12-08T09:26:20Z

Webservers playbook: webservers.yml

← Older revision		Revision as of 09:26, 8 December 2018
Line 128:		Line 128:

	===Webservers playbook: webservers.yml===		===Webservers playbook: webservers.yml===

	~~{{Main\|Ansible/Roles}}~~

	~~{{Main\|Ansible/Separate Playbooks by Role}}~~

	The webservers group can be linked to the web role.		The webservers group can be linked to the web role.

2018-12-08T09:26:07Z

Webservers playbook: webservers.yml

← Older revision		Revision as of 09:26, 8 December 2018
Line 133:		Line 133:
	{{Main\|Ansible/Separate Playbooks by Role}}		{{Main\|Ansible/Separate Playbooks by Role}}

	~~Now the~~ webservers group can be linked to ~~different roles, which can have different sets of variables, tasks, etc~~. ~~defined. (Note that the name of~~ the playbook ~~and the name of the role do not have to be the same, this is just a simple example).~~		The webservers group can be linked to the web role.

			This is done in the webservers playbook:

	'''<code>webservers.yml</code>:'''		'''<code>webservers.yml</code>:'''
Line 139:		Line 141:
	<pre>		<pre>
	---		---
	~~# file: webservers.yml~~
	- hosts: webservers		- hosts: webservers
	roles:		roles:
	- common		- common
	- ~~webservers~~		- web
	</pre>		</pre>

2018-12-08T09:25:30Z

Database servers playbook: dbservers.yml

← Older revision		Revision as of 09:25, 8 December 2018
Line 179:		Line 179:
	roles:		roles:
	- common		- common
	- ~~dbservers~~		- db
	</pre>		</pre>

Line 198:		Line 198:

	For more info on roles, see [[Ansible/Roles]] and [[Ansible/Separate Playbooks by Role]]		For more info on roles, see [[Ansible/Roles]] and [[Ansible/Separate Playbooks by Role]]


	==Roles==		==Roles==

2018-12-08T09:25:09Z

Webservers playbook: webservers.yml

← Older revision		Revision as of 09:25, 8 December 2018
Line 146:		Line 146:
	</pre>		</pre>

	Note that this assumes your ~~hosts/~~inventory file has ~~groups,~~ like ~~this~~:		Note that this assumes your inventory file has assets grouped like so:

	<pre>		<pre>

2018-12-08T05:46:01Z

Common role

← Older revision		Revision as of 05:46, 8 December 2018
Line 240:		Line 240:
	Run for each new role as needed.		Run for each new role as needed.

	===Common ~~role~~===		===Common Role===

	~~We define~~ a ~~common~~ role that ~~sets defaults~~ for all roles~~, and each~~ subsequent role can override these ~~as needed~~.		The common role is a role that defines default values for all roles. Each subsequent role can override these settings selectively.

	<pre>		<pre>
Line 270:		Line 270:
	fooapp/ # ""		fooapp/ # ""
	</pre>		</pre>

			The details of each subdirectory of each role is covered on the [[Ansible/Roles]] page:

			* tasks - https://charlesreid1.com/wiki/Ansible/Roles#Tasks
			* files - https://charlesreid1.com/wiki/Ansible/Roles#Files
			* variables - https://charlesreid1.com/wiki/Ansible/Roles#Variables_2
			* defaults - https://charlesreid1.com/wiki/Ansible/Roles#Defaults_2
			* handlers - https://charlesreid1.com/wiki/Ansible/Roles#Handlers

	=Flags=		=Flags=

	{{AnsibleFlag}}		{{AnsibleFlag}}

2018-12-08T04:31:06Z

Roles

← Older revision		Revision as of 04:31, 8 December 2018
Line 201:		Line 201:

	==Roles==		==Roles==

			{{Main\|Ansible/Roles}}

	Each role must define a directory structure containing files to define things like tasks, handlers, templates, etc.		Each role must define a directory structure containing files to define things like tasks, handlers, templates, etc.