Call out performance-optimized k8s config

[jseldess]

Fixes #3823.

[cockroach-teamcity]

This change is 

[cockroach-teamcity]

http://cockroach-docs-review.s3-website-us-east-1.amazonaws.com/159ea74e0862b1f47178b967216d107aaa91f6b5/

[a-robinson]

Reviewed 4 of 4 files at r1.
Reviewable status: complete! 0 of 0 LGTMs obtained

---

_includes/v2.0/orchestration/start-cluster.md, line 22 at r1 (raw file):

~~~

Alternatively, if you'd rather start with a configuration file that has been tweaked for performance, use our [performance version of `cockroachdb-statefulset-secure.yaml`](https://github.com/cockroachdb/cockroach/blob/master/cloud/kubernetes/performance/cockroachdb-statefulset-secure.yaml):

It's worth noting that there are some parameters in the file that may justify tweaking. A more reasonable workflow is to download it (curl or wget), modify it based on the the lines marked TODO, and then kubectl create -f using the locally modified file.

Most notably, even if their cluster has enough cpu/memory for the high performance config, users may not have defined the SSD disk type as called out in the file - https://github.com/cockroachdb/cockroach/blob/master/cloud/kubernetes/performance/cockroachdb-statefulset-secure.yaml#L294

---

v2.0/kubernetes-performance.md, line 24 at r1 (raw file):

In a number of the sections below, we have shown how to modify excerpts from our provided Kubernetes configuration YAML files. You can find the most up-to-date versions of these files on Github, [one for running CockroachDB in secure mode](https://github.com/cockroachdb/cockroach/blob/master/cloud/kubernetes/cockroachdb-statefulset-secure.yaml) and one for [running CockroachDB in insecure mode](https://github.com/cockroachdb/cockroach/blob/master/cloud/kubernetes/cockroachdb-statefulset.yaml).

You can also use a [configuration file for secure mode that has been tweaked for performance](https://github.com/cockroachdb/cockroach/blob/master/cloud/kubernetes/performance/cockroachdb-statefulset-secure.yaml).

I'd also include a note here about how it may require some customization.

[jseldess]

Reviewable status: complete! 0 of 0 LGTMs obtained

---

_includes/v2.0/orchestration/start-cluster.md, line 22 at r1 (raw file):

Previously, a-robinson (Alex Robinson) wrote…

It's worth noting that there are some parameters in the file that may justify tweaking. A more reasonable workflow is to download it (curl or wget), modify it based on the the lines marked TODO, and then kubectl create -f using the locally modified file.

Most notably, even if their cluster has enough cpu/memory for the high performance config, users may not have defined the SSD disk type as called out in the file - https://github.com/cockroachdb/cockroach/blob/master/cloud/kubernetes/performance/cockroachdb-statefulset-secure.yaml#L294

Done.

---

v2.0/kubernetes-performance.md, line 24 at r1 (raw file):

Previously, a-robinson (Alex Robinson) wrote…

I'd also include a note here about how it may require some customization.

Done.

[cockroach-teamcity]

http://cockroach-docs-review.s3-website-us-east-1.amazonaws.com/f433be445262f7cf1f158d450ea147646dc06c15/

[jseldess]

Look ok now, @a-robinson?

[a-robinson]

other than the wget question

Reviewed 4 of 4 files at r2.
Reviewable status: complete! 0 of 0 LGTMs obtained (and 1 stale)

---

_includes/v2.0/orchestration/start-cluster.md, line 28 at r2 (raw file):

    {% include copy-clipboard.html %}
    ~~~ shell
    $ wget https://raw.githubusercontent.com/cockroachdb/cockroach/master/cloud/kubernetes/performance/cockroachdb-statefulset-secure.yaml \

For what it's worth, wget isn't on mac by default. Or at least it isn't on my mac. Do we use it over curl elsewhere in the docs?

[jseldess]

---

_includes/v2.0/orchestration/start-cluster.md, line 28 at r2 (raw file):

Previously, a-robinson (Alex Robinson) wrote…

For what it's worth, wget isn't on mac by default. Or at least it isn't on my mac. Do we use it over curl elsewhere in the docs?

Good catch. We're pretty inconsistent in the docs. Sometimes we give a mac/linux toggle. I'll just use curl here in the hope that most users are on mac.

[cockroach-teamcity]

http://cockroach-docs-review.s3-website-us-east-1.amazonaws.com/cb2d95dee8f805d983ea14ab9e84ed473c212a53/

[rkruze]

It seems we only call out the more performant deployment file when running secure? Should we have some mention in the inse​cure area, as that seems to be what most people do when running a POC.

[jseldess]

Good point, @rkruze. Unfortunately, we only have a secure performant config. It'd probably be confusing to reference that in an insecure deployment. If we can create an insecure performant config, I can include it in the same way.

[a-robinson]

@rkruze if an insecure version would be useful, I can certainly add one.

[rkruze]

I do think it would be useful, thanks!

…

On Fri, Oct 5, 2018 at 9:25 AM Alex Robinson ***@***.***> wrote: @rkruze <https://github.com/rkruze> if an insecure version would be useful, I can certainly add one. — You are receiving this because you were mentioned. Reply to this email directly, view it on GitHub <#3827 (comment)>, or mute the thread <https://github.com/notifications/unsubscribe-auth/AAVecSTEQA6GNRKP5n5fL54Q2_DTauPzks5uh4fpgaJpZM4XIU7Y> .

-- Roko Kruze Solutions Engineer *Cockroach Labs* Direct 646-734-4355