Improvement: move ansible playbooks to playbooks/ directory to allow direct references to them

[ednxzu]

Could it be considered to move the playbooks to a dedicated playbooks/ directory, in order for them to be usable from outside the repository ?

Expected Behavior

As this repo is essentially an ansible collection, I would expect to be able to add it to a larger project, and run its playbooks from this large project.

Something like:

ansible-playbook -i inventory techno_tim.k3s_ansible.site

Current Behavior

Currently, the only way to do so, is to copy the playbooks to the large project's playbook dir, and then run it (or call the absolute path to the playbook (/home/user/.ansible/collections/...)

Possible Solution

The easy fix is to move the paybooks to a dedicated playbooks/ directory as per documentation

Example in a similar collection : here

• [X ] I've checked the General Troubleshooting Guide

[timothystewart6]

I am fine with this change as long as it doesn't break or change existing functionality!

[ednxzu]

This should technically be transparent. People that are already running this collection most likely have the playbooks copied over to their own playbook dir. If they don't changing the run command from ansible-playbook -i inventory /path/to/playbook.yml to ansible-playbook -i inventory techno_tim.k3s_ansible.<playbook> should just work.

I don't think the current playbooks are loading specific vars due to their relative paths (everything is loaded relative to the inventory file in the current setup if I'm not mistaking), so really nothing other than the playbooks would have to be moved.

I can draft a PR for this this week I think.

[twistedgrim]

@ednxzu I was thinking the same thing as you here. I think the current example of how people are running the playbook needs to be updated and some examples shown of how to consume the playbook from a higher level playbook of your own is in order before this could really become a thing. Id love to see a PR for what you are describing. I think it would help everyone to visualize it if we had a pull request to look at, then we could add the documentation around this.

[timothystewart6]

Related to #560