Private DNS is in preview, and the
v1alpha1 API can change.Locations and runtimes
Private DNS works on every gVPC network, in these locations:
A network that spans several locations has one set of names. An Instance in one location resolves the names of Instances in the other locations on the same network.
Both runtime classes,
general-purpose and unikernel, get Private DNS. Instances use the resolvers that Datum configures for them. In a general-purpose Instance, they’re in /etc/resolv.conf. An app that uses its own resolver, such as a hard-coded public resolver or DNS over HTTPS, can’t resolve private names.
Names
- Every network’s managed zone is
datum.internal. Each network has its own copy. - Compute publishes Instances at
<instance-name>.instances.datum.internal. Long or unusual Instance names are shortened, so read the exact name from the Instance’sstatus.dns. Compute owns every name at or belowinstances.datum.internal, so you can’t add records there or create a zone that covers it. - Use full names. Don’t rely on short names such as
web-default-us-central-1-0: they depend on search domains that can differ between Instances. - Zone domains use lowercase letters, digits, and hyphens, with each label starting and ending with a letter or digit. They have at least two labels and are at most 253 characters long.
- Record names are relative to their zone, such as
api, or fully qualified.@means the zone’s own domain. Names aren’t case-sensitive. - A private zone hides the public records of the same domain from the networks it’s associated with.
Record rules
ALIASandSOArecords aren’t supported. Datum manages each private zone’sSOArecord.- A zone’s own domain (
@) can’t be aCNAME. - A
CNAMEcan’t share a name with another record type. - Point a
CNAMEat a name in the same zone. ACNAMEthat points into another zone, or at a public name, may return only theCNAME, which most apps can’t follow. - An
SRVtarget must be a name withAorAAAArecords in the same zone. - If two record sets have the same name and type, the older one keeps it, and the newer one isn’t accepted.
- A record set is accepted or rejected as a whole. One invalid record keeps every name in it from resolving.
Limits
How long changes take
Publication is asynchronous. Wait for the status conditions described in Check status rather than a fixed delay.
Privacy
- A private name resolves only from networks that its zone is associated with. Private names aren’t published to public DNS.
- A network resolves another network’s zone only through an association that you create.
- Resolving a name doesn’t grant network access. See Traffic and connecting.
- Public names keep resolving through the same resolvers.