auberge 0.14.15

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 dns delete

Delete the Cloudflare A record for a subdomain. Alias: `auberge d d`.

```bash
auberge dns delete [-s <SUBDOMAIN>] [--dry-run] [--production] [--yes]
```

Idempotent: reports success with "nothing to delete" if no A record exists. Only A records are considered — CNAME/AAAA/TXT records sharing the name are ignored.

## Options

| Option                | Description                     | Default         |
| --------------------- | ------------------------------- | --------------- |
| `-s, --subdomain`     | Subdomain (omit to be prompted) | Interactive     |
| `-n, --dry-run`       | Preview without deleting        | false           |
| `-o, --output FORMAT` | `human` or `json`               | `human`         |
| `-y, --yes`           | Skip confirmation               | false           |
| `-P, --production`    | Use production API              | false (sandbox) |

## Examples

```bash
auberge dns delete -s freshrss --dry-run
auberge dns delete -s freshrss
auberge dns delete -s calibre --production --yes   # CI / no prompts
```

## Gotchas

!> Production deletes require retyping the subdomain name to confirm. Sandbox uses a `[y/N]` prompt. Non-TTY without `--yes` exits without deleting (CI-safe).

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

```json
{ "deleted": true, "fqdn": "freshrss.example.com", "production": false }
```

| Field        | Type    | Description                                  |
| ------------ | ------- | -------------------------------------------- |
| `deleted`    | boolean | `true` if removed; `false` if already absent |
| `fqdn`       | string  | Fully-qualified domain name targeted         |
| `production` | boolean | Whether the production API was used          |

JSON goes to stdout; human-format chrome goes to stderr. The `deleted` field distinguishes an actual deletion from an idempotent no-op — see [ADR-0004](https://github.com/sripwoud/auberge/blob/master/meta/adr/0004-cli-structured-output.md).

</details>