Neue Hosts in einer Zone vorbereiten

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 Sie neue Hosts anlegen, prüfen Sie, welche Records bereits vorhanden sind. So vermeiden Sie Kollisionen und erkennen 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

Legen Sie 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 Ihnen die neue id, die Sie für die Verifikation speichern sollten.

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 Sie die RRIDs aus den Antworten gespeichert haben, lesen Sie 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üfen Sie dabei:

ob id mit der Antwort 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üfen Sie vor der Anlage immer die Zone, nicht nur einzelne Namen
verwenden Sie konsistente TTLs für neue Service-Records
schreiben Sie technische Herkunft oder Service-Namen in Annotationen
speichern Sie die neuen RRIDs sofort, damit spätere Updates eindeutig werden
halten Sie Bootstrap und spätere Sollzustands-Synchronisation als getrennte Workflows

Ergebnis

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