Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom

Made compute zone name generic #1431

Merged
merged 7 commits into from
Dec 31, 2019
Merged

Made compute zone name generic #1431

Changes from all commits
Commits
Show all changes
7 commits
Select commit Hold shift + click to select a range
4ce965b
Made compute zone name generic
metonymic-smokey Oct 2, 2019
f0d9676
Fixed note box
metonymic-smokey Oct 15, 2019
a939b08
local changes
metonymic-smokey Nov 20, 2019
381d181
added more details about regional clusters.
metonymic-smokey Dec 22, 2019
3f12877
fixed command.
metonymic-smokey Dec 22, 2019
a44dab2
Added maintainers' changes
metonymic-smokey Dec 31, 2019
6fcc9fa
Finished with all changes
metonymic-smokey Dec 31, 2019
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
18 changes: 16 additions & 2 deletions doc/source/google/step-zero-gcp.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -67,7 +67,7 @@ your google cloud account.
gcloud container clusters create \
--machine-type n1-standard-2 \
--num-nodes 2 \
--zone us-central1-b \
--zone <compute zone from the list linked below> \
--cluster-version latest \
<CLUSTERNAME>

Expand All @@ -84,7 +84,21 @@ your google cloud account.
* ``--zone`` specifies the data center zone where your cluster will be created.
You can pick something from `this list
<https://cloud.google.com/compute/docs/regions-zones/#available>`_
that is not too far away from your users.
that is not too far away from your users.
* .. note::

A region in GCP is a geographical region with at least three zones, where each zone is representing a datacenter with servers etc.

* A regional cluster creates pods across zones in a region(three by default), distributing Kubernetes resources across multiple zones in the region. This is different from the default cluster, which has all its resources within a single zone(as shown above).

* A regional cluster has Highly Available (HA) kubernetes api-servers, this allows jupyterhub which uses them to have no downtime during upgrades of kubernetes itself.

* They also increase control plane uptime to 99.95%.

* To avoid tripling the number of nodes while still having HA kubernetes, the ``--node-locations`` flag can be used to specify a single zone to use.





5. To test if your cluster is initialized, run:
Expand Down