AI エージェント向け: ドキュメントインデックスは https://www.mongodb.com/ja-jp/docs/llms.txt で利用できます。すべてのページの markdown バージョンは、いずれかの URL パスに .md を追加することで利用できます。
Make the MongoDB docs better! We value your opinion. Share your feedback for a chance to win $100.
MongoDB Branding Shape
Click here >
Docs Menu
Docs Home
/ /
インストールのプラン
Docs Home
/ /
インストール
/
インストールのプラン
Docs Home
/
管理
/
Kubernetes 演算子のコントローラー
/
インストール
/
インストールのプラン

Kubernetes Operator 配置の範囲の設定

Kubernetes Operator をインストールする前に、 Kubernetes Operator 配置のスコープを設定できます。スコープは、Ops Manager とMongoDBリソースの配置を選択した名前空間によって異なります。

Kubernetes Operator の配置スコープ

次のいずれかのスコープを設定できます。

演算子はリソースと同じ単一の名前空間を使用する

Kubernetes Operator のスコープを設定して、リソースと同じ名前空間を使用することができます。この場合、 Kubernetes Operator は同じ名前空間内の Ops Manager とMongoDBリソースを監視します。

Kubernetes Operator をインストールすると、デフォルトの名前空間が使用されます。

演算子は名前空間のサブセットを使用します

Kubernetes Operator のスコープを設定して、 Kubernetes Operator リソースで使用される名前空間空間とは異なる 1 つ以上の名前空間を使用することができます。この場合、 Kubernetes Operator は、指定された名前空間のサブセット内の Ops Manager とMongoDBリソースを監視します。

このスコープで Kubernetes Operator インスタンスをインストールするには、オペレーター.watchNamespace とともにhelmを使用します。 許可されます。

名前空間のサブセットを監視すると、単一の Kubernetes Operator インスタンスが異なるクラスター リソース タイプを監視する配置に役立ちます。 たとえば、Kubernetes Operator を構成して、名前空間の 1 つのサブセット内のMongoDBリソースを監視し、名前空間の別のサブセット内のMongoDBMultiClusterリソースを監視するようにできます。 リソース調整中に競合状態を回避するには、Kubernetes Operator で監視するカスタム リソース タイプごとに、スコープを名前空間の個別のサブセットに設定していることを確認してください。

helmの関連するインストール手順に従いますが、オペレーター.watchNamespace に 1 つ以上の名前空間を指定します。 Kubernetes Operator が監視するパラメーター。

# Watch one namespace
helm install mongodb-kubernetes-operator mongodb/mongodb-kubernetes \
   --set operator.watchNamespace='namespace-to-watch' <...>
# Watch both namespace-a and namespace-b
helm install mongodb-kubernetes-operator mongodb/mongodb-kubernetes \
   --set operator.watchNamespace="namespace-a\,namespace-b"
# Operator with name `mongodb-kubernetes-operator-qa-envs` will
# watch ns-dev, ns-qa and ns-uat namespaces
helm install mongodb-kubernetes-operator-qa-envs mongodb/mongodb-kubernetes \
   --set operator.watchNamespace="ns-dev\,ns-qa\,ns-uat"
# Operator with name `mongodb-kubernetes-operator-staging` will
# watch ns-staging and ns-pre-prod
helm install mongodb-kubernetes-operator-staging mongodb/mongodb-kubernetes --set operator.watchNamespace="ns-staging\,ns-pre-prod"

Kubernetes Operator をインストールして、Kubernetes Operator が配置されている名前空間以外の 1 つ以上の名前空間のリソースを監視する場合、以下のようにします。

  1. 次のリソースを作成します。

  2. インストール中に適用するデフォルトの構成ファイルに ClusterRole と ClusterRoleBinding を含めます。

  3. ローカルKubernetes ServiceAccounts を作成します。

    各名前空間に対して、次のローカルKubernetes ServiceAccount の一部またはすべてを作成します。

    • 名前空間に MongoDB インスタンスを配置する場合は、 mongodb-kubernetes-database-podsを使用します。

    • 名前空間にMongoDB Ops Managerを配置する場合は、mongodb-kubernetes-appdb と mongodb-kubernetes-ops-manager を使用します。

次の例は、ClusterRole と ClusterRoleBinding がクラスター内でどのように連携するかを示しています。

mongodb名前空間に ServiceAccount を作成し、この名前空間に Kubernetes Operator をインストールするとします。 Kubernetes Operator はこの ServiceAccount を使用します。

名前空間ns1とns2を監視するように Kubernetes Operator のスコープを設定するには次の手順に従います。

  1. クラスター管理者特権を取得する。

  2. これらの特権を使用して、クラスター全体で名前空間以外の ClusterRole を作成します。

  3. 次の 3 つの名前空間で ClusterRoleBinding を作成します:mongodb 、 、ns1 ns2。このClusterRoleBindingは、ClusterRoleをmongodb名前空間の ServiceAccount にバインドします。clusterRoleBinding を使用すると、mongodb名前空間に配置されたKubernetes Operator が、ターゲット名前空間の clusterRole に記述されているリソース（つまり、mongodb、ns1、ns2 にあるリソースにアクセスできるようになります。

Operator.watchNamespace も参照してください。

演算子はクラスター全体のスコープを使用します

Kubernetes Operator のスコープをKubernetesクラスターに設定できます。この場合、 Kubernetes Operator はKubernetesクラスター内のすべての名前空間の Ops Manager とMongoDBリソースを監視します。

重要

Kubernetes クラスターごとに、クラスター全体のスコープを持つ Kubernetes Operator のインスタンスは 1 つだけ配置できます。

Kubernetes Operator のクラスター全体のスコープを設定するには、ご希望のインストール メソッドの手順に従います。

  1. Kubernetes Operator GitHubリポジトリのMongoDBコントロール からの mongodb-kubernetes.YAMLサンプルYAMLファイルを使用します。

  2. mongodb-kubernetes.YAML の spec.template.spec.containers.name.env.name:WATCH_NAMESPACE を "*" に設定します。YAMLファイル内のアスタリスク（*）の前後に二重引用符（"）を含める必要があります。

    WATCH_NAMESPACE: "*"

  3. In mongodb-kubernetes.yaml, change:

    kind:  Role
    apiVersion: rbac.authorization.k8s.io/v1
    metadata:
     name: mongodb-kubernetes-operator

    から:

    kind: ClusterRole
    apiVersion: rbac.authorization.k8s.io/v1
    metadata:
     name: mongodb-kubernetes-operator

  4. 先ほど変更したClusterRoleに次のコードを追加します。

    - apiGroups:
      - ""
      resources:
      - namespaces
      verbs:
      - list
      - watch

  5. In mongodb-kubernetes.yaml, change:

    kind:  RoleBinding
    apiVersion: rbac.authorization.k8s.io/v1
    metadata:
     name: mongodb-kubernetes-operator
     namespace: mongodb
    roleRef:
     apiGroup: rbac.authorization.k8s.io
     kind: Role
     name: mongodb-kubernetes-operator
    subjects:
     - kind: ServiceAccount
     name: mongodb-kubernetes-operator
     namespace: mongodb

    から:

    kind:  ClusterRoleBinding
    apiVersion: rbac.authorization.k8s.io/v1
    metadata:
     name: mongodb-kubernetes-operator
     namespace: mongodb
    roleRef:
     apiGroup: rbac.authorization.k8s.io
     kind: ClusterRole
     name: mongodb-kubernetes-operator
    subjects:
     - kind: ServiceAccount
     name: mongodb-kubernetes-operator
     namespace: mongodb

  6. mongodb-kubernetes.yamlファイルで、 <namespace>の値を、Kubernetes Operator でリソースを配置してYAMLファイルを適用する名前空間に変更します。

    1---
    2kind: ServiceAccount
    3apiVersion: v1
    4metadata:
    5  name: mongodb-kubernetes-appdb
    6  namespace: <namespace>
    7---
    8kind: ServiceAccount
    9apiVersion: v1
    10metadata:
    11  name: mongodb-kubernetes-database-pods
    12  namespace: <namespace>
    13---
    14kind: ServiceAccount
    15apiVersion: v1
    16metadata:
    17  name: mongodb-kubernetes-ops-manager
    18  namespace: <namespace>
    19---
    20kind: Role
    21apiVersion: rbac.authorization.k8s.io/v1
    22metadata:
    23  name: mongodb-kubernetes-appdb
    24  namespace: <namespace>
    25rules:
    26  - apiGroups:
    27      - ""
    28    resources:
    29      - secrets
    30    verbs:
    31      - get
    32  - apiGroups:
    33      - ""
    34    resources:
    35      - pods
    36    verbs:
    37      - patch
    38---
    39kind: RoleBinding
    40apiVersion: rbac.authorization.k8s.io/v1
    41metadata:
    42  name: mongodb-kubernetes-appdb
    43  namespace: <namespace>
    44roleRef:
    45  apiGroup: rbac.authorization.k8s.io
    46  kind: Role
    47  name: mongodb-kubernetes-appdb
    48subjects:
    49  - kind: ServiceAccount
    50    name: mongodb-kubernetes-appdb
    51    namespace: <namespace>
    52...

  7. ローカルKubernetesサービス アカウント の作成

    各名前空間に対して、次のローカルKubernetes サービス アカウント の一部またはすべてを作成します。

    • 名前空間に MongoDB インスタンスを配置する場合は、 mongodb-kubernetes-database-podsを使用します。

    • 名前空間にMongoDB Ops Managerを配置する場合は、mongodb-kubernetes-appdb と mongodb-kubernetes-ops-manager を使用します。

    該当する例をコピーして貼り付け、 <namespace>値を名前空間を識別するラベルに置き換えます。

    ---
    kind: ServiceAccount
    apiVersion: v1
    metadata:
     name: mongodb-kubernetes-database-pods
     namespace: <namespace>
    ---
    kind: ServiceAccount
    apiVersion: v1
    metadata:
     name: mongodb-kubernetes-appdb
     namespace: <namespace>
    ---
    kind: ServiceAccount
    apiVersion: v1
    metadata:
     name: mongodb-kubernetes-ops-manager
     namespace: <namespace>

Kubernetes Operator を配置する前に、次の項目を構成します。

  1. すべての名前空間を監視するように Kubernetes 演算子を構成します。

    helm install mongodb-kubernetes-operator mongodb/mongodb-kubernetes \
      --set operator.watchNamespace="*"

  2. ローカルKubernetesサービス アカウント の作成

    各名前空間に対して、次のローカルKubernetes サービス アカウント の一部またはすべてを作成します。

    • 名前空間に MongoDB インスタンスを配置する場合は、 mongodb-kubernetes-database-podsを使用します。

    • 名前空間にMongoDB Ops Managerを配置する場合は、mongodb-kubernetes-appdb と mongodb-kubernetes-ops-manager を使用します。

    該当する例をコピーして貼り付け、 <namespace>値を名前空間を識別するラベルに置き換えます。

    helm template mongodb/mongodb-kubernetes \
      --set operator.namespace=<metadata.namespace> \
      --show-only templates/database-roles.yaml | kubectl apply -f -

Kubernetes Operator を配置する前に、次の項目を構成します。

  1. Kubernetes Operator GithubリポジトリのMongoDB -kubernetes-openshift.YAMLサンプルYAMLファイルを使用します。

  2. mongodb-kubernetes-openshift.YAML の spec.template.spec.containers.name.env.name:WATCH_NAMESPACE を "*" に設定します。YAMLファイル内のアスタリスク（*）の前後に二重引用符（"）を含める必要があります。

    WATCH_NAMESPACE: "*"

  3. これらのアカウントに対応するロールを作成します。mongodb-kubernetes-openshift.YAML で、以下の変更を行います。

    kind: Role
    apiVersion: rbac.authorization.k8s.io/v1
    metadata:
     name: enterprise-operator

    から:

    kind: ClusterRole
    apiVersion: rbac.authorization.k8s.io/v1
    metadata:
     name: enterprise-operator

  4. 先ほど変更したClusterRoleに次のコードを追加します。

    - apiGroups:
      - ""
      resources:
      - namespaces
      verbs:
      - list
      - watch

  5. mongodb-kubernetes-openshift.YAML で、以下の変更を行います。

    kind:  RoleBinding
    apiVersion: rbac.authorization.k8s.io/v1
    metadata:
     name: enterprise-operator
     namespace: mongodb
    roleRef:
     apiGroup: rbac.authorization.k8s.io
     kind: Role
     name: enterprise-operator
    subjects:
     - kind: ServiceAccount
     name: enterprise-operator
     namespace: mongodb

    から:

    kind:  ClusterRoleBinding
    apiVersion: rbac.authorization.k8s.io/v1
    metadata:
     name: enterprise-operator
     namespace: mongodb
    roleRef:
     apiGroup: rbac.authorization.k8s.io
     kind: ClusterRole
     name: enterprise-operator
    subjects:
     - kind: ServiceAccount
     name: enterprise-operator
     namespace: mongodb

  6. Kubernetes Operator を配置する名前空間にのみシークレットを作成します。 MongoDB リソースを複数の名前空間またはクラスター全体の スコープで配置すると、Kubernetes Operator は監視対象のすべての名前空間にわたってシークレットを同期します。 詳しくは、 Helm インストール設定のregistry.imagePullSecrets設定を参照してください。

    mongodb-kubernetes.yamlファイルで、<namespace> をKubernetes Operator をインストールする名前空間に置き換えます。oc またはOpenShift Container Platform UIを使用して、結果の YAMLファイル を適用します。

    1---
    2kind: ServiceAccount
    3apiVersion: v1
    4metadata:
    5  name: mongodb-kubernetes-appdb
    6  namespace: <namespace>
    7---
    8kind: ServiceAccount
    9apiVersion: v1
    10metadata:
    11  name: mongodb-kubernetes-database-pods
    12  namespace: <namespace>
    13---
    14kind: ServiceAccount
    15apiVersion: v1
    16metadata:
    17  name: mongodb-kubernetes-ops-manager
    18  namespace: <namespace>
    19---
    20kind: Role
    21apiVersion: rbac.authorization.k8s.io/v1
    22metadata:
    23  name: mongodb-kubernetes-appdb
    24  namespace: <namespace>
    25rules:
    26  - apiGroups:
    27      - ""
    28    resources:
    29      - secrets
    30    verbs:
    31      - get
    32  - apiGroups:
    33      - ""
    34    resources:
    35      - pods
    36    verbs:
    37      - patch
    38---
    39kind: RoleBinding
    40apiVersion: rbac.authorization.k8s.io/v1
    41metadata:
    42  name: mongodb-kubernetes-appdb
    43  namespace: <namespace>
    44roleRef:
    45  apiGroup: rbac.authorization.k8s.io
    46  kind: Role
    47  name: mongodb-kubernetes-appdb
    48subjects:
    49  - kind: ServiceAccount
    50    name: mongodb-kubernetes-appdb
    51    namespace: <namespace>
    52...

  7. ローカルKubernetesサービス アカウント の作成

    各名前空間に対して、次のローカルKubernetes サービス アカウント の一部またはすべてを作成します。

    • 名前空間に MongoDB インスタンスを配置する場合は、 mongodb-kubernetes-database-podsを使用します。

    • 名前空間にMongoDB Ops Managerを配置する場合は、mongodb-kubernetes-appdb と mongodb-kubernetes-ops-manager を使用します。

    該当する例をコピーして貼り付け、 <namespace>値を名前空間を識別するラベルに置き換えます。

Kubernetes Operator を配置する前に、次の項目を構成します。

  1. すべての名前空間を監視するように Kubernetes 演算子を構成します。

    helm install mongodb-kubernetes-operator mongodb/mongodb-kubernetes \
      --set operator.watchNamespace="*" \

  2. Kubernetes Operator を配置する名前空間にのみシークレットを作成します。 MongoDB リソースを複数の名前空間またはクラスター全体の スコープで配置すると、Kubernetes Operator は監視対象のすべての名前空間にわたってシークレットを同期します。 詳しくは、 Helm インストール設定のregistry.imagePullSecrets設定を参照してください。

    mongodb-kubernetes.yamlファイルで、<namespace> をKubernetes Operator をインストールする名前空間に置き換えます。oc またはOpenShift Container Platform UIを使用して、結果の YAMLファイル を適用します。

    1---
    2kind: ServiceAccount
    3apiVersion: v1
    4metadata:
    5  name: mongodb-kubernetes-appdb
    6  namespace: <namespace>
    7---
    8kind: ServiceAccount
    9apiVersion: v1
    10metadata:
    11  name: mongodb-kubernetes-database-pods
    12  namespace: <namespace>
    13---
    14kind: ServiceAccount
    15apiVersion: v1
    16metadata:
    17  name: mongodb-kubernetes-ops-manager
    18  namespace: <namespace>
    19---
    20kind: Role
    21apiVersion: rbac.authorization.k8s.io/v1
    22metadata:
    23  name: mongodb-kubernetes-appdb
    24  namespace: <namespace>
    25rules:
    26  - apiGroups:
    27      - ""
    28    resources:
    29      - secrets
    30    verbs:
    31      - get
    32  - apiGroups:
    33      - ""
    34    resources:
    35      - pods
    36    verbs:
    37      - patch
    38---
    39kind: RoleBinding
    40apiVersion: rbac.authorization.k8s.io/v1
    41metadata:
    42  name: mongodb-kubernetes-appdb
    43  namespace: <namespace>
    44roleRef:
    45  apiGroup: rbac.authorization.k8s.io
    46  kind: Role
    47  name: mongodb-kubernetes-appdb
    48subjects:
    49  - kind: ServiceAccount
    50    name: mongodb-kubernetes-appdb
    51    namespace: <namespace>
    52...

  3. ローカルKubernetesサービス アカウント の作成

    各名前空間に対して、次のローカルKubernetes サービス アカウント の一部またはすべてを作成します。

    • 名前空間に MongoDB インスタンスを配置する場合は、 mongodb-kubernetes-database-podsを使用します。

    • 名前空間にMongoDB Ops Managerを配置する場合は、mongodb-kubernetes-appdb と mongodb-kubernetes-ops-manager を使用します。

    該当する例をコピーして貼り付け、 <namespace>値を名前空間を識別するラベルに置き換えます。

    helm template mongodb/mongodb-kubernetes \
      --set operator.namespace=<metadata.namespace> \
      --show-only templates/database-roles.yaml | oc apply -f -

次のステップ

MongoDB Controls for Kubernetes Operator のスコープを設定すると、次のことが可能になります。

項目一覧