AI エージェント向け: ドキュメントインデックスは https://www.mongodb.com/ja-jp/docs/llms.txt で利用できます。すべてのページの markdown バージョンは、いずれかの URL パスに .md を追加することで利用できます。

Kubernetes Operator 用のMongoDBドライバーのインストール

注意

このチュートリアルでは、Kubernetes に関する知識があることを前提としています。Kubernetes に詳しくない場合は、開始する前に、Kubernetes のドキュメントで Kubernetes オブジェクト と カスタム リソース を検討してください。Kubernetes Operator は、MongoDB Ops Manager と MongoDB の配置をカスタム リソースとして表します。これらは、他の Kubernetes オブジェクトと同様に kubectl で作成および管理されます。これらのカスタム リソースが互いにどのように関連しているかを知るには、「Kubernetes 演算子アーキテクチャの概要の MongoDB コントローラー」を参照してください。

前提条件

Kubernetes 演算子 をインストールする前に、次の前提条件を満たしてください。

1

使用可能な Kubernetes ソリューションを用意し、ハードウェア アーキテクチャのサポートを確認します。

Kubernetesソリューションが必要な場合は、 適切なソリューションの選択 に関するKubernetes のドキュメントを参照してください。サポートされているハードウェアアーキテクチャを確認します。

2

Kubernetes Operator 用のMongoDBリポジトリリポジトリをクローンし、現在のリリースのタグを確認します。

git clone https://github.com/mongodb/mongodb-kubernetes.gitcd mongodb-kubernetesgit checkout 1.15.0

注意

Helm を使用してKubernetes Operator をインストールできます。Helm をインストールする方法については、 Githubのドキュメントを参照してください。

3

Kubernetes配置用の名前空間を作成します。

デフォルトでは 、 Kubernetes演算子は mongodb名前空間を使用します。インストールを簡素化するために、次の kubernetes コマンドを使用して mongodb というラベルの付いた名前空間を作成することを検討してください。

kubectl create namespace mongodb

mongodb名前空間を使用しない場合は、名前空間に次のようにラベルを付けることができます。

kubectl create namespace <namespaceName>

Tip

Kubernetes Operator 配置のMongoDBドライバーのスコープの設定

4

オプション:実行中のOps Manager を用意します。

Operator MongoDB Ops Managerを使用して リソースを配置しない場合は、 クラスターの外部でKubernetesMongoDB Ops Manager Kubernetesを実行する必要があります。Operator を使用して にMongoDB Ops Manager リソースを配置する場合は、この前提条件をスキップします。KubernetesKubernetes

重要

MongoDB Ops Managerインストールでは、アクティブなNTPサービスを実行する必要があります。 MongoDB Ops Managerホストのクロックが同期しない場合、そのホストはKubernetes Operator と通信できなくなります。

MongoDB Ops Managerホストの NTP サービスを確認する方法については、 RHEL のドキュメントを参照してください。

Considerations

次の計画トピックを確認します。詳細については、Kubernetes Operator のインストールの計画を参照してください。

Kubernetes を使用したインストール

インストール手順は、環境の構成方法によって異なります。

注意

全体で同じ名前空間を使用する

デフォルトでは、Kubernetes 演算子はKubernetesクラスター内のすべてのリソースを名前空間 mongodbに配置します。mongodb-kubernetes.yamlのmetadata.namespaceのすべての値を編集することで、Kubernetes演算子リソースを別の名前空間に配置できます。また、同じファイル内のすべてのRoleBindingとClusterRoleBindingのsubjects[0].namespace値も更新する必要があります。この値を省略すると、バインディングはデフォルトのmongodb名前空間でServiceAccountを探しますが、見つけることができません。

---apiVersion: v1kind: ServiceAccountmetadata:  name: mongodb-kubernetes-operator  namespace: production
---apiVersion: rbac.authorization.k8s.io/v1kind: RoleBindingmetadata:  name: mongodb-kubernetes-operator  namespace: productionroleRef:  apiGroup: rbac.authorization.k8s.io  kind: Role  name: mongodb-kubernetes-operatorsubjects:  - kind: ServiceAccount    name: mongodb-kubernetes-operator    namespace: production
---apiVersion: apps/v1kind: Deploymentmetadata:  name: mongodb-kubernetes-operator  namespace: production
---# Example truncated---...
1

任意: Kubernetes 演算子 YAML をインストールする前にカスタマイズします。

Kubernetes Operator のインストール設定の詳細については、「 Operator kubernetes および oc インストール設定 」を参照してください。

注意

静的コンテナのパブリック プレビューを有効にしてセキュリティを向上および簡素化するには、静的コンテナ（パブリック プレビュー）を参照してください。この機能は、パブリック プレビュー段階で本番環境で使用することは推奨しません。詳しくは、「 プレビュー機能 」を参照してください。

2

MongoDB CRD を適用します。

次の kubectl コマンドを実行して、選択したバージョンの CRD を Kubernetes クラスターに配置します。

kubectl apply -f https://raw.githubusercontent.com/mongodb/mongodb-kubernetes/1.15.0/public/crds.yaml
3

MongoDB Kubernetes演算子をインストールします。

次の kubectl コマンドを実行して、選択したバージョンのKubernetes 演算子をKubernetesクラスターに配置します。

kubectl apply -f https://raw.githubusercontent.com/mongodb/mongodb-kubernetes/1.15.0/public/mongodb-kubernetes.yaml

OpenShift を使用したインストール

開始する前に、 Kubernetes Operator をOpenShiftに配置するときに、MANAGED_SECURITY_CONTEXT フラグが true に設定されていることを確認してください。この値は、values-openshift.YAMLファイルで事前定義されています。

インストール手順は、環境の構成方法によって異なります。

注意

全体で同じ名前空間を使用する

デフォルトでは、Kubernetes 演算子はKubernetesクラスター内のすべてのリソースを名前空間 mongodbに配置します。mongodb-kubernetes-openshift.yamlのmetadata.namespaceのすべての値を編集することで、Kubernetes演算子リソースを別の名前空間に配置できます。また、同じファイル内のすべてのRoleBindingとClusterRoleBindingのsubjects[0].namespace値も更新する必要があります。この値を省略すると、バインディングはデフォルトのmongodb名前空間でServiceAccountを探しますが、見つけることができません。

---apiVersion: v1kind: ServiceAccountmetadata:  name: mongodb-kubernetes-operator  namespace: production
---apiVersion: rbac.authorization.k8s.io/v1kind: RoleBindingmetadata:  name: mongodb-kubernetes-operator  namespace: productionroleRef:  apiGroup: rbac.authorization.k8s.io  kind: Role  name: mongodb-kubernetes-operatorsubjects:  - kind: ServiceAccount    name: mongodb-kubernetes-operator    namespace: production
---apiVersion: apps/v1kind: Deploymentmetadata:  name: mongodb-kubernetes-operator  namespace: production
---# Example truncated---...
1

Kubernetes Operator 用のMongoDBリポジトリリポジトリをクローンし、現在のリリースのタグを確認します。

次のgitコマンドを呼び出します。

git clone https://github.com/mongodb/mongodb-kubernetes.gitcd mongodb-kubernetesgit checkout 1.15.0
2

Kubernetes Operatorリポジトリ用のMongoDBコントロール をクローンしたディレクトリに移動します。

たとえば、ホームページ ディレクトリのリポジトリをクローンした場合は、次を実行します。

cd ~/mongodb-kubernetes
3

MongoDB配置用の CustomResourceDefinitions をインストールします。

次の OC コマンドを呼び出します。

oc apply -f crds.yaml
4

任意: Kubernetes 演算子 YAML をインストールする前にカスタマイズします。

Kubernetes Operator のインストール設定の詳細については、「 Operator kubernetes および oc インストール設定 」を参照してください。

注意

静的コンテナのパブリック プレビューを有効にしてセキュリティを向上および簡素化するには、静的コンテナ（パブリック プレビュー）を参照してください。この機能は、パブリック プレビュー段階で本番環境で使用することは推奨しません。詳しくは、「 プレビュー機能 」を参照してください。

5

インストール前に、 Kubernetes 演算子 YAML で ServiceAccount 定義に <openshift-pull-secret> を追加してください。

---apiVersion: v1kind: ServiceAccountmetadata:  name: enterprise-operator
  namespace: mongodb
imagePullSecrets: - name: <openshift-pull-secret>
---apiVersion: v1kind: ServiceAccountmetadata:  name: mongodb-kubernetes-appdb
  namespace: mongodb
imagePullSecrets: - name: <openshift-pull-secret>
---apiVersion: v1kind: ServiceAccountmetadata:  name: mongodb-kubernetes-database-pods
  namespace: mongodb
imagePullSecrets: - name: <openshift-pull-secret>

詳しくは、 Helm インストール設定のregistry.imagePullSecrets設定を参照してください。

6

次の OC コマンドを使用してKubernetes Operator をインストールします。

次の OC コマンドを呼び出します。

oc apply -f mongodb-kubernetes-openshift.yaml

インストールを確認します

Kubernetes Operator が正しくインストールされたことを確認するには、次のコマンドを実行し、出力を確認します。

kubectl describe deployments mongodb-kubernetes-operator -n <metadata.namespace>

デフォルトでは、配置はmongodb名前空間に存在します。 次のエラー メッセージが表示される場合は、正しい名前空間を使用していることを確認してください。

Error from server (NotFound): deployments.apps "mongodb-kubernetes-operator" not found

Kubernetes Operator のトラブルシューティングについては、「 Kubernetes Operator からのログの確認 」やその他のトラブルシューティング トピックを参照してください。

重要

Kubernetes Operator または名前空間を削除する必要がある場合は、まずMongoDB リソースを削除する必要があります。

次のステップ

Kubernetes Operator 用のMongoDBコントロール をインストールすると、次のことが可能になります。

このページを評価

項目一覧