Good day.
Thank you for your CouchDB efforts.
Since it cost me a couple of hours, I thought I might suggest that the
documentation in the Helm Chart might be "improved" by adding a visible
notice about the importance of the dns.clusterDomainSuffix Helm value.
This should be a familiar stumbling-point for anyone who has customized
their cluster's DNS, since the "cluster.local" assumption/default is
found in many Helm Charts, but every warning can help.
In addition, I noticed that the "Erlang magic cookie" seems to be
referenced in 2 different ways:
- Through Helm value
- When someone directly creates the Secret, instead of the secret being
automatically generated at Helm installation-time
That is, in the documentation, for the "If you prefer to configure the
admin credentials directly you can create a Secret [...]" section, I'd
also suggest that 'erlangCookie' be added to that list. But for such a
case, it also then needs to be specified as a Helm value at
installation-time, via the 'erlangFlags.setcookie' value. One thing I
found is that even when present in the manually-created Secret prior to
installation, the subsequent Helm installation process issued a warning
about 'erlangFlags.setcookie'. (I'm not sure how it could be any other
way, without Helm interrogating the existing Secret, somehow.)
Also possible is that I've misunderstood these 2 references for
that/these "cookie"/"cookies" and what I've suggested just above is
inaccurate.
The Helm Chart documentation-page I'm thinking of is:
- https://artifacthub.io/packages/helm/couchdb/couchdb
Take care.
- Shao Miller
Synthetel Corporation
