Dieses Rezept eignet sich, wenn für einen neuen Dienst mehrere Hostnamen angelegt werden sollen, zum Beispiel api, app oder status. Der Ablauf kombiniert Bestandssichtung, Anlage und sofortige Verifikation.

Voraussetzungen

• ein API-Key mit Zugriff auf DNS-Endpunkte
• eine bestehende Zone bei Regfish DNS
• die Zielwerte für neue Hosts, zum Beispiel IP-Adressen oder CNAME-Ziele
• eine Benennungskonvention für technische und öffentliche Hostnamen

Schritt 1: Bestehende Zone prüfen

Bevor du neue Hosts anlegst, prüfst du, welche Records bereits vorhanden sind. So vermeidest du Kollisionen und erkennst früh, ob ein Name schon belegt ist.

curl --request GET \
  --url 'https://api.regfish.com/dns/example.com/rr' \
  --header 'x-api-key: YOUR_API_KEY'

Schritt 2: Ersten Host anlegen

Lege zum Beispiel einen API-Host mit einer direkten IPv4-Adresse an.

curl --request POST \
  --url 'https://api.regfish.com/dns/rr' \
  --header 'content-type: application/json' \
  --header 'x-api-key: YOUR_API_KEY' \
  --data '
{
  "type": "A",
  "name": "api.example.com.",
  "data": "203.0.113.20",
  "ttl": 300,
  "annotation": "bootstrap-api"
}
'

Die Antwort liefert dir die neue id, die du für die Verifikation speichern solltest.

Schritt 3: Weiteren Host als CNAME anlegen

Für Web- oder Routing-Einstiege ist oft ein CNAME sinnvoll.

curl --request POST \
  --url 'https://api.regfish.com/dns/rr' \
  --header 'content-type: application/json' \
  --header 'x-api-key: YOUR_API_KEY' \
  --data '
{
  "type": "CNAME",
  "name": "app.example.com.",
  "data": "api.example.com.",
  "ttl": 300,
  "annotation": "bootstrap-app"
}
'

Schritt 4: Angelegte Records gezielt verifizieren

Sobald du die RRIDs aus den Antworten gespeichert hast, liest du die Records gezielt noch einmal zurück.

curl --request GET \
  --url 'https://api.regfish.com/dns/rr/5001' \
  --header 'x-api-key: YOUR_API_KEY'

Prüfe dabei:

• ob id mit der Anwort aus dem Create-Schritt übereinstimmt
• ob name, type und data korrekt gespeichert wurden
• ob ttl und Annotationen wie geplant gesetzt sind

Praxishinweise für produktive Abläufe

• prüfe vor der Anlage immer die Zone, nicht nur einzelne Namen
• verwende konsistente TTLs für neue Service-Records
• schreibe technische Herkunft oder Service-Namen in Annotationen
• speichere die neuen RRIDs sofort, damit spätere Updates eindeutig werden
• halte Bootstrap und spätere Sollzustands-Synchronisation als getrennte Workflows

Ergebnis

Mit diesem Ablauf bringst du neue Hosts schnell und kontrolliert in eine bestehende Zone. Das ist besonders nützlich für neue Dienste, Staging-Umgebungen oder standardisierte Plattform-Bereitstellungen.