GKE クラスターの配置

MongoDB Enterprise Kubernetes演算子は非推奨です。新しい MongoDB Controls for Kubernetes Operator が、 MongoDB Enterprise Kubernetes Operator に置き換わります。Kubernetes Operator 用のドライバーの最初のバージョンは、 Enterprise Kubernetes Operatorの v1.33 と機能的に同等です。この変更の詳細と、新しい演算子への移行に関するガイダンスについては、最初の新しいバージョンのリリースノートを参照してください。MongoDB Enterprise Kubernetes Operator の今後のリリースは予定されません。各バージョンは、既存の 1 年間のサポートポリシーに従ってサポートが終了します。継続的なサポートについては、 Kubernetes Operator 用のコントロールに移行してください。

Kubernetesはベンダーに固有ではありません。ただし、マルチクラスターKubernetes Operator実装のすべての要素を配置するための明示的かつ完全な手順を提供するため、このセクションでは具体的には、複数のKubernetesクラスターを GCPに配置するプロセスについて説明します。

前提条件

始める前に、次のアクションを実行してください。

GCPアカウントの作成。
GCPプロジェクトを準備し、GKE（Google Kubernetes Engine）クラスターの作成に使用できるようにします。
GCP CLI をインストールします。
gcloud auth login コマンドで認証します。
必要に応じてを更新し、次の env_variables.shファイルで定義されている環境変数を設定します。

1 # GCP project name - this is the only parameter that is mandatory to change here
2 export MDB_GKE_PROJECT="${MDB_GKE_PROJECT:="### Set your GKE project name here ###"}"
3 
4 # Adjust the values for each Kubernetes cluster in your deployment.
5 # The deployment script references the following variables to get values for each cluster.
6 export K8S_CLUSTER_0="k8s-mdb-0${K8S_CLUSTER_SUFFIX:-""}"
7 export K8S_CLUSTER_0_ZONE="europe-central2-a"
8 export K8S_CLUSTER_0_NUMBER_OF_NODES=3
9 export K8S_CLUSTER_0_MACHINE_TYPE="e2-standard-4"
10 export K8S_CLUSTER_0_CONTEXT_NAME="gke_${MDB_GKE_PROJECT}_${K8S_CLUSTER_0_ZONE}_${K8S_CLUSTER_0}"
11 
12 export K8S_CLUSTER_1="k8s-mdb-1${K8S_CLUSTER_SUFFIX:-""}"
13 export K8S_CLUSTER_1_ZONE="europe-central2-b"
14 export K8S_CLUSTER_1_NUMBER_OF_NODES=3
15 export K8S_CLUSTER_1_MACHINE_TYPE="e2-standard-4"
16 export K8S_CLUSTER_1_CONTEXT_NAME="gke_${MDB_GKE_PROJECT}_${K8S_CLUSTER_1_ZONE}_${K8S_CLUSTER_1}"
17 
18 export K8S_CLUSTER_2="k8s-mdb-2${K8S_CLUSTER_SUFFIX:-""}"
19 export K8S_CLUSTER_2_ZONE="europe-central2-c"
20 export K8S_CLUSTER_2_NUMBER_OF_NODES=1
21 export K8S_CLUSTER_2_MACHINE_TYPE="e2-standard-4"
22 export K8S_CLUSTER_2_CONTEXT_NAME="gke_${MDB_GKE_PROJECT}_${K8S_CLUSTER_2_ZONE}_${K8S_CLUSTER_2}"
23 
24 # Comment out the following line so that the script does not create preemptible nodes.
25 # DO NOT USE preemptible nodes in production.
26 export GKE_SPOT_INSTANCES_SWITCH="--preemptible"

ソースコード

含まれているすべてのソースコードはMongoDB Kubernetes Operatorリポジトリにあります。

手順

デフォルトのGCPプロジェクトを設定します。

1 gcloud config set project "${MDB_GKE_PROJECT}"

Kubernetes クラスターを作成します。

3 つのGKE（Google Kubernetes Engine）クラスターを作成します。Kubernetes Operator はこれらのクラスターの 1 つに配置され、 MongoDBカスタムリソースはすべてのクラスターに配置され、 Kubernetes Operator によって管理されます。

1 gcloud container clusters create "${K8S_CLUSTER_0}" \
2       --zone="${K8S_CLUSTER_0_ZONE}" \
3       --num-nodes="${K8S_CLUSTER_0_NUMBER_OF_NODES}" \
4       --machine-type "${K8S_CLUSTER_0_MACHINE_TYPE}" \
5       --tags=mongodb \
6       "${GKE_SPOT_INSTANCES_SWITCH:-""}"

1 gcloud container clusters create "${K8S_CLUSTER_1}" \
2       --zone="${K8S_CLUSTER_1_ZONE}" \
3       --num-nodes="${K8S_CLUSTER_1_NUMBER_OF_NODES}" \
4       --machine-type "${K8S_CLUSTER_1_MACHINE_TYPE}" \
5       --tags=mongodb \
6       "${GKE_SPOT_INSTANCES_SWITCH:-""}"

1 gcloud container clusters create "${K8S_CLUSTER_2}" \
2       --zone="${K8S_CLUSTER_2_ZONE}" \
3       --num-nodes="${K8S_CLUSTER_2_NUMBER_OF_NODES}" \
4       --machine-type "${K8S_CLUSTER_2_MACHINE_TYPE}" \
5       --tags=mongodb \
6       "${GKE_SPOT_INSTANCES_SWITCH:-""}"

認証情報を `kubeconfig`ファイルに保存します。

認証情報を取得し、コンテキストを現在の kubeconfigファイルに保存します。デフォルトでは、このファイルは~/.kube/configディレクトリにあり、$KUBECONFIG 環境変数によって参照されます。

1 gcloud container clusters get-credentials "${K8S_CLUSTER_0}" --zone="${K8S_CLUSTER_0_ZONE}"
2 gcloud container clusters get-credentials "${K8S_CLUSTER_1}" --zone="${K8S_CLUSTER_1_ZONE}"
3 gcloud container clusters get-credentials "${K8S_CLUSTER_2}" --zone="${K8S_CLUSTER_2_ZONE}"

すべてのkubectlコマンドは、次の変数を使用してこれらのコンテキストを参照します。

$K8S_CLUSTER_0_CONTEXT_NAME
$K8S_CLUSTER_1_CONTEXT_NAME
$K8S_CLUSTER_2_CONTEXT_NAME

`kubectl` がKubernetesクラスターにアクセスできることを確認します。

1 echo "Nodes in cluster ${K8S_CLUSTER_0_CONTEXT_NAME}"
2 kubectl --context "${K8S_CLUSTER_0_CONTEXT_NAME}" get nodes
3 echo; echo "Nodes in cluster ${K8S_CLUSTER_1_CONTEXT_NAME}"
4 kubectl --context "${K8S_CLUSTER_1_CONTEXT_NAME}" get nodes
5 echo; echo "Nodes in cluster ${K8S_CLUSTER_2_CONTEXT_NAME}"
6 kubectl --context "${K8S_CLUSTER_2_CONTEXT_NAME}" get nodes

1 Nodes in cluster gke_scratch-kubernetes-team_europe-central2-a_k8s-mdb-0-67d0389d75b70a0007e5894a
2 NAME                                                  STATUS   ROLES    AGE   VERSION
3 gke-k8s-mdb-0-67d0389d75-default-pool-bd2d7e42-99mr   Ready    <none>   30s   v1.31.5-gke.1233000
4 gke-k8s-mdb-0-67d0389d75-default-pool-bd2d7e42-d3ql   Ready    <none>   30s   v1.31.5-gke.1233000
5 gke-k8s-mdb-0-67d0389d75-default-pool-bd2d7e42-stxx   Ready    <none>   29s   v1.31.5-gke.1233000
6 
7 Nodes in cluster gke_scratch-kubernetes-team_europe-central2-b_k8s-mdb-1-67d0389d75b70a0007e5894a
8 NAME                                                  STATUS   ROLES    AGE   VERSION
9 gke-k8s-mdb-1-67d0389d75-default-pool-c4129558-10n1   Ready    <none>   76s   v1.31.5-gke.1233000
10 gke-k8s-mdb-1-67d0389d75-default-pool-c4129558-gdrg   Ready    <none>   76s   v1.31.5-gke.1233000
11 gke-k8s-mdb-1-67d0389d75-default-pool-c4129558-jbgt   Ready    <none>   76s   v1.31.5-gke.1233000
12 
13 Nodes in cluster gke_scratch-kubernetes-team_europe-central2-c_k8s-mdb-2-67d0389d75b70a0007e5894a
14 NAME                                                  STATUS   ROLES    AGE   VERSION
15 gke-k8s-mdb-2-67d0389d75-default-pool-0f8822ab-f617   Ready    <none>   56s   v1.31.5-gke.1233000

戻る

サービスメッシュのないマルチクラスターアーキテクチャ

外部 DNS

1	# GCP project name - this is the only parameter that is mandatory to change here
2	export MDB_GKE_PROJECT="${MDB_GKE_PROJECT:="### Set your GKE project name here ###"}"
3
4	# Adjust the values for each Kubernetes cluster in your deployment.
5	# The deployment script references the following variables to get values for each cluster.
6	export K8S_CLUSTER_0="k8s-mdb-0${K8S_CLUSTER_SUFFIX:-""}"
7	export K8S_CLUSTER_0_ZONE="europe-central2-a"
8	export K8S_CLUSTER_0_NUMBER_OF_NODES=3
9	export K8S_CLUSTER_0_MACHINE_TYPE="e2-standard-4"
10	export K8S_CLUSTER_0_CONTEXT_NAME="gke_${MDB_GKE_PROJECT}_${K8S_CLUSTER_0_ZONE}_${K8S_CLUSTER_0}"
11
12	export K8S_CLUSTER_1="k8s-mdb-1${K8S_CLUSTER_SUFFIX:-""}"
13	export K8S_CLUSTER_1_ZONE="europe-central2-b"
14	export K8S_CLUSTER_1_NUMBER_OF_NODES=3
15	export K8S_CLUSTER_1_MACHINE_TYPE="e2-standard-4"
16	export K8S_CLUSTER_1_CONTEXT_NAME="gke_${MDB_GKE_PROJECT}_${K8S_CLUSTER_1_ZONE}_${K8S_CLUSTER_1}"
17
18	export K8S_CLUSTER_2="k8s-mdb-2${K8S_CLUSTER_SUFFIX:-""}"
19	export K8S_CLUSTER_2_ZONE="europe-central2-c"
20	export K8S_CLUSTER_2_NUMBER_OF_NODES=1
21	export K8S_CLUSTER_2_MACHINE_TYPE="e2-standard-4"
22	export K8S_CLUSTER_2_CONTEXT_NAME="gke_${MDB_GKE_PROJECT}_${K8S_CLUSTER_2_ZONE}_${K8S_CLUSTER_2}"
23
24	# Comment out the following line so that the script does not create preemptible nodes.
25	# DO NOT USE preemptible nodes in production.
26	export GKE_SPOT_INSTANCES_SWITCH="--preemptible"

1	gcloud container clusters create "${K8S_CLUSTER_0}" \
2	--zone="${K8S_CLUSTER_0_ZONE}" \
3	--num-nodes="${K8S_CLUSTER_0_NUMBER_OF_NODES}" \
4	--machine-type "${K8S_CLUSTER_0_MACHINE_TYPE}" \
5	--tags=mongodb \
6	"${GKE_SPOT_INSTANCES_SWITCH:-""}"

1	gcloud container clusters create "${K8S_CLUSTER_1}" \
2	--zone="${K8S_CLUSTER_1_ZONE}" \
3	--num-nodes="${K8S_CLUSTER_1_NUMBER_OF_NODES}" \
4	--machine-type "${K8S_CLUSTER_1_MACHINE_TYPE}" \
5	--tags=mongodb \
6	"${GKE_SPOT_INSTANCES_SWITCH:-""}"

1	gcloud container clusters create "${K8S_CLUSTER_2}" \
2	--zone="${K8S_CLUSTER_2_ZONE}" \
3	--num-nodes="${K8S_CLUSTER_2_NUMBER_OF_NODES}" \
4	--machine-type "${K8S_CLUSTER_2_MACHINE_TYPE}" \
5	--tags=mongodb \
6	"${GKE_SPOT_INSTANCES_SWITCH:-""}"

1	gcloud container clusters get-credentials "${K8S_CLUSTER_0}" --zone="${K8S_CLUSTER_0_ZONE}"
2	gcloud container clusters get-credentials "${K8S_CLUSTER_1}" --zone="${K8S_CLUSTER_1_ZONE}"
3	gcloud container clusters get-credentials "${K8S_CLUSTER_2}" --zone="${K8S_CLUSTER_2_ZONE}"

1	echo "Nodes in cluster ${K8S_CLUSTER_0_CONTEXT_NAME}"
2	kubectl --context "${K8S_CLUSTER_0_CONTEXT_NAME}" get nodes
3	echo; echo "Nodes in cluster ${K8S_CLUSTER_1_CONTEXT_NAME}"
4	kubectl --context "${K8S_CLUSTER_1_CONTEXT_NAME}" get nodes
5	echo; echo "Nodes in cluster ${K8S_CLUSTER_2_CONTEXT_NAME}"
6	kubectl --context "${K8S_CLUSTER_2_CONTEXT_NAME}" get nodes

1	Nodes in cluster gke_scratch-kubernetes-team_europe-central2-a_k8s-mdb-0-67d0389d75b70a0007e5894a
2	NAME STATUS ROLES AGE VERSION
3	gke-k8s-mdb-0-67d0389d75-default-pool-bd2d7e42-99mr Ready <none> 30s v1.31.5-gke.1233000
4	gke-k8s-mdb-0-67d0389d75-default-pool-bd2d7e42-d3ql Ready <none> 30s v1.31.5-gke.1233000
5	gke-k8s-mdb-0-67d0389d75-default-pool-bd2d7e42-stxx Ready <none> 29s v1.31.5-gke.1233000
6
7	Nodes in cluster gke_scratch-kubernetes-team_europe-central2-b_k8s-mdb-1-67d0389d75b70a0007e5894a
8	NAME STATUS ROLES AGE VERSION
9	gke-k8s-mdb-1-67d0389d75-default-pool-c4129558-10n1 Ready <none> 76s v1.31.5-gke.1233000
10	gke-k8s-mdb-1-67d0389d75-default-pool-c4129558-gdrg Ready <none> 76s v1.31.5-gke.1233000
11	gke-k8s-mdb-1-67d0389d75-default-pool-c4129558-jbgt Ready <none> 76s v1.31.5-gke.1233000
12
13	Nodes in cluster gke_scratch-kubernetes-team_europe-central2-c_k8s-mdb-2-67d0389d75b70a0007e5894a
14	NAME STATUS ROLES AGE VERSION
15	gke-k8s-mdb-2-67d0389d75-default-pool-0f8822ab-f617 Ready <none> 56s v1.31.5-gke.1233000