What needs to happen
Every hostname on a proxy should report the same set of conditions, whether the user brought the name or we generated it. A hostname we generate reports only that it was claimed and that it is covered by a certificate; the condition saying its DNS record has been programmed never appears, even after the name resolves. A user who wrote a wait loop around that condition, straight from our documentation, polled for four minutes against a hostname that had already been resolving for three of them.
Why this matters
This is the documented way to know a proxy is usable, and for the hostname most people get first it never becomes true. Anyone automating a deploy has to discover by experiment that the condition they were told to wait for only exists on custom hostnames, then write two code paths. A closely related timing problem on custom hostnames is tracked in custom hostname programming latency; this one is about the condition being absent altogether.
The same report flagged a second, smaller version of the same issue: the schema says the system may automatically generate a hostname. It always does. Stating that plainly removes a branch an agent otherwise has to test for.
Desired outcome
Related to #291
What needs to happen
Every hostname on a proxy should report the same set of conditions, whether the user brought the name or we generated it. A hostname we generate reports only that it was claimed and that it is covered by a certificate; the condition saying its DNS record has been programmed never appears, even after the name resolves. A user who wrote a wait loop around that condition, straight from our documentation, polled for four minutes against a hostname that had already been resolving for three of them.
Why this matters
This is the documented way to know a proxy is usable, and for the hostname most people get first it never becomes true. Anyone automating a deploy has to discover by experiment that the condition they were told to wait for only exists on custom hostnames, then write two code paths. A closely related timing problem on custom hostnames is tracked in custom hostname programming latency; this one is about the condition being absent altogether.
The same report flagged a second, smaller version of the same issue: the schema says the system may automatically generate a hostname. It always does. Stating that plainly removes a branch an agent otherwise has to test for.
Desired outcome
Related to #291