Skip to content

Commit f8481d9

Browse files
corryrootcorryroot
committed
(DOCSP-41012): Backport DOCSP-39568 to v1.25. (#1762)
* (DOCSP-39568): Broke up the prerequisites. * (DOCSP-39568): Incorporated Mircea's feedback.
1 parent 5e833ad commit f8481d9

File tree

2 files changed

+82
-56
lines changed

2 files changed

+82
-56
lines changed

‎source/multi-cluster-prerequisites.txt

Lines changed: 11 additions & 56 deletions
Original file line numberDiff line numberDiff line change
@@ -18,7 +18,10 @@ Prerequisites
1818

1919

2020
Before you create a |multi-cluster| using either the quick start or a
21-
deployment procedure, complete the following tasks:
21+
deployment procedure, complete the following tasks.
22+
23+
To learn more about prerequisites specific to the quick start, see
24+
:ref:`Quick Start Prerequisites <multi-cluster-qs-prerequisites>`.
2225

2326
Review Supported Hardware Architectures
2427
---------------------------------------
@@ -35,66 +38,18 @@ Clone the :github:`MongoDB Enterprise Kubernetes Operator repository </mongodb/m
3538

3639
git clone https://github.com/mongodb/mongodb-enterprise-kubernetes.git
3740

38-
Set Environment Variables and GKE Zones
39-
----------------------------------------
41+
Set Environment Variables
42+
-------------------------
4043

41-
Set the environment variables with cluster names and the
42-
`available GKE zones <https://cloud.google.com/compute/docs/regions-zones#available>`__
44+
Set the environment variables with cluster names
4345
where you deploy the clusters, as in this example:
4446

4547
.. code-block:: sh
4648

47-
export MDB_GKE_PROJECT={GKE project name}
48-
49-
export MDB_CENTRAL_CLUSTER="mdb-central"
50-
export MDB_CENTRAL_CLUSTER_ZONE="us-west1-a"
51-
52-
export MDB_CLUSTER_1="mdb-1"
53-
export MDB_CLUSTER_1_ZONE="us-west1-b"
54-
55-
export MDB_CLUSTER_2="mdb-2"
56-
export MDB_CLUSTER_2_ZONE="us-east1-b"
57-
58-
export MDB_CLUSTER_3="mdb-3"
59-
export MDB_CLUSTER_3_ZONE="us-central1-a"
60-
61-
export MDB_CENTRAL_CLUSTER_FULL_NAME="gke_${MDB_GKE_PROJECT}_${MDB_CENTRAL_CLUSTER_ZONE}_${MDB_CENTRAL_CLUSTER}"
62-
63-
export MDB_CLUSTER_1_FULL_NAME="gke_${MDB_GKE_PROJECT}_${MDB_CLUSTER_1_ZONE}_${MDB_CLUSTER_1}"
64-
export MDB_CLUSTER_2_FULL_NAME="gke_${MDB_GKE_PROJECT}_${MDB_CLUSTER_2_ZONE}_${MDB_CLUSTER_2}"
65-
export MDB_CLUSTER_3_FULL_NAME="gke_${MDB_GKE_PROJECT}_${MDB_CLUSTER_3_ZONE}_${MDB_CLUSTER_3}"
66-
67-
Set up GKE Clusters
68-
-------------------
69-
70-
Set up |gke| clusters:
71-
72-
.. include:: /includes/steps/multi-cluster-set-gke.rst
73-
74-
.. _multi-cluster-user-auth-clusters-ref:
75-
76-
Obtain User Authentication Credentials for Central and Member Clusters
77-
----------------------------------------------------------------------
78-
79-
Obtain user authentication credentials for the central and member |k8s|
80-
clusters and save the credentials. You will later use these credentials
81-
for running ``kubectl`` commands on these clusters.
82-
83-
Run the following commands:
84-
85-
.. code-block:: sh
86-
87-
gcloud container clusters get-credentials $MDB_CENTRAL_CLUSTER \
88-
--zone=$MDB_CENTRAL_CLUSTER_ZONE
89-
90-
gcloud container clusters get-credentials $MDB_CLUSTER_1 \
91-
--zone=$MDB_CLUSTER_1_ZONE
92-
93-
gcloud container clusters get-credentials $MDB_CLUSTER_2 \
94-
--zone=$MDB_CLUSTER_2_ZONE
95-
96-
gcloud container clusters get-credentials $MDB_CLUSTER_3 \
97-
--zone=$MDB_CLUSTER_3_ZONE
49+
export MDB_CENTRAL_CLUSTER_FULL_NAME="mdb-central"
50+
export MDB_CLUSTER_1_FULL_NAME="mdb-1"
51+
export MDB_CLUSTER_2_FULL_NAME="mdb-2"
52+
export MDB_CLUSTER_3_FULL_NAME="mdb-3"
9853

9954
.. _install_go:
10055
.. _install-helm:

‎source/multi-cluster-quick-start.txt

Lines changed: 71 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -42,6 +42,77 @@ create a |multi-cluster|.
4242

4343
`Deploying a MongoDB Replica Set across Multiple Kubernetes Clusters <https://www.youtube.com/watch?v=iPvoqxbFJd8>`__
4444

45+
.. _multi-cluster-qs-prerequisites:
46+
47+
Prerequisites
48+
-------------
49+
50+
Before you create a |multi-cluster| using the quick start,
51+
complete the following tasks:
52+
53+
Review the General Prerequisites
54+
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
55+
56+
Ensure you meet the general prerequisite before you proceed. To learn
57+
more, see :ref:`General Prerequisites <multi-cluster-prereqs>`.
58+
59+
Set Environment Variables and GKE Zones
60+
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
61+
62+
Set the environment variables with cluster names and the
63+
`available GKE zones <https://cloud.google.com/compute/docs/regions-zones#available>`__
64+
where you deploy the clusters, as in this example:
65+
66+
.. code-block:: sh
67+
68+
export MDB_GKE_PROJECT={GKE project name}
69+
70+
export MDB_CENTRAL_CLUSTER_ZONE="us-west1-a"
71+
72+
export MDB_CLUSTER_1_ZONE="us-west1-b"
73+
74+
export MDB_CLUSTER_2_ZONE="us-east1-b"
75+
76+
export MDB_CLUSTER_3_ZONE="us-central1-a"
77+
78+
export MDB_CENTRAL_CLUSTER_FULL_NAME="gke_${MDB_GKE_PROJECT}_${MDB_CENTRAL_CLUSTER_ZONE}_${MDB_CENTRAL_CLUSTER}"
79+
80+
export MDB_CLUSTER_1_FULL_NAME="gke_${MDB_GKE_PROJECT}_${MDB_CLUSTER_1_ZONE}_${MDB_CLUSTER_1}"
81+
export MDB_CLUSTER_2_FULL_NAME="gke_${MDB_GKE_PROJECT}_${MDB_CLUSTER_2_ZONE}_${MDB_CLUSTER_2}"
82+
export MDB_CLUSTER_3_FULL_NAME="gke_${MDB_GKE_PROJECT}_${MDB_CLUSTER_3_ZONE}_${MDB_CLUSTER_3}"
83+
84+
Set up GKE Clusters
85+
~~~~~~~~~~~~~~~~~~~
86+
87+
Set up |gke| clusters:
88+
89+
.. include:: /includes/steps/multi-cluster-set-gke.rst
90+
91+
.. _multi-cluster-user-auth-clusters-ref:
92+
93+
Obtain User Authentication Credentials for Central and Member Clusters
94+
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
95+
96+
Obtain user authentication credentials for the central and member |k8s|
97+
clusters and save the credentials. You will later use these credentials
98+
for running ``kubectl`` commands on these clusters.
99+
100+
Run the following commands:
101+
102+
.. code-block:: sh
103+
104+
gcloud container clusters get-credentials $MDB_CENTRAL_CLUSTER \
105+
--zone=$MDB_CENTRAL_CLUSTER_ZONE
106+
107+
gcloud container clusters get-credentials $MDB_CLUSTER_1 \
108+
--zone=$MDB_CLUSTER_1_ZONE
109+
110+
gcloud container clusters get-credentials $MDB_CLUSTER_2 \
111+
--zone=$MDB_CLUSTER_2_ZONE
112+
113+
gcloud container clusters get-credentials $MDB_CLUSTER_3 \
114+
--zone=$MDB_CLUSTER_3_ZONE
115+
45116
.. _multi-cluster-tls-overview:
46117

47118
Deploy a MongoDBMultiCluster Resource

0 commit comments

Comments
 (0)