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

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

前提条件と考慮事項

Kubernetes Operator をインストールする前に、インストールの計画を立ててください。

注意

このチュートリアルでは、Kubernetes に関するある程度の知識と、関連する Kubernetes ドキュメントにリンクすることを前提としています。 Kubernetes に詳しくない場合は、まずそのドキュメントを確認してください。

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

<version>プレースホルダーにデータを入力し、次のkubectlコマンドを実行して、選択したバージョンの Kubernetes Operator を Kubernetes クラスターに配置します。

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

MongoDB CRD を適用します。

<version>プレースホルダーにデータを入力し、次のkubectlコマンドを実行して、選択したバージョンの CRD を Kubernetes クラスターに配置します。

kubectl apply -f https://raw.githubusercontent.com/mongodb/mongodb-kubernetes/1.4.0/public/crds.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.4.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コントロール をインストールすると、次のことが可能になります。

このページを評価

項目一覧