vbotka.ansible
Ansible
This is an Ansible role that helps you install and set up Ansible.
You can find the documentation here.
We welcome you to share your thoughts and report any issues.
Your contributions are welcome.
Supported Platforms
This role works with:
Requirements
Roles
- vbotka.ansible_lib
Collections
- ansible.posix
- community.general
Note: You need the ansible.posix collection for some playbooks and roles in contrib.
Role Variables
Check the default values and examples in the vars section.
Plugins
No plugins are included by default. The default variable is ma_plugins: [ ]. You can find examples of configuring plugins in the file vars/main.yml.sample.
To use plugins, activate them using the template ansible-plugins.cfg.j2 and set *_plugins in ansible.cfg like this:
ma_config_type: template
ma_config_template_default: ansible-plugins.cfg.j2
Check Mode
If the directories ma_plugins_path and ma_src_path are missing, check mode will fail. Make sure to create these directories first:
shell> ansible-playbook ansible.yml -t ma_plugins_path,ma_src_path
To also download the repository and release notes, create these directories: ma_repo_path and ma_rnotes_path.
shell> ansible-playbook ansible.yml -t ma_repo_path,ma_rnotes_path
If you have plugins set up in ma_plugins and haven’t downloaded the archives yet, check mode will fail. Download the archives first:
shell> ansible-playbook ansible.yml -t ma_plugins_download
After that, check the playbook and roles to see what changes will be made:
shell> ansible-playbook ansible.yml --check --diff
Ansible Lint
When using ansible-lint, refer to the configuration file .ansible-lint.local. Some rules may be turned off, and certain warnings may be ignored. Check the notes in this configuration file.
shell> ansible-lint -c .ansible-lint.local
References
- Ansible Documentation
- Ansible Configuration Settings
- Working With Plugins
- Mitogen for Ansible
- Mitogen Release Notes
License
Author Information
ansible-galaxy install vbotka.ansible