auberge 0.7.0

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
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129

# auberge select playbook

Interactively select an Ansible playbook

## Synopsis

```bash
auberge select playbook
```

## Alias

`auberge se p`

## Description

Presents an interactive list of Ansible playbooks for selection. Outputs the selected playbook path to stdout.

Discovers playbooks from ansible/playbooks/ directory.

## Examples

```bash
# Select playbook
auberge select playbook

# Use in command substitution
PLAYBOOK=$(auberge select playbook)
echo "Selected: $PLAYBOOK"

# Use with other commands
auberge ansible run --host myserver --playbook $(auberge select playbook)

# In shell scripts
#!/bin/bash
PLAYBOOK=$(auberge select playbook)
for host in $(auberge host list -o json | jq -r '.[].name'); do
  auberge ansible run --host "$host" --playbook "$PLAYBOOK"
done
```

## Interactive Selection

```
? Select playbook
  Bootstrap (bootstrap.yml)
> Applications (apps.yml)
  Freshrss Only (freshrss.yml)

[↑↓ to move, Enter to select, Esc to cancel]
```

## Output

Outputs the full playbook path:

```
/home/user/code/auberge/ansible/playbooks/apps.yml
```

Exit codes:

- 0: Playbook selected
- 1: No playbook selected (Esc pressed) or error

## Playbook Discovery

Searches for playbooks in:

- ansible/playbooks/*.yml
- Relative to project root

Recognized playbooks:

- bootstrap.yml
- apps.yml
- Individual app playbooks (freshrss.yml, baikal.yml, etc.)

## Use Cases

**Interactive deployment**:

```bash
HOST=$(auberge select host)
PLAYBOOK=$(auberge select playbook)
auberge ansible run --host "$HOST" --playbook "$PLAYBOOK"
```

**Shell script menu**:

```bash
#!/bin/bash
echo "Select playbook to run:"
PLAYBOOK=$(auberge select playbook)

echo "Select target host:"
HOST=$(auberge select host)

echo "Running $PLAYBOOK on $HOST"
auberge ansible run --host "$HOST" --playbook "$PLAYBOOK"
```

**Quick playbook runner**:

```bash
# In shell alias or function
function aplay() {
  auberge ansible run \
    --host "$(auberge select host)" \
    --playbook "$(auberge select playbook)"
}
```

## Playbook Metadata

Playbooks show descriptive names in the selector:

- File name shown in parentheses
- Display name derived from playbook metadata or filename

## Related Commands

- [auberge select host](host.md) - Select host interactively
- [auberge ansible run](../ansible/run.md) - Run playbook

## See Also

- [Ansible Playbooks](../../core-concepts/ansible.md)
- [Deployment](../../deployment/README.md)