Add example config and zones.txt files
Provide catz.yaml.example and zones.txt.example as starting points for new users. The config follows RFC 9432's recommendation to use "invalid." for SOA mname/rname. The zones file demonstrates all supported features: single/multiple catalog assignment, group property, coo property, and combinations.
This commit is contained in:
17
catz.yaml.example
Normal file
17
catz.yaml.example
Normal file
@@ -0,0 +1,17 @@
|
||||
# catalog-zone-gen configuration
|
||||
#
|
||||
# Each catalog becomes an output zone file named <zone>.zone
|
||||
# Catalog names here are referenced in zones.txt
|
||||
|
||||
catalogs:
|
||||
prod:
|
||||
zone: catalog-prod.example.com.
|
||||
staging:
|
||||
zone: catalog-staging.example.com.
|
||||
|
||||
# SOA fields for all generated zone files
|
||||
# RFC 9432 recommends "invalid." for both since catalog zones
|
||||
# are not queried via normal DNS resolution.
|
||||
soa:
|
||||
mname: invalid.
|
||||
rname: invalid.
|
||||
23
zones.txt.example
Normal file
23
zones.txt.example
Normal file
@@ -0,0 +1,23 @@
|
||||
# Zones to include in catalog zones
|
||||
#
|
||||
# Format: <zone> <catalog>[, <catalog>...] [, group=<value>] [, coo=<fqdn>]
|
||||
#
|
||||
# - Catalogs are bare names matching keys in catz.yaml
|
||||
# - group: RFC 9432 property — consumers apply shared config to grouped zones
|
||||
# - coo: RFC 9432 change-of-ownership — points to the old catalog during migration
|
||||
|
||||
# Simple: zone in one catalog
|
||||
app.example.com prod
|
||||
|
||||
# Zone served by multiple catalogs
|
||||
example.com prod, staging
|
||||
|
||||
# Group property — lets consumers apply per-group policy
|
||||
api.example.com prod, group=critical
|
||||
dev.example.net staging, group=testing
|
||||
|
||||
# Change-of-ownership — zone migrating from another catalog
|
||||
legacy.example.org prod, coo=old-catalog.example.com.
|
||||
|
||||
# Both properties
|
||||
internal.example.org prod, group=internal, coo=old-catalog.example.com.
|
||||
Reference in New Issue
Block a user