https://github.com/roles-ansible/ansible_role_versioncheck
Ansible role to make sure your local client is up to date
https://github.com/roles-ansible/ansible_role_versioncheck
ansible ansible-role hacktoberfest role-ansible versioning
Last synced: 2 months ago
JSON representation
Ansible role to make sure your local client is up to date
- Host: GitHub
- URL: https://github.com/roles-ansible/ansible_role_versioncheck
- Owner: roles-ansible
- License: mit
- Created: 2019-10-01T21:03:17.000Z (almost 7 years ago)
- Default Branch: main
- Last Pushed: 2022-12-28T15:48:47.000Z (over 3 years ago)
- Last Synced: 2025-06-17T04:39:59.025Z (about 1 year ago)
- Topics: ansible, ansible-role, hacktoberfest, role-ansible, versioning
- Homepage: https://galaxy.ansible.com/do1jlr/ansible_version/
- Size: 87.9 KB
- Stars: 3
- Watchers: 1
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
Awesome Lists containing this project
README
[](https://galaxy.ansible.com/do1jlr/ansible_version/) [](https://github.com/roles-ansible/ansible_role_versioncheck/blob/master/LICENSE)
Check Ansible Version
========================
What is it doing?
--------------
This role check the ansible-playbook version and will fail, if it is to old.
This should help prevent bigger issues with to old ansible installations
How to use?
-----------
This anisble role should be executet on ``localhost``.
### Example playbook:
**With ansible galaxy:**
```bash
# install role
ansible-galaxy install do1jlr.ansible_version
```
Example playbook:
```
---
- hosts: localhost
roles:
- {role: do1jlr.ansible_version, tags: [version, always], gather_facts: false}
```
**Without ansible galaxy:**
Add this role to your roles as ``ansible_version``. *Example:*
```bash
git clone https://github.com/roles-ansible/ansible_role_versioncheck.git roles/ansible_version
```
Your Playbook could look like this:
```ini
---
- name: check if ansible is not to old
hosts: localhost
tags:
- default
- version
- always
roles:
- ansible_version
gather_facts: false
```
Modifications
------------
For possible modifications please have a look into the ``default`` Folder!
Participation
-------------
This role is developed on [github](https://github.com/roles-ansible/ansible_role_versioncheck.git).
Feel free to add any Issues or PullRequests there. Thanks <3
Testing
---------
This role is tested with [these github-action](https://github.com/search?q=topic%3Acheck-ansible+topic%3Agithub-actions+org%3Aroles-ansible&type=Repositories) tests for different versions of debian and ubuntu. Linting is tested via travis-ci and the official ansible github action.
If you want to find out more about our tests, please have a look at the github marketplace.
| test status | Github Marketplace |
| :--------- | :---------------- |
| [](https://github.com/roles-ansible/ansible_role_versioncheck/actions?query=workflow%3A%22Ansible+Lint+check%22) | [ansible-lint action](https://github.com/marketplace/actions/ansible-lint) |
| [](https://github.com/roles-ansible/ansible_role_versioncheck/actions/workflows/yamllint.yaml) | [yamllint-github-action](https://github.com/marketplace/actions/yamllint-github-action) |
| [](https://github.com/roles-ansible/ansible_role_versioncheck/actions/workflows/galaxy.yml) | [publish-ansible-role-to-galaxy](https://github.com/marketplace/actions/publish-ansible-role-to-galaxy) |
| [](https://github.com/roles-ansible/ansible_role_versioncheck/actions?query=workflow%3A%22Ansible+check+debian%3Astable%22) | [ansible test with debian stable](https://github.com/marketplace/actions/check-ansible-debian-stable) |
| [](https://github.com/roles-ansible/ansible_role_versioncheck/actions?query=workflow%3A%22Ansible+check+debian%3Asid%22) | [ansible test with debian sid](https://github.com/marketplace/actions/check-ansible-debian-sid) |
| [](https://github.com/roles-ansible/ansible_role_versioncheck/actions?query=workflow%3A%22Ansible+check+debian%3Abuster%22) | [ansible test with debian buster](https://github.com/marketplace/actions/check-ansible-debian-buster) |
| [](https://github.com/roles-ansible/ansible_role_versioncheck/actions?query=workflow%3A%22Ansible+check+debian%3Astretch%22) | [ansible test with debian stretch](https://github.com/marketplace/actions/check-ansible-debian-stretch) |
| [](https://github.com/roles-ansible/ansible_role_versioncheck/actions?query=workflow%3A%22Ansible+check+ubuntu%3Alatest%22) | [ansible test with ubuntu latest](https://github.com/marketplace/actions/check-ansible-ubuntu-latest) |
| [](https://github.com/roles-ansible/ansible_role_versioncheck/actions?query=workflow%3A%22Ansible+check+ubuntu%3Abionic%22) | [ansible test with ubuntu bionic](https://github.com/marketplace/actions/check-ansible-ubuntu-bionic) |
| [](https://github.com/roles-ansible/ansible_role_versioncheck/actions?query=workflow%3A%22Ansible+check+ubuntu%3Atrusty%22) | [ansible test with ubuntu trusty](https://github.com/marketplace/actions/check-ansible-ubuntu-trusty) |
| [](https://github.com/roles-ansible/ansible_role_versioncheck/actions?query=workflow%3A%22Ansible+check+centos%3Acentos7%22) | [ansible test with ubuntu xenial](https://github.com/marketplace/actions/check-ansible-centos-centos7) |
| [](https://github.com/roles-ansible/ansible_role_versioncheck/actions?query=workflow%3A%22Ansible+check+centos%3Acentos8%22) | [ansible test with ubuntu xenial](https://github.com/marketplace/actions/check-ansible-centos-centos8) |
| [](https://github.com/roles-ansible/ansible_role_versioncheck/actions?query=workflow%3A%22Ansible+check+centos%3Alatest%22) | [ansible test with ubuntu xenial](https://github.com/marketplace/actions/check-ansible-centos-latest) |