전제 조건

지원되는 hardware 아키텍처 검토

지원되는 hardware 아키텍처를 참조하세요.

MongoDB Enterprise Kubernetes Operator 리포지토리 복제

MongoDB Enterprise Kubernetes Operator 리포지토리를 복제합니다.

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

환경 변수 설정

이 예제와 같이 클러스터를 배포하는 클러스터 이름으로 환경 변수를 설정합니다.

export MDB_CENTRAL_CLUSTER_FULL_NAME="mdb-central"
export MDB_CLUSTER_1_FULL_NAME="mdb-1"
export MDB_CLUSTER_2_FULL_NAME="mdb-2"
export MDB_CLUSTER_3_FULL_NAME="mdb-3"

Go 및 Helm 설치

다음 도구를 설치합니다.

1. Go 설치 v1.17 이상.

2. Helm 설치 .

Kubernetes 역할 및 역할 바인딩 이해

다중 Kubernetes 클러스터 MongoDB 배포를 사용하려면 특정 Kubernetes 역할 집합인 ClusterRoles 가있어야 합니다. , RoleBindings, ClusterRoleBindings 및 ServiceAccounts 다음 중 한 가지 방법으로 구성할 수 있습니다.

• MongoDB Plugin 을 사용하여 필요한 객체를 자동으로 생성하고 이를 멀티 Kubernetes 클러스터 MongoDB deployment 내의 적절한 클러스터에 적용하는 방법을 설명하는 멀티 Kubernetes 클러스터 빠른 시작 을 따르세요.

• Helm 사용 각 멤버 클러스터에 필요한 Kubernetes 역할 및 서비스 계정을 구성합니다.

  helm template --show-only \
    templates/database-roles.yaml \
    mongodb/enterprise-operator \
    --set namespace=mongodb | \
  kubectl apply -f - \
    --context=$MDB_CLUSTER_1_FULL_NAME \
    --namespace mongodb

  helm template --show-only \
    templates/database-roles.yaml \
    mongodb/enterprise-operator \
    --set namespace=mongodb | \
  kubectl apply -f - \
    --context=$MDB_CLUSTER_2_FULL_NAME \
    --namespace mongodb

  helm template --show-only \
    templates/database-roles.yaml \
    mongodb/enterprise-operator \
    --set namespace=mongodb | \
  kubectl apply -f - \
    --context=$MDB_CLUSTER_3_FULL_NAME \
    --namespace mongodb

• Kubernetes 객체 .yaml 파일을 수동으로 생성하고 kubectl apply 명령을 사용하여 다중 Kubernetes 클러스터 MongoDB 배포에 필요한 Kubernetes 역할 및 서비스 계정을 추가합니다. 이는 고도로 자동화된 특정 워크플로에 필요할 수 있습니다. MongoDB는 샘플 구성 파일을 제공합니다.

  네임스페이스의 하위 집합으로 범위가 지정된 사용자 지정 리소스의 경우:

  • 중앙 cluster의 역할, 역할 바인딩 및 서비스 계정

  • 구성원 cluster를 위한 역할, 역할 바인딩 및 서비스 계정

  cluster 전체 네임스페이스로 범위가 지정된 사용자 지정 리소스의 경우:

  • 중앙 클러스터를 위한 ClusterRoles, ClusterRoleBindings 및 ServiceAccounts

  • 멤버 cluster에 대한 clusterRoles, clusterRoleBindings 및 ServiceAccounts

  각 파일은 여러 리소스를 정의합니다. 배포를 지원하려면 다음 필드에서 자리 표시자 값을 바꿔야 합니다.

  • subjects.namespace 각 RoleBinding 또는 ClusterRoleBinding 리소스에서

  • metadata.namespace 각 ServiceAccount 리소스에서

  정의를 수정한 후 각 파일에 대해 다음 명령을 실행하여 적용합니다.

  kubectl apply -f <fileName>

배포서버 범위 설정

기본적으로 멀티 클러스터 Kubernetes Operator의 범위는 네임스페이스 로 지정됩니다. 에 설치합니다. Kubernetes Operator는 MongoDBMultiCluster Kubernetes Operator와 동일한 네임스페이스에 배포된 리소스를 조정합니다.

멀티 cluster 빠른 시작 의 일부로 MongoDB kubectl 플러그인 kubectl mongodb 을 실행하고 플러그인 설정을 수정하지 않는 경우 플러그인은 다음을 수행합니다.

• 멀티-Kubernetes cluster MongoDB deployment의 모든 멤버 클러스터를 포함하는 mongodb-enterprise-operator-member-list 이라는 기본 ConfigMap을 생성합니다. 이 이름은 하드 코딩되어 있으며 변경할 수 없습니다. 알려진 문제를 참조하세요.

• 서비스 계정 생성 , Roles, ClusterRoles, RoleBindings 및 ClusterRoleBindings 중앙 클러스터와 각 멤버 클러스터에 있습니다.

• 서비스 계정에 대한 올바른 권한을 적용합니다.

• 앞의 설정을 사용하여 다중 Kubernetes 클러스터 MongoDB deployment를 생성합니다.

Kubernetes Operator가 다중 Kubernetes cluster MongoDB 배포를 생성하면 Kubernetes Operator는 MongoDB mongodb 네임스페이스 에서 리소스를 감시하기 시작합니다. .

하위 집합 또는 모든 네임스페이스에 배포할 수 있는 올바른 권한으로 Kubernetes 연산자를 구성하려면 다음 명령을 실행하고 Kubernetes 연산자가 감시할 네임스페이스를 지정합니다.

kubectl mongodb multicluster setup \
  --central-cluster="${MDB_CENTRAL_CLUSTER_FULL_NAME}" \
  --member-clusters="${MDB_CLUSTER_1_FULL_NAME},${MDB_CLUSTER_2_FULL_NAME},${MDB_CLUSTER_3_FULL_NAME}" \
  --member-cluster-namespace="mongodb2" \
  --central-cluster-namespace="mongodb2" \
  --create-service-account-secrets \
  --cluster-scoped="true"

여러 또는 모든 네임스페이스 에 다중 Kubernetes cluster MongoDB deployment를 설치하는 경우 를 사용하여 Kubernetes Operator를 다음과 같이 구성할 수 있습니다.

• 여러 네임스페이스의 리소스 보기

• 모든 네임스페이스의 리소스 보기

WATCH_NAMESPACE: "$namespace1,$namespace2,$namespace3"

helm upgrade \
  --install \
  mongodb-enterprise-operator-multi-cluster \
  mongodb/enterprise-operator \
  --namespace mongodb \
  --set namespace=mongodb \
  --version <mongodb-kubernetes-operator-version>\
  --set operator.name=mongodb-enterprise-operator-multi-cluster \
  --set operator.createOperatorServiceAccount=false \
  --set operator.createResourcesServiceAccountsAndRoles=false \
  --set "multiCluster.clusters={$MDB_CLUSTER_1_FULL_NAME,$MDB_CLUSTER_2_FULL_NAME,$MDB_CLUSTER_3_FULL_NAME}" \
  --set operator.watchNamespace="$namespace1,$namespace2,$namespace3"

WATCH_NAMESPACE: "*"

helm upgrade \
  --install \
  mongodb-enterprise-operator-multi-cluster \
  mongodb/enterprise-operator \
  --namespace mongodb \
  --set namespace=mongodb \
  --version <mongodb-kubernetes-operator-version>\
  --set operator.name=mongodb-enterprise-operator-multi-cluster \
  --set operator.createOperatorServiceAccount=false \
  --set operator.createResourcesServiceAccountsAndRoles=false \
  --set "multiCluster.clusters={$MDB_CLUSTER_1_FULL_NAME,$MDB_CLUSTER_2_FULL_NAME,$MDB_CLUSTER_3_FULL_NAME}" \
  --set operator.watchNamespace="*"

외부 연결 계획: 서비스 메시를 사용해야 하나요?

서비스 메시를 사용하면 서로 다른 Kubernetes 클러스터에 배포된 복제본 세트 멤버 간의 클러스터 간 통신이 가능합니다. 서비스 메시를 사용하면 다중 Kubernetes 클러스터 MongoDB 배포 생성이 크게 간소화되며, 여러 Kubernetes 클러스터에 MongoDB를 배포하는 데 권장되는 방법입니다. 그러나 IT 조직에서 서비스 메시를 사용하지 않는 경우, 서비스 메시 없이도 다중 Kubernetes cluster MongoDB 배포에 복제본 세트를 배포할 수 있습니다.

환경에 따라 다음을 수행합니다.

• 서비스 메시를 사용할 수 있는 경우 Istio를 설치합니다.

• 서비스 메시를 사용할 수 없는 경우:

  1. Kubernetes Operator는 어떻게 연결을 설정하나요?섹션을 검토하세요.

  2. 외부 도메인 및 DNS 구역을 통해 외부 연결을 활성화합니다.

  3. 서비스메시 없이 멀티-Kubernetes cluster를 배포하세요.

cluster 간 연결 확인

이 절차의 단계에 따라 Kubernetes cluster 전체에서 서비스 FQDN에 연결할 수 있는지 확인합니다.

이 예제에서는 sample-service.yaml 에 정의된 샘플 애플리케이션을 배포합니다. 두 개의 Kubernetes 클러스터에 걸쳐 있습니다.

kubectl create --context="${CTX_CLUSTER_1}" namespace sample
kubectl create --context="${CTX_CLUSTER_2}" namespace sample

kubectl apply --context="${CTX_CLUSTER_1}" \
   -f sample-service.yaml \
   -l service=helloworld1 \
   -n sample
kubectl apply --context="${CTX_CLUSTER_2}" \
   -f sample-service.yaml \
   -l service=helloworld2 \
   -n sample

kubectl apply --context="${CTX_CLUSTER_1}" \
   -f sample-service.yaml \
   -l version=v1 \
   -n sample

kubectl get pod --context="${CTX_CLUSTER_1}" \
   -n sample \
   -l app=helloworld

kubectl apply --context="${CTX_CLUSTER_2}" \
   -f sample-service.yaml \
   -l version=v2 \
   -n sample

kubectl get pod --context="${CTX_CLUSTER_2}" \
   -n sample \
   -l app=helloworld

kubectl run  --context="${CTX_CLUSTER_1}" \
   -n sample \
   curl --image=radial/busyboxplus:curl \
   -i --tty \
   curl -sS helloworld2.sample:5000/hello

Hello version: v2, instance: helloworld-v2-758dd55874-6x4t8

kubectl run --context="${CTX_CLUSTER_2}" \
   -n sample \
   curl --image=radial/busyboxplus:curl \
   -i --tty \
   curl -sS helloworld1.sample:5000/hello

Hello version: v1, instance: helloworld-v1-758dd55874-6x4t8

Ops Manager 배포를 위한 요구 사항 검토

빠른 시작의 일환으로 중앙 클러스터에 Ops Manager 리소스를 배포합니다.

TLS 암호화 연결을 위한 준비

TLS 암호화를 사용하여 다중 Kubernetes 클러스터 MongoDB 배포를 보호하려는 경우, 다음 작업을 완료하여 내부 클러스터 인증을 활성화하고 멤버 클러스터 및 MongoDB Agent에 대한 TLS 인증서를 생성합니다.

kubectl --context $MDB_CENTRAL_CLUSTER_FULL_NAME \
--namespace=<metadata.namespace> \

curl https://raw.githubusercontent.com/mon  mongodb-enterprise-kubernetes/master/tools/multicluster/setup_tl  -o  setup_tls.sh

GitOps 또는 kubectl MongoDB 플러그인 선택

GitOps 환경에서 MongoDBMultiCluster 리소스 배포에 필요한 리소스 파일을 만들고 유지 관리하도록 선택할 수 있습니다.

GitOps 워크플로를 사용하는 경우 역할 기반 액세스 제어(RBAC) 를 자동으로 구성하는 kubectl mongodb 플러그인 은 사용할 수 없습니다. 그리고 중앙 클러스터가 해당 멤버 클러스터와 통신할 수 있도록 하는 kubeconfig 파일을 생성합니다. 대신 GitOps에 대한 리소스 구성 의 절차 kubeconfig 및 예제를 기반으로 RBAC 및 파일을 구성하기 위한 자체 자동화를 수동으로 구성하거나 빌드해야 합니다.

다음 필수 구성 요소 섹션에서는 GitOps를 사용하지 않는 경우 kubectl MongoDB 플러그인을 설치 하거나 사용하는 경우 GitOps 에 대한 리소스를 구성 하는 방법을 설명합니다.

kubectl MongoDB 플러그인 설치

kubectl mongodb 플러그인을 사용하여 다음을 수행합니다.

• 다중 Kubernetes cluster 배포 설정

• 자동 및 수동 재해 복구 실행

kubectl mongodb 플러그인을 설치하려면 다음을 수행합니다.

tar -zxvf kubectl-mongodb_<version>_darwin_amd64.tar.gz

mv kubectl-mongodb /usr/local/bin/kubectl-mongodb

kubectl mongodb multicluster setup
kubectl mongodb multicluster recover

GitOps를 위한 리소스 구성

GitOps 워크플로를 사용하는 경우 kubectl mongodb 플러그인 을 사용하여 역할 기반 액세스 제어(RBAC) 를 자동으로 구성할 수 없습니다. 또는 중앙 클러스터가 해당 멤버 클러스터와 통신할 수 있도록 하는 kubeconfig 파일을 사용할 수 있습니다. 대신 다음 리소스 파일을 수동으로 구성하고 적용하거나 아래 정보를 기반으로 자체 자동화를 빌드해야 합니다.

GitOps에 대해 RBAC 및 kubeconfig 를 구성하려면 다음을 수행합니다.

apiVersion: v1
kind: ConfigMap
data:
  cluster1: ""
  cluster2: ""
metadata:
  namespace: <namespace>
  name: mongodb-enterprise-operator-member-list
  labels:
    multi-cluster: "true"