https://github.com/jctanner/ansible-tools
https://github.com/jctanner/ansible-tools
Last synced: about 2 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/jctanner/ansible-tools
- Owner: jctanner
- License: apache-2.0
- Created: 2016-04-22T01:54:25.000Z (about 9 years ago)
- Default Branch: master
- Last Pushed: 2020-04-17T19:17:31.000Z (about 5 years ago)
- Last Synced: 2025-02-25T08:12:14.594Z (about 2 months ago)
- Language: Python
- Size: 280 KB
- Stars: 41
- Watchers: 4
- Forks: 18
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- jimsghstars - jctanner/ansible-tools - (Python)
README
# ansible-tools
Some useful tools for folks that triage/fix/debug/deal with github.com/ansible/ansible
* ansible-workon - make a working directory and helpers for fixing an ansible issue
* ansible-list-versions - emits a list of all the released versions of ansible
* ansible-test-versions - runs a script with all versions or a subset of ansible
* list-ansible-installs - inventories all the places ansible could have been installed
* docker_killall - stop all containers
* docker_rmall - clean up all dead container images# installing
for end users ...
```
pip install ansible-dev-tools
```for devs ...
```
virtualenv /tmp/atools.venv
source /tmp/atools.venv/bin/activate
git clone https://github.com/jctanner/ansible-tools
cd ansible-tools
python setup.py develop
```# Usage
The most common thing you'll probably use from this set of tools is ansible-test-verisons ...
1. Install the package
2. ansible-workon --repo=ansible --number=60000
3. cd ~/workspace/issues/ansible-60000
4. ansible-test-versions --start=2.9.0 test.shThe command is going to do a few things ...
* fetch all release tarballs from releases.ansible.com
* extract all the tarballs
* add a hacking/env-setup script from devel to all the extrated dirs
* iterate through releases defined by the arguments (or all) and run test.sh with themThe test.sh script is a minimal sort of "hello world" script that runs a simple playbook. Depending on what you are trying to fix or test, you'll need to edit the test.sh, site.yml, ansible.cfg and inventory files created by the ansible-workon script.