ansible-tailscale-inventory

Dependency-free dynamic Ansible inventory for your Tailscale hosts. Allows you to reach your Tailscale hosts easily with Ansible. All you need is Tailscale installed and working, python 3.8+, and a copy of ansible_tailscale_inventory.py from this repo.

Usage

From one of your Tailscale nodes on your network, make ansible_tailscale_inventory.py available as an inventory to Ansible. This can be done as an argument to the -i option on Ansible commands, or by setting the ANSIBLE_INVENTORY environment variable's value as the path to the script.

Notes:

• At the time of writing, the inventory script has been tested with macOS and Linux, but not Windows.
• If you copy/paste the script from GitHub rather than cloning the repo and copying the file, ensure the script is marked as an executable.

Ansible Groups

ansible_tailscale_inventory.py automatically provides a few groups.

• There are groups of hosts for each operating system (macOS, linux, etc)
• Online hosts are found in the online group, offline hosts in the offline group
• The self group includes the local host
• Each Tailscale tag that has at least one host will be a group as well. The name will be formatted as tag_TagName (- and : characters will be replaced with underscores)

Inventory Metadata

The inventory automatically adds all available Tailscale IPs as a list in the fact tailscale_ips.

Contributing

Check out the contributing doc.