Skip to content
regfish Docs

Bootstrap new hosts in an existing zone

This recipe fits the case where several hostnames must be created for a new service, such as api, app, or status. The flow combines inventory, creation, and direct verification.

Prerequisites

Section titled “Prerequisites”
  • an API key with access to the DNS endpoints
  • an existing zone managed through regfish DNS
  • target values for the new hosts, such as IP addresses or CNAME targets
  • a naming convention for technical and public hostnames

Step 1: Inspect the existing zone

Section titled “Step 1: Inspect the existing zone”

Before creating new hosts, inspect the current zone so you can avoid collisions and detect early whether a hostname is already in use.

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

Step 2: Create the first host

Section titled “Step 2: Create the first host”

For example, create an API host with a direct IPv4 target.

Terminal-Fenster
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"
}
'

The response returns the new id, which should be stored for verification.

Step 3: Create another host as a CNAME

Section titled “Step 3: Create another host as a CNAME”

For web or routing entry points, a CNAME is often a good fit.

Terminal-Fenster
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"
}
'

Step 4: Verify the created records directly

Section titled “Step 4: Verify the created records directly”

Once you have stored the RRIDs returned by the create calls, fetch the records individually.

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

Check:

  • that id matches the value returned by the create call
  • that name, type, and data were stored correctly
  • that ttl and annotations were written as intended

Practical notes for production workflows

Section titled “Practical notes for production workflows”
  • always inspect the zone before creating new records
  • use consistent TTLs for newly bootstrapped service records
  • store technical origin or service names in annotations
  • keep the new RRIDs immediately so later updates remain explicit
  • treat bootstrap and later desired-state synchronization as separate workflows

Result

Section titled “Result”

This workflow lets you add new hosts to an existing zone quickly and in a controlled way. It is especially useful for new services, staging environments, or standardized platform provisioning.