Kubernetes 演算子のクイックスタート

項目一覧

前提条件

手順
Kubernetes リポジトリ用の MongoDB Helm Charts を Helm に追加します。
MongoDB Enterprise Kubernetes Operatorのインストール
kubectlをデフォルトで名前空間に設定します。
Kubernetes 演算子の構成
ConfigMap をコピーして保存します。
シークレットをコピーして保存します。
ConfigMap とシークレットを適用します。
MongoDBレプリカセットリソースを配置します。
データベースユーザーのパスワードを使用してシークレットを作成する
データベースユーザーを作成します。
任意: Cloud ManagerまたはMongoDB Ops Managerで新しく作成されたユーザーを表示します。
MongoDBレプリカセットに接続します。

重要

このセクションは、単一の Kubernetes クラスターの配置のみを対象としています。マルチ Kubernetes クラスターの MongoDB 配置については、マルチKubernetes クラスタークイックスタートを参照してください。

MongoDB Enterprise Kubernetes Operator は、 Kubernetes APIとツールを使用して、 Kubernetesクラスター内で実行中されているMongoDBクラスターを管理します。 Kubernetes Operator は、 MongoDB Cloud Managerまたは Ops Manager と連携します。このチュートリアルでは、 Kubernetes演算子を使用してMongoDB Cloud Managerに最初のMongoDBレプリカセットを配置して接続する方法を説明します。種類を使用してクラスターをすばやく設定できます。詳しくは、「種類」を参照してください。

前提条件

このチュートリアルには次のものが必要です。

実行中の MongoDB Cloud Manager クラスター。
実行中の Kubernetes クラスター。
サポートされているハードウェアアーキテクチャで実行されている Kubernetes ノード。
ローカルマシンにインストールされたMongoDB Shell。

手順

MongoDB Helm Charts for Kubernetesリポジトリを Helm に追加します。

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

MongoDB Enterprise Kubernetes Operatorのインストール

Helm とともにKubernetes Operator をインストールするには、リポジトリの手順を参照してください。

例

次のコマンドは、任意の--create-namespaceオプションを使用して、 mongodb名前空間に MongoDB Enterprise Kubernetes Operator をインストールします。デフォルトでは、Kubernetes Operator はdefault名前空間を使用します。

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

`kubectl`をデフォルトで名前空間に設定します。

まだ作成していない場合は、次のコマンドを実行して、作成した名前空間ですべてのkubectlコマンドを実行します。

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

Kubernetes 演算子の構成

UIGo の [Kubernetes 設定] ページにします。Cloud Manager
[ Create New API KeysまたはUse Existing API Keysをクリックします。
フォームを完了します。詳細については、「プログラムによる Cloud Manager へのアクセス」を参照してください。
[Generate Key and YAML] をクリックします。

ConfigMap をコピーして保存します。

生成されたconfig-map.yamlファイルをコピーして保存します。

例:

apiVersion: v1
kind: ConfigMap
metadata:
  name: my-project
  namespace: mongodb
data:
  baseUrl: https://cloud.mongodb.com
  projectName: my-project # this is an optional parameter
  orgId: 5ecd252f8c1a75033c74106c # this is a required parameter

詳しくは、パラメーターの説明を参照してください。

シークレットをコピーして保存します。

生成されたsecret.yamlファイルをコピーして保存します。

例:

apiVersion: v1
kind: Secret
metadata:
  name: organization-secret
  namespace: mongodb
stringData:
  user: <public_key>
  publicAPIKey: <private_key>

セキュリティ上の理由から、MongoDB Cloud Manager はこのファイルを 1 回だけ表示します。

ConfigMap とシークレットを適用します。

次のコマンドを実行します:

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

MongoDBレプリカセットリソースを配置します。

次のYAMLファイルをコピーして保存します。

apiVersion: mongodb.com/v1
kind: MongoDB
metadata:
  name: demo-mongodb-cluster-1
  namespace: mongodb
spec:
  members: 3
  version: 4.4.5-ent
  type: ReplicaSet
  security:
    authentication:
      enabled: true
      modes: ["SCRAM"]
  cloudManager:
    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

次のコマンドを実行します:
```
kubectl apply -f <replica-set-conf>.yaml
```

データベースユーザーのパスワードを使用してシークレットを作成する

クリアテキストパスワードまたは base64 でエンコードされたパスワードのどちらかを使用できます。プレーンテキストパスワードではstringData.passwordが使用され、Base64 でエンコードされたパスワードではdata.passwordが使用されます。

注意

次のパラメーターに値を指定します。詳しくは、パラメーターの説明を参照してください。

クリアテキストパスワードの場合は、次のYAMLファイルを作成して保存します。

apiVersion: v1
kind: Secret
metadata:
  name: mms-user-1-password
  # corresponds to user.spec.passwordSecretKeyRef.name
type: Opaque
stringData:
  password: <my-plain-text-password>
  # corresponds to user.spec.passwordSecretKeyRef.key

base64 でエンコードされたパスワードの場合は、次の YAML ファイルを作成して保存します。

apiVersion: v1
kind: Secret
metadata:
  name: mms-user-1-password
  # corresponds to user.spec.passwordSecretKeyRef.name
type: Opaque
data:
  password: <base-64-encoded-password>
  # corresponds to user.spec.passwordSecretKeyRef.key

データベースユーザーを作成します。

次のMongoDB ユーザーリソース仕様ファイルをコピーして保存します。

apiVersion: mongodb.com/v1
kind: MongoDBUser
metadata:
  name: mms-scram-user-1
spec:
  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 authenticaiton
  roles:
  - db: "admin"
    name: "clusterAdmin"
  - db: "admin"
    name: "userAdminAnyDatabase"
  - db: "admin"
    name: "readWrite"
  - db: "admin"
    name: "userAdminAnyDatabase"

次のコマンドを実行します:
```
kubectl apply -f <database-user-conf>.yaml
```

任意: Cloud ManagerまたはMongoDB Ops Managerで新しく作成されたユーザーを表示します。

新しく作成されたユーザーは、 Cloud ManagerまたはMongoDB Ops Managerで表示できます。

プロジェクトのDeploymentビューから、 Securityタブをクリックします。
[ MongoDB Users ] ネストされたタブをクリックします。

MongoDBレプリカセットに接続します。

Cloud Managerアプリケーションで次の手順を実行します。

左側のナビゲーションで [ Deployment ] をクリックします。
をクリックします接続する配置の。
[Connect to this instance] をクリックします。
配置に接続するには、ターミナルで接続コマンドを実行します。

戻る

MongoDB Enterprise Kubernetes 演算子

OpenShift チュートリアル

重要