Add Gandi DNS docs and rewrite homepage intro
New reference card for Gandi DNS configuration and a how-to guide for DNS deployment and PAT cycling. Rewrite the homepage intro for a wider audience ahead of public exposure via docs.eblu.me. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
This commit is contained in:
parent
2cb76de5a2
commit
432dc22f08
9 changed files with 190 additions and 2 deletions
67
docs/reference/infrastructure/gandi.md
Normal file
67
docs/reference/infrastructure/gandi.md
Normal file
|
|
@ -0,0 +1,67 @@
|
|||
---
|
||||
title: gandi
|
||||
tags:
|
||||
- infrastructure
|
||||
- networking
|
||||
- dns
|
||||
---
|
||||
|
||||
# Gandi
|
||||
|
||||
DNS hosting provider for the `eblu.me` domain, managed via Pulumi IaC.
|
||||
|
||||
## Quick Reference
|
||||
|
||||
| Property | Value |
|
||||
|----------|-------|
|
||||
| **Domain** | `eblu.me` |
|
||||
| **Provider** | Gandi LiveDNS |
|
||||
| **IaC** | `pulumi/gandi/` |
|
||||
| **Stack** | `eblu-me` |
|
||||
|
||||
## What It Does
|
||||
|
||||
Gandi hosts the DNS records that make `*.ops.eblu.me` resolve to [[indri]]'s Tailscale IP (100.98.163.89). Since Tailscale IPs are not publicly routable, this gives services real DNS names while keeping them private to the tailnet.
|
||||
|
||||
The target IP is resolved dynamically from `indri.tail8d86e.ts.net` at deploy time, so if indri's Tailscale IP changes, re-running the deployment is sufficient.
|
||||
|
||||
## DNS Records
|
||||
|
||||
| Record | Type | Value | TTL |
|
||||
|--------|------|-------|-----|
|
||||
| `*.ops.eblu.me` | A | indri's Tailscale IP | 300s |
|
||||
| `ops.eblu.me` | A | indri's Tailscale IP | 300s |
|
||||
|
||||
Both records point to [[indri]], which runs [[caddy]] as the reverse proxy for all services. See [[routing]] for the full service URL map.
|
||||
|
||||
## Pulumi Configuration
|
||||
|
||||
The Pulumi program lives in `pulumi/gandi/`:
|
||||
|
||||
- `__main__.py` - Creates the two A records via `pulumiverse_gandi`
|
||||
- `Pulumi.eblu-me.yaml` - Stack config (domain, subdomain)
|
||||
|
||||
Stack config values:
|
||||
|
||||
| Key | Value |
|
||||
|-----|-------|
|
||||
| `blumeops-dns:domain` | `eblu.me` |
|
||||
| `blumeops-dns:subdomain` | `ops` |
|
||||
|
||||
A break-glass override is available via the `BLUMEOPS_REVERSE_PROXY_IP` environment variable, which bypasses dynamic IP resolution.
|
||||
|
||||
## TLS Integration
|
||||
|
||||
[[caddy]] uses Gandi's API separately (via `GANDI_BEARER_TOKEN`) for ACME DNS-01 challenges to obtain a wildcard Let's Encrypt certificate for `*.ops.eblu.me`. This is a different credential from the Pulumi PAT.
|
||||
|
||||
## Authentication
|
||||
|
||||
Gandi requires a Personal Access Token (PAT) for API access. PATs have a maximum lifetime of 90 days (currently set to 30). See [[gandi-operations]] for deployment and PAT cycling instructions.
|
||||
|
||||
## Related
|
||||
|
||||
- [[gandi-operations]] - PAT cycling and deployment how-to
|
||||
- [[routing]] - Service URLs and routing architecture
|
||||
- [[caddy]] - Reverse proxy using Gandi for TLS
|
||||
- [[tailscale]] - Tailnet networking
|
||||
- [[indri]] - Server hosting Caddy (DNS target)
|
||||
|
|
@ -61,5 +61,6 @@ DNS points to indri's Tailscale IP (100.98.163.89). TLS via Let's Encrypt (ACME
|
|||
|
||||
## Related
|
||||
|
||||
- [[gandi]] - DNS hosting for `eblu.me`
|
||||
- [[tailscale]] - ACL configuration
|
||||
- [[indri]] - Where services run
|
||||
|
|
|
|||
|
|
@ -44,6 +44,7 @@ Host inventory and network configuration.
|
|||
- [[indri]] - Primary server
|
||||
- [[gilbert]] - Development workstation
|
||||
- [[tailscale]] - ACLs, groups, tags
|
||||
- [[gandi]] - DNS hosting for `eblu.me`
|
||||
- [[routing|Routing]] - DNS domains, port mappings
|
||||
|
||||
## Kubernetes
|
||||
|
|
|
|||
|
|
@ -92,6 +92,7 @@ The build includes the `github.com/caddy-dns/gandi` plugin for ACME DNS-01 chall
|
|||
|
||||
## Related
|
||||
|
||||
- [[gandi]] - DNS hosting and ACME DNS-01 provider
|
||||
- [[routing]] - Service routing architecture
|
||||
- [[forgejo]] - Git forge (proxied by Caddy)
|
||||
- [[zot]] - Container registry (proxied by Caddy)
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue