/ansible_collection_skeleton

Ansible collection skeleton for use with ansible-galaxy

Primary LanguageJinjaGNU General Public License v3.0GPL-3.0

Ansible collection skeleton

master master branch CI
dev dev branch CI

Use it with ansible-galaxy when you use init.
Jinja templates are processed by ansible-galaxy and have precedence over the non template counterparts. This README is one example of that.

README.md -> this file
README.md.j2 -> becomes the README.md5 in the newly initialized collection.

You can find a similar role skeleton at https://github.com/mafalb/ansible_role_skeleton.git

dev

Basic Usage

[ansible_collections] $ git clone https://github.com/mafalb/ansible_collection_skeleton /tmp/ansible_collection_skeleton
[ansible_collections] $ ansible-galaxy collection init --collection-skeleton /tmp/ansible_collection_skeleton local.mycollection

CI

There is a related repository which is partly derived from this repository and is located at https://github.com/mafalb/ansible-test-collections.git

At least one of these collections in that repo is periodically initialized from this skeleton by CI.

[ansible_collections] $ ansible-galaxy collection install git+https://github.com/mafalb/ansible-test-collections.git,dev -p collections

License

Copyright (c) Markus Falb markus.falb@mafalb.at

GPL-3.0-or-later