Kubernetes Operator를 위한 빠른 시작

Kubernetes 용 MongoDB Helm Charts 리포지토리 Helm에 추가합니다.

helm repo add mongodb https://mongodb.github.io/helm-charts

Kubernetes Operator용 MongoDB 컨트롤러 설치

Helm을 사용하여 Kubernetes Operator를 설치하려면, 리포지토리의 지침을 참조하세요.

예시

다음 명령은 선택적 --create-namespace 옵션을 사용하여 mongodb 네임스페이스 에 Kubernetes Operator용 MongoDB 컨트롤러를 설치합니다. 기본값 으로 Kubernetes Operator는 default 네임스페이스 사용합니다.

helm install kubernetes-operator mongodb/mongodb-kubernetes --namespace mongodb --create-namespace

네임스페이스 를 기본값 으로 kubectl 구성합니다.

아직 실행하지 않았다면 다음 명령을 실행하여 생성한 네임스페이스에서 kubectl 명령을 모두 실행합니다.

kubectl config set-context $(kubectl config current-context) --namespace=mongodb

MongoDB Ops Manager 관리자 자격 증명 시크릿을 만듭합니다.

초기 MongoDB Ops Manager 관리자 사용자 자격 증명이 포함된 시크릿 을 만듭니다. Kubernetes 연산자는 MongoDB Ops Manager 리소스를 배포할 때 이 시크릿을 사용하여 첫 번째 관리자 사용자를 구성합니다.

다음 명령을 실행하여 자리 표시자 값을 원하는 자격 증명으로 대체합니다.

kubectl create secret generic ops-manager-admin-secret \  --from-literal=Username="<admin-email>" \  --from-literal=Password="<admin-password>" \  --from-literal=FirstName="<first-name>" \  --from-literal=LastName="<last-name>"

MongoDB Ops Manager 리소스를 배포합니다.

1. 다음 YAML 파일을 ops-manager.yaml(으)로 복사하고 저장합니다.

   apiVersion: mongodb.com/v1kind: MongoDBOpsManagermetadata:  name: ops-manager  namespace: mongodbspec:  replicas: 1  version: "8.0.0"  adminCredentials: ops-manager-admin-secret  externalConnectivity:    type: NodePort  configuration:    mms.ignoreInitialUiSetup: "true"    automation.versions.source: "mongodb"    mms.fromEmailAddr: admin@example.com    mms.replyToEmailAddr: admin@example.com    mms.adminEmailAddr: admin@example.com    mms.mail.transport: smtp    mms.mail.hostname: localhost    mms.mail.port: "25"  backup:    enabled: false  applicationDatabase:    topology: SingleCluster    members: 3    version: "8.0.0"

   자세히 알아보려면 MongoDB Ops Manager 리소스 사양을 참조하세요.

2. 다음 명령을 실행합니다:

   kubectl apply -f ops-manager.yaml

MongoDB Ops Manager 리소스가 실행 중 상태에 도달할 때까지 기다립니다.

Kubernetes Operator는 먼저 애플리케이션 데이터베이스 복제본 세트를 배포한 다음 Ops Manager 애플리케이션을 시작합니다. 이 과정에는 수분이 걸릴 수 있습니다.

다음 명령을 실행하여 리소스 상태를 추적합니다.

kubectl get om -o yaml -w

출력에 다음 단계가 표시될 때까지 기다립니다.

status:  applicationDatabase:    phase: Running  opsManager:    phase: Running

두 구성 요소 모두 Running에 도달하면 MongoDB Ops Manager URL을 조회합니다.

kubectl get om ops-manager -o jsonpath='{.status.opsManager.url}'

이 URL을 적어 두세요. 이 정보는 나중 단계의 ConfigMap에 필요합니다.

Ops Manager의 Kubernetes 연산자를 구성합니다.

MongoDB Ops Manager UI를 사용하여 ConfigMap 및 Secret을 생성하거나 수동으로 만들 수 있습니다.

먼저 Ops Manager 서비스 포트를 로컬 매신으로 포워딩하여 브라우저에서 UI에 액세스할 수 있도록 합니다.

kubectl port-forward svc/ops-manager-svc-ext 8080:8080

그러한 다음 브라우저에서 http://localhost:8080 을 열고 관리자 비밀에서 만든 자격 증명으로 로그인합니다.

MongoDB Ops Manager UI 사용:

1. Ops Manager UI에서 Kubernetes 설정 페이지로 이동합니다.

2. Create New API Keys 또는 Use Existing API Keys를 클릭합니다.

3. 양식을 작성합니다. 자세한 내용은 Kubernetes Operator에 대한 자격 증명 생성을 참조하세요.

4. Generate Key and YAML를 클릭합니다.

또는 다음 단계에서 ConfigMap 및 Secret을 수동으로 만들 수 있습니다.

ConfigMap을 만들고 저장합니다.

Ops Manager UI에서 ConfigMap을 생성한 경우 생성된 config-map.yaml 파일을 복사하여 저장합니다. 그렇지 않은 경우 다음 파일을 생성하여 저장합니다. status.opsManager.url에서 Ops Manager 인스턴스의 URL을 data.baseUrl 로 설정합니다.

예시:

apiVersion: v1kind: ConfigMapmetadata:  name: my-project  namespace: mongodbdata:  baseUrl: http://ops-manager-svc.mongodb.svc.cluster.local:8080  projectName: my-project  orgId: <your-org-id>

<your-org-id> 을 Ops Manager 조직 ID로 바꾸십시오. Ops Manager UI URL에서 이 값을 찾을 수 있습니다. http://<ops-manager-url>/v2#/org/<orgId>/projects.

자세한 내용은 파라미터 설명을 참조하십시오.

비밀을 만들고 저장합니다.

MongoDB Ops Manager UI에서 Secret을 생성한 경우, 생성된 secret.yaml 파일을 복사하여 저장하세요. 그렇지 않으면 MongoDB Ops Manager 조직의 API 키가 포함된 secret 을 생성하세요.

예시:

apiVersion: v1kind: Secretmetadata:  name: organization-secret  namespace: mongodbstringData:  publicKey: <public_key>  privateKey: <private_key>

Programmatic API 키를 만들려면, Kubernetes 연산자용 자격 증명 만들기를 참조하세요.

컨피그맵과 시크릿을 적용합니다.

다음 명령을 실행합니다:

kubectl apply -f secret.yaml -f config-map.yaml

MongoDB 복제본 세트 리소스 배포.

1. 다음 YAML 파일을 복사하고 저장합니다.

   apiVersion: mongodb.com/v1kind: MongoDBmetadata:  name: demo-mongodb-cluster-1  namespace: mongodbspec:  members: 3  version: 8.0.0  type: ReplicaSet  security:    authentication:      enabled: true      modes: ["SCRAM"]  opsManager:    configMapRef:      name: my-project  credentials: organization-secret  persistent: true  podSpec:    podTemplate:      spec:       containers:        - name: mongodb-enterprise-database          resources:            limits:              cpu: 2              memory: 1.5G            requests:              cpu: 1              memory: 1G            persistence:              single:                storage: 10Gi

2. 다음 명령을 실행합니다:

   kubectl apply -f <replica-set-conf>.yaml

데이터베이스 사용자 비밀번호로 비밀번호를 만듭니다.

MongoDB 데이터베이스 사용자에 대한 비밀번호를 선택하고 비밀에 저장합니다. 이 비밀번호는 원하는 값이 될 수 있습니다. 다음 단계에서 데이터베이스 사용자를 만들 때 이 비밀을 참조합니다.

클리어 텍스트(사용 stringData) 또는 Base64인코딩 된 값(사용 data)으로 비밀번호를 저장할 수 있습니다.

일반 텍스트 비밀번호의 경우 다음 YAML 파일을 만들어 저장합니다:

apiVersion: v1kind: Secretmetadata:  name: mms-user-1-password  # corresponds to user.spec.passwordSecretKeyRef.nametype: OpaquestringData:  password: <my-plain-text-password>  # corresponds to user.spec.passwordSecretKeyRef.key

Base64로 인코딩된 비밀번호의 경우 다음 YAML 파일을 만들어 저장합니다:

apiVersion: v1kind: Secretmetadata:  name: mms-user-1-password  # corresponds to user.spec.passwordSecretKeyRef.nametype: Opaquedata:  password: <base-64-encoded-password>  # corresponds to user.spec.passwordSecretKeyRef.key

자리 표시자를 선택한 비밀번호로 바꾸십시오. 자세한 내용은 SCRAM 인증을 사용하여 데이터베이스 사용자 관리를 참조하십시오.

데이터베이스 사용자를 생성합니다.

1. 다음 MongoDB 사용자 리소스 사양 파일을 복사하여 저장합니다.

   apiVersion: mongodb.com/v1kind: MongoDBUsermetadata:  name: mms-scram-user-1spec:  passwordSecretKeyRef:    name: mms-user-1-password    # Match to metadata.name of the User Secret    key: password  username: "mms-scram-user-1"  db: "admin" #  mongodbResourceRef:    name: "demo-mongodb-cluster-1"    # Match to MongoDB resource using authentication  roles:  - db: "admin"    name: "clusterAdmin"  - db: "admin"    name: "userAdminAnyDatabase"  - db: "admin"    name: "readWrite"

2. 다음 명령을 실행합니다:

   kubectl apply -f <database-user-conf>.yaml

선택 사항: Cloud Manager 또는 Ops Manager에서 새로 생성된 사용자를 확인합니다.

Cloud Manager 또는 Ops Manager에서 새로 생성된 사용자를 볼 수 있습니다.

1. 프로젝트의 Deployment 보기에서 Security 탭을 클릭합니다.

2. 중첩된 MongoDB Users 탭을 클릭합니다.

MongoDB 복제본 세트에 연결합니다.

MongoDB Ops Manager 애플리케이션에서 다음 단계를 수행합니다.

1. 왼쪽 탐색에서 Deployment을 클릭합니다.

2. 연결하려는 배포서버의 을 클릭합니다.

3. Connect to this instance를 클릭합니다.

4. 터미널에서 연결 명령을 실행하여 배포에 연결합니다.