전제 조건

지원되는 hardware 아키텍처 검토

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

MongoDB Enterprise Kubernetes Operator 리포지토리 복제

MongoDB 엔터프라이즈 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 deployment 를 사용하려면 특정 Kubernetes 역할 설정하다 인 ClusterRoles 가 있어야합니다. , RoleBindings, ClusterRoleBindings 및 ServiceAccounts 다음 중 한 가지 방법으로 구성할 수 있습니다.

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

• 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 deployment 에 필요한 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는 Kubernetes Operator와 동일한 네임스페이스 에 배포된 MongoDBMultiCluster 리소스 를 조정합니다.

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

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

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

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

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

Kubernetes Operator가 다중 Kubernetes 클러스터 MongoDB deployment 를 생성하면 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 클러스터 MongoDB deployment 에 복제본 세트 를 배포 할 수 있습니다.

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

• 서비스 메시를 사용할 수 있는 경우 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 배포를 위한 요구 사항 검토

빠른 시작의 일환으로 MongoDB 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에 대한 리소스 구성의 절차 및 예제를 기반으로 RBAC 및 kubeconfig 파일을 구성하기 위한 자체 자동화 를 수동으로 구성하거나 빌드 해야 합니다.

다음 필수 구성 요소 섹션에서는 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"