auberge 0.14.12

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

# auberge host list

List all configured hosts. Alias: `auberge h l`.

```bash
auberge host list [OPTIONS]
```

## Options

| Option                | Description                      | Default   |
| --------------------- | -------------------------------- | --------- |
| `-t, --tags TAGS`     | Filter by tags (comma-separated) | All hosts |
| `-o, --output FORMAT` | `human` or `json`                | `human`   |

## Examples

```bash
auberge host list
auberge host list --tags production,web
auberge host list --output json
```

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

```json
[{
  "name": "myserver",
  "address": "192.168.1.10",
  "user": "ansible",
  "port": 2222,
  "tags": ["production"]
}]
```

| Field     | Type     | Description               |
| --------- | -------- | ------------------------- |
| `name`    | string   | Host identifier           |
| `address` | string   | IP address or hostname    |
| `user`    | string   | SSH user                  |
| `port`    | number   | SSH port                  |
| `tags`    | string[] | Tags assigned to the host |

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

</details>