Antes de instalar el Operador de Kubernetes, puedes definir el alcance de la implementación del Operador de Kubernetes. Los alcances dependen de los espacios de nombres en los que elija implementar Ops Manager y los recursos de MongoDB.
Alcances de implementación del operador de Kubernetes
Puede establecer uno de estos ámbitos:
El operador utiliza el mismo namespace único que los recursos.
Puedes configurar el alcance del Operador de Kubernetes para que utilice el mismo namespace que el de los recursos. En este caso, el Operador Kubernetes supervisa Ops Manager y MongoDB recursos en ese mismo namespace.
Cuando instalas el Kubernetes operador, se utiliza el namespace por defecto.
El Operador usa un subconjunto de namespaces
Se puede establecer el alcance del operador de Kubernetes para que use uno o más namespaces que difieran del namespace utilizado por los recursos del operador de Kubernetes. En este caso, el Kubernetes operador supervisa Ops Manager y MongoDB recursos en un subconjunto de namespaces que tu especifiques.
Para instalar las instancias del Operador de Kubernetes en este alcance, utiliza helm con el operator.watchNamespace parámetro.
Observar un subconjunto de namespaces es útil en implementaciones donde una sola instancia de Kubernetes operador observa un tipo diferente de recurso en el clúster. Por ejemplo, puedes configurar el operador de Kubernetes para monitorear recursos MongoDB en un subconjunto de namespaces y monitorear recursos MongoDBMultiCluster en otro subconjunto de namespaces. Para evitar condiciones de carrera durante la reconciliación de recursos, para cada tipo de recurso personalizado que quieras que el Operador de Kubernetes observe, asegúrate de establecer el alcance en un subconjunto distinto de espacios de nombres.
Siga las instrucciones de instalación pertinentes para helm, pero especifique uno o más espacios de nombres en operador.watchNamespace parámetro para que el Operador de Kubernetes observe:
# Watch one namespacehelm install mongodb-kubernetes-operator mongodb/mongodb-kubernetes \ --set operator.watchNamespace='namespace-to-watch' <...># Watch both namespace-a and namespace-bhelm 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-prodhelm install mongodb-kubernetes-operator-staging mongodb/mongodb-kubernetes --set operator.watchNamespace="ns-staging\,ns-pre-prod"Al instalar el Operador de Kubernetes para monitorear recursos en uno o más namespaces distintos al namespace en el que está implementado el Operador de Kubernetes:
Crea los siguientes recursos:
Un ClusterRole con acceso a múltiples recursos. Para obtener la definición completa del recurso, consulte el ejemplo operator-roles.yaml. Este es un recurso con ámbito de clúster.
Cree un ClusterRoleBinding para vincular ClusterRole con ServiceAccount. Este
clusterRoleBindingasociará elclusterRoleque creaste con el ServiceAccount que el Kubernetes Operador está usando en el namespace donde lo instales.
Incluya el ClusterRole y ClusterRoleBinding en los archivos de configuración por defecto que se aplican durante la instalación.
Cree ServiceAccounts:locales de Kubernetes
Para cada namespace, cree algunas o todas las siguientes ServiceAccounts de Kubernetes locales:
Si deseas implementar una instancia de MongoDB en el namespace, utiliza
mongodb-kubernetes-database-pods.Si deseas implementar Ops Manager en el namespace, utiliza
mongodb-kubernetes-appdbymongodb-kubernetes-ops-manager.
El siguiente ejemplo ilustra cómo el ClusterRole y el ClusterRoleBinding trabajan juntos en el clúster.
Supongamos que crea una ServiceAccount en el namespace mongodb y luego instala el Kubernetes Operator en este namespace. El Operador de Kubernetes utiliza esta cuenta de servicio.
Para configurar el ámbito del operador de Kubernetes para observar los namespaces ns1 y ns2:
Usando estos privilegios, crea un ClusterRole a nivel de clúster, sin espacio de nombres.
Cree un ClusterRoleBinding en tres namespaces:
mongodb,ns1yns2. Este ClusterRoleBinding vinculará el ClusterRole a la ServiceAccount en el namespacemongodb. ElclusterRoleBindingpermitirá al Kubernetes Operator implementado en el namespacemongodbacceder a los recursos descritos en elclusterRoledel namespace de destino, es decir, enmongodb,ns1yns2.
Consulta también operator.watchNamespace.
El operador utiliza el ámbito en todo el clúster
Puede establecer el alcance del Operador de Kubernetes al clúster de Kubernetes. En este caso, el Operador de Kubernetes monitorea Ops Manager y los recursos MongoDB en todos los namespaces en el clúster de Kubernetes.
Importante
Solo puedes implementar una sola instancia del Kubernetes Operator con un alcance a nivel de clúster por cada clúster de Kubernetes.
Para establecer un alcance a nivel de clúster para el operador de Kubernetes, sigue las instrucciones para tu método de instalación preferido.
Utilice el archivo de mongodb-kubernetes.yaml muestra YAML del repositorio de GitHub de MongoDB Controllers for Kubernetes Operator
Establezca el
spec.template.spec.containers.name.env.name:WATCH_NAMESPACEen mongodb-kubernetes.yaml en"*". Debe incluir las comillas double (") alrededor del asterisco (*) en el archivo YAML.WATCH_NAMESPACE: "*"In mongodb-kubernetes.yaml, change:
kind: RoleapiVersion: rbac.authorization.k8s.io/v1metadata: name: mongodb-kubernetes-operatorpara:
kind: ClusterRoleapiVersion: rbac.authorization.k8s.io/v1metadata: name: mongodb-kubernetes-operatorAgrega el siguiente código al
ClusterRoleque acabas de modificar:- apiGroups: - "" resources: - namespaces verbs: - list - watchIn mongodb-kubernetes.yaml, change:
kind: RoleBindingapiVersion: rbac.authorization.k8s.io/v1metadata: name: mongodb-kubernetes-operator namespace: mongodbroleRef: apiGroup: rbac.authorization.k8s.io kind: Role name: mongodb-kubernetes-operatorsubjects: - kind: ServiceAccount name: mongodb-kubernetes-operator namespace: mongodbpara:
kind: ClusterRoleBindingapiVersion: rbac.authorization.k8s.io/v1metadata: name: mongodb-kubernetes-operator namespace: mongodbroleRef: apiGroup: rbac.authorization.k8s.io kind: ClusterRole name: mongodb-kubernetes-operatorsubjects: - kind: ServiceAccount name: mongodb-kubernetes-operator namespace: mongodbEn el archivo
mongodb-kubernetes.yaml, cambie el valor de<namespace>al namespace donde desea que el Kubernetes Operator despliegue recursos y aplique el archivo YAML.kind: ServiceAccountapiVersion: v1metadata: name: mongodb-kubernetes-appdb namespace: <namespace>kind: ServiceAccountapiVersion: v1metadata: name: mongodb-kubernetes-database-pods namespace: <namespace>kind: ServiceAccountapiVersion: v1metadata: name: mongodb-kubernetes-ops-manager namespace: <namespace>kind: RoleapiVersion: rbac.authorization.k8s.io/v1metadata: name: mongodb-kubernetes-appdb namespace: <namespace>rules: - apiGroups: - "" resources: - secrets verbs: - get - apiGroups: - "" resources: - pods verbs: - patchkind: RoleBindingapiVersion: rbac.authorization.k8s.io/v1metadata: name: mongodb-kubernetes-appdb namespace: <namespace>roleRef: apiGroup: rbac.authorization.k8s.io kind: Role name: mongodb-kubernetes-appdbsubjects: - kind: ServiceAccount name: mongodb-kubernetes-appdb namespace: <namespace>Crea cuentas de servicio locales de Kubernetes cuentas de servicio:
Para cada namespace, cree algunas o todas las siguientes cuentas de servicio locales de Kubernetes:
Si deseas implementar una instancia de MongoDB en el namespace, utiliza
mongodb-kubernetes-database-pods.Si deseas implementar Ops Manager en el namespace, utiliza
mongodb-kubernetes-appdbymongodb-kubernetes-ops-manager.
Copia y pega los ejemplos aplicables y reemplaza el valor
<namespace>con la etiqueta que identifica el espacio de nombres.---kind: ServiceAccountapiVersion: v1metadata: name: mongodb-kubernetes-database-pods namespace: <namespace>---kind: ServiceAccountapiVersion: v1metadata: name: mongodb-kubernetes-appdb namespace: <namespace>---kind: ServiceAccountapiVersion: v1metadata: name: mongodb-kubernetes-ops-manager namespace: <namespace>
Antes de implementar el operador de Kubernetes, configure los siguientes elementos:
Configure el operador de Kubernetes para monitorizar todos los namespaces:
helm install mongodb-kubernetes-operator mongodb/mongodb-kubernetes \ --set operator.watchNamespace="*"Crea cuentas de servicio locales de Kubernetes cuentas de servicio:
Para cada namespace, cree algunas o todas las siguientes cuentas de servicio locales de Kubernetes:
Si deseas implementar una instancia de MongoDB en el namespace, utiliza
mongodb-kubernetes-database-pods.Si deseas implementar Ops Manager en el namespace, utiliza
mongodb-kubernetes-appdbymongodb-kubernetes-ops-manager.
Copia y pega los ejemplos aplicables y reemplaza el valor
<namespace>con la etiqueta que identifica el espacio de nombres.helm template mongodb/mongodb-kubernetes \ --set operator.namespace=<metadata.namespace> \ --show-only templates/database-roles.yaml | kubectl apply -f -
Antes de implementar el operador de Kubernetes, configure los siguientes elementos:
Utiliza el archivo de muestra mongodb-kubernetes-openshift.yaml YAML del Repositorio GitHub de MongoDB Controllers para Kubernetes Operator.
Establezca el
spec.template.spec.containers.name.env.name:WATCH_NAMESPACEen mongodb-kubernetes-openshift.yaml a"*". Debe incluir las comillas double (") alrededor del asterisco (*) en el archivo YAML.WATCH_NAMESPACE: "*"Cree los roles correspondientes para estas cuentas. En mongodb-kubernetes-openshift.yaml, cambiar:
kind: RoleapiVersion: rbac.authorization.k8s.io/v1metadata: name: enterprise-operatorpara:
kind: ClusterRoleapiVersion: rbac.authorization.k8s.io/v1metadata: name: enterprise-operatorAgrega el siguiente código al
ClusterRoleque acabas de modificar:- apiGroups: - "" resources: - namespaces verbs: - list - watchEn mongodb-kubernetes-openshift.yaml, cambie:
kind: RoleBindingapiVersion: rbac.authorization.k8s.io/v1metadata: name: enterprise-operator namespace: mongodbroleRef: apiGroup: rbac.authorization.k8s.io kind: Role name: enterprise-operatorsubjects: - kind: ServiceAccount name: enterprise-operator namespace: mongodbpara:
kind: ClusterRoleBindingapiVersion: rbac.authorization.k8s.io/v1metadata: name: enterprise-operator namespace: mongodbroleRef: apiGroup: rbac.authorization.k8s.io kind: ClusterRole name: enterprise-operatorsubjects: - kind: ServiceAccount name: enterprise-operator namespace: mongodbCrea el secreto solo en el namespace donde se implementará el operador de Kubernetes. Si se implementan recursos de MongoDB en múltiples espacios de nombres o con un ámbito a nivel de clúster, el Operador de Kubernetes sincroniza el secreto en todos los espacios de nombres supervisados. Para aprender más, ver la configuración
registry.imagePullSecretsen la configuración de instalación de Helm.En el archivo
mongodb-kubernetes.yaml, reemplace<namespace>con el namespace en el que quiera instalar el Operador de Kubernetes. Usa oc o la Interfaz de Usuario de OpenShift Container Platform para aplicar el archivo YAML resultante.kind: ServiceAccountapiVersion: v1metadata: name: mongodb-kubernetes-appdb namespace: <namespace>kind: ServiceAccountapiVersion: v1metadata: name: mongodb-kubernetes-database-pods namespace: <namespace>kind: ServiceAccountapiVersion: v1metadata: name: mongodb-kubernetes-ops-manager namespace: <namespace>kind: RoleapiVersion: rbac.authorization.k8s.io/v1metadata: name: mongodb-kubernetes-appdb namespace: <namespace>rules: - apiGroups: - "" resources: - secrets verbs: - get - apiGroups: - "" resources: - pods verbs: - patchkind: RoleBindingapiVersion: rbac.authorization.k8s.io/v1metadata: name: mongodb-kubernetes-appdb namespace: <namespace>roleRef: apiGroup: rbac.authorization.k8s.io kind: Role name: mongodb-kubernetes-appdbsubjects: - kind: ServiceAccount name: mongodb-kubernetes-appdb namespace: <namespace>Crea cuentas de servicio locales de Kubernetes cuentas de servicio:
Para cada namespace, cree algunas o todas las siguientes cuentas de servicio locales de Kubernetes:
Si deseas implementar una instancia de MongoDB en el namespace, utiliza
mongodb-kubernetes-database-pods.Si deseas implementar Ops Manager en el namespace, utiliza
mongodb-kubernetes-appdbymongodb-kubernetes-ops-manager.
Copia y pega los ejemplos aplicables y reemplaza el valor
<namespace>con la etiqueta que identifica el espacio de nombres.
Antes de implementar el operador de Kubernetes, configure los siguientes elementos:
Configure el operador de Kubernetes para monitorizar todos los namespaces:
helm install mongodb-kubernetes-operator mongodb/mongodb-kubernetes \ --set operator.watchNamespace="*" \Crea el secreto solo en el namespace donde se implementará el operador de Kubernetes. Si se implementan recursos de MongoDB en múltiples espacios de nombres o con un ámbito a nivel de clúster, el Operador de Kubernetes sincroniza el secreto en todos los espacios de nombres supervisados. Para aprender más, ver la configuración
registry.imagePullSecretsen la configuración de instalación de Helm.En el archivo
mongodb-kubernetes.yaml, reemplace<namespace>con el namespace en el que quiera instalar el Operador de Kubernetes. Usa oc o la Interfaz de Usuario de OpenShift Container Platform para aplicar el archivo YAML resultante.kind: ServiceAccountapiVersion: v1metadata: name: mongodb-kubernetes-appdb namespace: <namespace>kind: ServiceAccountapiVersion: v1metadata: name: mongodb-kubernetes-database-pods namespace: <namespace>kind: ServiceAccountapiVersion: v1metadata: name: mongodb-kubernetes-ops-manager namespace: <namespace>kind: RoleapiVersion: rbac.authorization.k8s.io/v1metadata: name: mongodb-kubernetes-appdb namespace: <namespace>rules: - apiGroups: - "" resources: - secrets verbs: - get - apiGroups: - "" resources: - pods verbs: - patchkind: RoleBindingapiVersion: rbac.authorization.k8s.io/v1metadata: name: mongodb-kubernetes-appdb namespace: <namespace>roleRef: apiGroup: rbac.authorization.k8s.io kind: Role name: mongodb-kubernetes-appdbsubjects: - kind: ServiceAccount name: mongodb-kubernetes-appdb namespace: <namespace>Crea cuentas de servicio locales de Kubernetes cuentas de servicio:
Para cada namespace, cree algunas o todas las siguientes cuentas de servicio locales de Kubernetes:
Si deseas implementar una instancia de MongoDB en el namespace, utiliza
mongodb-kubernetes-database-pods.Si deseas implementar Ops Manager en el namespace, utiliza
mongodb-kubernetes-appdbymongodb-kubernetes-ops-manager.
Copia y pega los ejemplos aplicables y reemplaza el valor
<namespace>con la etiqueta que identifica el espacio de nombres.helm template mongodb/mongodb-kubernetes \ --set operator.namespace=<metadata.namespace> \ --show-only templates/database-roles.yaml | oc apply -f -
Próximos pasos
Después de establecer el alcance para los MongoDB Controllers para Kubernetes operador, puedes:
Lee las Consideraciones.
Completa los requisitos previos.