open a ssh session with a defined host in an ansible inventory
- python 3.5 or greater
- ansible 2.4 or greater
- openssh client (present in most systems)
Tested in ubuntu, debian, alpine and arch linux, but should be work on almost linux systems
clone the project and install it.
git clone https://github.com/mrmilu/ansible-tty
cd ansible-tty
sudo pip3 install .
Or via pip:
pip3 install https://github.com/mrmilu/ansible-tty/archive/master.zip
You can use the public image of docker:
docker pull mrmiludevops/ansible-tty
you should use it binding some read-only volumes, for example you maybe want access to your ssh keys or aws profiles and sure you will want read your ansible's inventory
docker run --rm -it \
-v $(pwd):/workdir:ro \
-v $HOME/.ssh/:/root/.ssh/:ro \
-v $HOME/.aws/:/root/.aws/:ro \
mrmiludevops/ansible-tty -i [your inventory]
Also you can build you own image:
docker build -t ansible-tty .
usage: ansible-tty [-h] [-i INVENTORY] [hostname]
Init an ssh interactive terminal using ansible inventories
positional arguments:
hostname Try to filter and connect to the unique hostname
optional arguments:
-h, --help show this help message and exit
-i INVENTORY, --inventory INVENTORY
use a specific ansible inventory- If no inventory is provided, ansible-inventory will try to load the default inventory
- If no hostname is provided, the script will scan all hosts defined in inventory and will show an interactive dialog so you can choose one of them
- configure more connectors than ssh (sshlxd, lxc, docker...)
- use "ansible-eval" to get the real content of needed variables because the variables like "ansible_ssh_host" or "ansible_ssh_private_key_file" if have jinja syntax, ansible-inventories don't evaluate them
- add some kind of tests
All pull requests are welcome!
This project is licensed under GPL v3 licence - see the LICENSE file for details