ludus_tailscale

KO | EN

gitlite — search

#javascript #python #hacktoberfest #react #ai #typescript #llm #go #golang #android #machine-learning #rust #deep-learning #linux

ludus_tailscale

★ 14 Open GitHub ↗

Ansible Role for Ludus to provision or remove a device to/from a Tailnet.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# ludus_tailscale
Ansible Role for Ludus to provision or remove a device to/from a Tailnet.
## REQUIREMENTS
- Requires Ludus 1.5.4 or greater as this version and above contain improvements in IP determination within the Dynamic Inventory steps which affect how Ludus operates in a Tailscale environment.
- Tailscale authorization key which is configured for reuse if going to be used for more then one VM.
- Tailscale API key with permissions to remove devices.
## Installation Instructions
### To Install with ansible galaxy
```
ludus ansible role add NocteDefensor.ludus_tailscale
```
- If you install from this method, in your range config the role name should be "NocteDefensor.ludus_tailscale"
### To Install from this git repo
- Clone this repo
```
git clone https://github.com/NocteDefensor/ludus_tailscale.git
```
- add it to ludus roles
```
ludus ansible role add -d ./ludus_tailscale
```
## Role Variables
```
tailscale_state: present/absent
tailscale_authkey: "tskey-auth-<REDACTED_KEY>"
tailscale_api_key: "tskey-api-<REDACTED_KEY>"
tailscale_ssh: true/false
tailscale_dns: true/flase
```
## Deploy role
- set your config like the one in the example ludus-config.yaml
  - Ensure your api key is for a user with permissions to remove devices from the tailnet.
  - ensure auth key is valid
- either deploy whole range with
```
ludus range deploy
```
- or deploy just tailscale role
  - Useful for deploying tailscale to existing vm's or removing tailscale from existing VM's.
  - **Hint**: can be used with "absent" as the tailscale state variable value to purge tailscale prior to destroying range.
```
ludus range deploy -t user-defined-roles --only-roles <ludus_tailscale| NocteDefensor.ludus_tailscale>
```
## Walkthrough.
[@jessefmoore](https://twitter.com/jessefmore) was awesome enough to test this and also created a nice walkthrough video of deploying tailscale and removing it.

[![Video Title](https://img.youtube.com/vi/8ksRU_b2rFs/0.jpg)](https://youtu.be/8ksRU_b2rFs?si=oUJMhZ2TlNVYUZfv)
## Recognition and Contributions
- [@jessefmoore](https://twitter.com/jessefmoore) for the tremendous amount of patience and effort during multiple nights of testing.
- [Bad Sector Labs](https://twitter.com/badsectorlabs) for making an awesome tool to easily deploy and purge lab environments via proxmox.

ludus_tailscale

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README