Update CRDB operator examples and instructions for deprecated fields #21543
Conversation
✅ Deploy Preview for cockroachdb-interactivetutorials-docs canceled.
|
✅ Deploy Preview for cockroachdb-api-docs canceled.
|
✅ Netlify Preview
To edit notification comments on pull requests, go to your Netlify project configuration. |
| - The `values.yaml` configuration maps to a subset of `cockroach start` flags when CockroachDB is initialized. | ||
|
|
||
| This page describes configuration options that allow advanced users to manually override the pod template and `cockroach start` flags as needed for deployment. | ||
| This page describes configuration options that allow advanced users to manually override pod template metadata and `cockroach start` flags as needed for deployment. |
There was a problem hiding this comment.
@NishanthNalluri @pritesh-lahoti Originally this page was written when the only purpose of podTemplate fields was to modify the spec from default, but now much of the default pod config is defined here. Is there a reason to keep this content? Is there a situation where a customer may need to modify other fields under podTemplate than the ones we've moved there?
There was a problem hiding this comment.
@jhlodin I believe both the sections (pod template and start flags) should stay.
We could update the examples to not repeat the ones that we already have documented elsewhere, e.g. we could remove the affinity related example, but retain the one for init-containers and containers, as this is definitely a use-case for advanced customers.
On that note, we have resolved the changes to not require the containers field within pod template (https://cockroachlabs.atlassian.net/browse/CC-33346), so we could take this opportunity to refactor the same too.
jhlodin
force-pushed
the
jl/doc-15288
branch
2 times, most recently
from
6f65125 to
84ae52c
Compare
| - The `values.yaml` configuration maps to a subset of `cockroach start` flags when CockroachDB is initialized. | ||
|
|
||
| This page describes configuration options that allow advanced users to manually override the pod template and `cockroach start` flags as needed for deployment. | ||
| This page describes configuration options that allow advanced users to manually override pod template metadata and `cockroach start` flags as needed for deployment. |
There was a problem hiding this comment.
@jhlodin I believe both the sections (pod template and start flags) should stay.
We could update the examples to not repeat the ones that we already have documented elsewhere, e.g. we could remove the affinity related example, but retain the one for init-containers and containers, as this is definitely a use-case for advanced customers.
On that note, we have resolved the changes to not require the containers field within pod template (https://cockroachlabs.atlassian.net/browse/CC-33346), so we could take this opportunity to refactor the same too.
jhlodin
force-pushed
the
jl/doc-15288
branch
from
84ae52c to
e0c72db
Compare
2 participants
https://cockroachlabs.atlassian.net/browse/DOC-15288
Update docs as needed to account for cockroachdb/helm-charts#578
TODO: Backport to other CRDB versions once these changes are reviewed.