auberge 0.14.2

CLI tool for managing self-hosted infrastructure with Ansible
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48

# auberge headscale list-nodes

List nodes connected to a Headscale instance. Alias: `auberge hs ln`.

```bash
auberge headscale list-nodes [OPTIONS]
```

## Options

| Option                | Description            | Default     |
| --------------------- | ---------------------- | ----------- |
| `--host HOST`         | Host running headscale | Interactive |
| `-o, --output FORMAT` | `human` or `json`      | `human`     |

## Examples

```bash
auberge headscale list-nodes --host myserver
auberge headscale list-nodes --host myserver --output json
```

<details>
<summary>JSON output schema</summary>

```json
[{
  "id": 1,
  "name": "laptop",
  "user": "default",
  "ips": ["100.64.0.1", "fd7a:115c:a1e0::1"],
  "online": true,
  "last_seen": "2024-01-20T15:00:00Z"
}]
```

| Field       | Type     | Description            |
| ----------- | -------- | ---------------------- |
| `id`        | number   | Headscale node ID      |
| `name`      | string   | Node hostname          |
| `user`      | string   | Headscale user         |
| `ips`       | string[] | Assigned Tailscale IPs |
| `online`    | boolean  | Currently connected    |
| `last_seen` | string   | ISO 8601 UTC timestamp |

JSON goes to stdout; human-format chrome goes to stderr.

</details>