From 16480fae14a45cde39c15c30b960d245b58930bd Mon Sep 17 00:00:00 2001 From: Claudio Busse Date: Tue, 11 Aug 2026 10:04:21 +0200 Subject: [PATCH] Update hash4 description to reflect uniqueness enforcement Clarify that hash4 uniqueness per cluster_alias is enforced by the platform-api at creation time, derived from the cluster UUID. Co-Authored-By: Claude Opus 4.6 --- docs/design/dns-architecture.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/design/dns-architecture.md b/docs/design/dns-architecture.md index 6aa94f885..bc060807e 100644 --- a/docs/design/dns-architecture.md +++ b/docs/design/dns-architecture.md @@ -121,7 +121,7 @@ Zones created by HyperShift CPO in the customer account (not delegated from shar | :---------------- | :-------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------ | :----------------- | :------------------------------------------------------------------------- | | `deployment_name` | 1–25 characters | Subdomain for a regional deployment. Defaults to the AWS region name; suffixed when multiple deployments share a region or for per-run CI environments. | Service | `us-east-1` (len 9), `us-east-1-2` (len 12), `us-east-1-eph-a1b2` (len 19) | | `zone_shard` | 1–3 characters | Subdomain for a regional deployment's HostedZone shard (capped at 100) | Service | `0` (len 1), `99` (len 2) | -| `hash4` | 4 characters | Slug to allow duplicate `cluster_alias` | Service | `1fb9` (len 4) | +| `hash4` | 4 characters | Unique slug per `cluster_alias` within a zone shard; derived from cluster UUID, uniqueness enforced by platform-api at creation time | Service | `1fb9` (len 4) | | `cluster_alias` | 1–15 characters | Alias for the cluster: user-provided (`domain_prefix`) or service-generated hash | Service / Customer | `typeidhcp` (len 10), `4354c27df47cf4e` (len 15) | All identifiers must be DNS-subdomain compatible: lowercase alphanumeric characters or `-`, starting and ending with an alphanumeric character.