auberge 0.8.6

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
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179

# auberge dns migrate

Migrate all A records to new IP address

## Synopsis

```bash
auberge dns migrate --ip <IP> [OPTIONS]
```

## Alias

`auberge d m`

## Description

Updates all existing A records to point to a new IP address. Useful for server migrations.

Shows a table of old vs new IPs before making changes (dry run by default is recommended).

## Options

| Option           | Description                           | Default |
| ---------------- | ------------------------------------- | ------- |
| -i, --ip IP      | New IP address (required)             | None    |
| -n, --dry-run    | Preview without updating              | false   |
| -P, --production | Use production API (default: sandbox) | false   |

## Examples

```bash
# Preview migration
auberge dns migrate --ip 10.0.0.5 --dry-run

# Execute migration
auberge dns migrate --ip 10.0.0.5

# Production API
auberge dns migrate --ip 10.0.0.5 --production
```

## Dry Run Output

```
CLOUDFLARE DNS
[DRY RUN] DNS Migration Preview
--------------------------------------------------
SUBDOMAIN      CURRENT           NEW
--------------------------------------------------
blocky         192.168.1.10  ->  10.0.0.5
freshrss       192.168.1.10  ->  10.0.0.5
baikal       192.168.1.10  ->  10.0.0.5
calibre        192.168.1.10  ->  10.0.0.5
navidrome      192.168.1.10  ->  10.0.0.5

Would update 5 A record(s).
```

## Execution Output

```
CLOUDFLARE DNS
DNS Migration
--------------------------------------------------
SUBDOMAIN      CURRENT           NEW
--------------------------------------------------
blocky         192.168.1.10  ->  10.0.0.5
freshrss       192.168.1.10  ->  10.0.0.5
baikal       192.168.1.10  ->  10.0.0.5

Updated 3 A record(s).
```

## Migration Process

1. **Query all A records** from Cloudflare
2. **Filter records** to migrate (only A records)
3. **Show preview** of changes
4. **Update each record** to new IP
5. **Report results**

## Use Cases

**VPS migration**:

```bash
# 1. Preview changes
auberge dns migrate --ip 10.0.0.5 --dry-run

# 2. Verify preview is correct
# 3. Execute migration
auberge dns migrate --ip 10.0.0.5

# 4. Verify records
auberge dns list
```

**Disaster recovery**:

```bash
# Quickly point all records to new server
auberge dns migrate --ip 203.0.113.5
```

## Workflow for Server Migration

1. **Prepare new server**:
   ```bash
   # Bootstrap new server
   auberge ansible bootstrap newserver --ip 10.0.0.5

   # Deploy applications
   auberge ansible run --host newserver
   ```

2. **Test before DNS migration**:
   ```bash
   # Add to /etc/hosts for testing
   echo "10.0.0.5 freshrss.example.com" | sudo tee -a /etc/hosts

   # Test services
   curl https://freshrss.example.com
   ```

3. **Migrate DNS** (dry run first):
   ```bash
   auberge dns migrate --ip 10.0.0.5 --dry-run
   auberge dns migrate --ip 10.0.0.5
   ```

4. **Verify migration**:
   ```bash
   auberge dns list
   dig freshrss.example.com
   ```

## Safety Features

**Dry run recommended**: Always preview with --dry-run first
**Only A records**: Doesn't touch CNAME, MX, TXT, etc.
**Atomic updates**: Each record updated independently

## Record Types Affected

**Affected**:

- A records (IPv4)

**Not affected**:

- AAAA records (IPv6) - use set-all or set individually
- CNAME records
- MX records
- TXT records
- NS records

## Troubleshooting

**No records updated**:

- Check you have A records: `auberge dns list`
- Verify IP format is valid

**Partial update**:

- Some records updated, some failed
- Check Cloudflare API status
- Manually fix failed records with `auberge dns set`

## Related Commands

- [auberge dns list](list.md) - Verify migration
- [auberge dns set](set.md) - Fix individual records
- [auberge dns set-all](set-all.md) - Bulk create records

## See Also

- [DNS Management](../../dns/README.md)
- [Migration Guide](../../backup-restore/migration.md)