/ /

/ /

Controladores para el Operador de Kubernetes

Instalar

Instalación del plan

Establecer el ámbito para los controladores de MongoDB en la implementación del operador Kubernetes

Antes de instalar el operador de Kubernetes, puede definir el alcance de su implementación. Los alcances dependen de los espacios de nombres en los que elija implementar Ops Manager y MongoDB recursos.

Ámbitos de implementación del operador de Kubernetes

Puede configurar uno de estos ámbitos:

El operador utiliza el mismo espacio de nombres único que los recursos (por defecto)
El operador utiliza un subconjunto de espacios de nombres
El operador utiliza el alcance de todo el clúster

El operador utiliza el mismo espacio de nombres único que los recursos

Puedes configurar el alcance del operador de Kubernetes para que use el mismo espacio de nombres que los recursos. En este caso, el operador de Kubernetes supervisa Ops Manager y los MongoDB recursos en ese mismo espacio de nombres.

Cuando tu Instale el operador de Kubernetes, utiliza el espacio de nombres predeterminado.

El operador utiliza un subconjunto de espacios de nombres

Puede configurar el alcance del operador de Kubernetes para que use uno o más espacios de nombres diferentes del que usan sus recursos. En este caso, el operador de Kubernetes supervisa Ops Manager y los MongoDB recursos en un subconjunto de espacios de nombres que usted especifique.

Para instalar las instancias del operador de Kubernetes con este alcance, utilice helm con el parámetro operator.watchNamespace.

Monitorear un subconjunto de espacios de nombres es útil en implementaciones donde una sola instancia de Kubernetes Operator monitorea un tipo de recurso de clúster diferente. Por ejemplo, puede configurar Kubernetes Operator para que monitoree MongoDB recursos en un subconjunto de espacios de nombres y MongoDBMultiCluster recursos en otro. Para evitar condiciones de competencia durante la conciliación de recursos, asegúrese de asignar el alcance a un subconjunto de espacios de nombres distinto para cada tipo de recurso personalizado que desee que Kubernetes Operator monitorice.

Siga las instrucciones de instalación helmcorrespondientes para, pero especifique uno o más espacios de nombres en el parámetro operator.watchNamespace para que el operador de Kubernetes observe:

# 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"

Al instalar el operador de Kubernetes para observar recursos en uno o más espacios de nombres distintos del espacio de nombres en el que está implementado el operador de Kubernetes:

Crea los siguientes recursos:
- Un ClusterRole con acceso a múltiples recursos. Para ver la definición completa del recurso, consulte el ejemplo operator-roles.yaml. Este recurso tiene alcance de clúster.
- Crea un ClusterRoleBinding para vincular ClusterRole con ServiceAccount. Este clusterRoleBinding vinculará el clusterRole que creaste con la ServiceAccount que usa el operador de Kubernetes en el espacio de nombres donde lo instalaste.
Incluya ClusterRole y ClusterRoleBinding en los archivos de configuración predeterminados que aplique durante la instalación.
Crear cuentas de servicio de Kubernetes locales:
Para cada espacio de nombres, cree algunas o todas las siguientes cuentas de servicio de Kubernetes locales:
- Si desea implementar una instancia de MongoDB en el espacio de nombres, utilice mongodb-kubernetes-database-pods.
- Si desea implementar Ops Manager en el espacio de nombres, utilice mongodb-kubernetes-appdb y mongodb-kubernetes-ops-manager.

El siguiente ejemplo ilustra cómo ClusterRole y ClusterRoleBinding funcionan juntos en el clúster.

Supongamos que crea una cuenta de servicio en el espacio de nombres mongodb y luego instala el operador de Kubernetes en este espacio. El operador de Kubernetes utiliza esta cuenta de servicio.

Para configurar el alcance del operador de Kubernetes para observar los espacios de nombres ns1 y ns2:

Obtenga privilegios de administrador del clúster.
Usando estos privilegios, crea un ClusterRole a nivel de clúster, sin espacio de nombres.
Cree un ClusterRoleBinding en tres espacios demongodb nombres:, ns1 ns2y. Este ClusterRoleBinding vinculará el ClusterRole a la ServiceAccount en el mongodb espacio de nombres. El clusterRoleBinding permitirá que el operador de Kubernetes implementado en el mongodb espacio de nombres acceda a los recursos descritos en el clusterRole del espacio de nombres de destino, es decir,mongodb ns1 en,ns2 y.

Véase también operator.watchNamespace.

El operador utiliza el alcance de todo el clúster

Puedes establecer el alcance del operador de Kubernetes en el clúster de Kubernetes. En este caso, el operador de Kubernetes supervisa los recursos de Ops Manager y MongoDB en todos los espacios de nombres del clúster de Kubernetes.

Importante

Puede implementar solo una instancia del operador de Kubernetes con un alcance de todo el clúster por cada clúster de Kubernetes.

Para establecer un alcance a nivel de clúster para el operador de Kubernetes, siga las instrucciones para su método de instalación preferido.

Utilice el ejemplo mongodb-kubernetes.yaml ArchivoYAML del repositorio de GitHub de controladores MongoDB para el operador de Kubernetes.
Establezca spec.template.spec.containers.name.env.name:WATCH_NAMESPACE en mongodb-kubernetes.yaml "*"como. Debe incluir las comillas dobles" () alrededor del asterisco* () en el archivo YAML.
```
WATCH_NAMESPACE: "*"
```
In mongodb-kubernetes.yaml, change:
```
kind:  Role
apiVersion: rbac.authorization.k8s.io/v1
metadata:
 name: mongodb-kubernetes-operator
```
a:
```
kind: ClusterRole
apiVersion: rbac.authorization.k8s.io/v1
metadata:
 name: mongodb-kubernetes-operator
```
Añade el siguiente código al ClusterRole que acabas de modificar:
```
- apiGroups:
  - ""
  resources:
  - namespaces
  verbs:
  - list
  - watch
```

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

En el mongodb-kubernetes.yaml archivo, cambie el <namespace> valor al espacio de nombres donde desea que el operador de Kubernetes implemente recursos y aplique el archivo YAML.

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

Crear cuentas de servicio locales de Kubernetes:

Para cada espacio de nombres, cree algunas o todas las siguientes cuentas de servicio locales de Kubernetes:

Si desea implementar una instancia de MongoDB en el espacio de nombres, utilice mongodb-kubernetes-database-pods.
Si desea implementar Ops Manager en el espacio de nombres, utilice mongodb-kubernetes-appdb y mongodb-kubernetes-ops-manager.

Copia y pega los ejemplos aplicables y reemplaza el valor <namespace> con la etiqueta que identifica el espacio de nombres.

---
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>

Antes de implementar el operador de Kubernetes, configure los siguientes elementos:

Configure el operador de Kubernetes para vigilar todos los espacios de nombres:
```
helm install mongodb-kubernetes-operator mongodb/mongodb-kubernetes \
  --set operator.watchNamespace="*"
```
Crear cuentas de servicio locales de Kubernetes:
Para cada espacio de nombres, cree algunas o todas las siguientes cuentas de servicio locales de Kubernetes:
- Si desea implementar una instancia de MongoDB en el espacio de nombres, utilice mongodb-kubernetes-database-pods.
- Si desea implementar Ops Manager en el espacio de nombres, utilice mongodb-kubernetes-appdb y mongodb-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:

Utilice el archivo YAMLde muestra mongodb-kubernetes-openshift.yaml del repositorio de GitHub de MongoDB Controllers for Kubernetes Operator.
Establezca spec.template.spec.containers.name.env.name:WATCH_NAMESPACE en mongodb-kubernetes-openshift.yaml "*"como. Debe incluir las comillas dobles" () alrededor del asterisco* () en el archivo YAML.
```
WATCH_NAMESPACE: "*"
```
Cree los roles correspondientes para estas cuentas. En mongodb-kubernetes-openshift.yaml, modifique:
```
kind: Role
apiVersion: rbac.authorization.k8s.io/v1
metadata:
 name: enterprise-operator
```
a:
```
kind: ClusterRole
apiVersion: rbac.authorization.k8s.io/v1
metadata:
 name: enterprise-operator
```
Añade el siguiente código al ClusterRole que acabas de modificar:
```
- apiGroups:
  - ""
  resources:
  - namespaces
  verbs:
  - list
  - watch
```

En mongodb-kubernetes-openshift.yaml, cambie:

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

Cree el secreto únicamente en el espacio de nombres donde implementará el operador de Kubernetes. Si implementa recursos de MongoDB en varios espacios de nombres o con un alcance que abarca todo el clúster, el operador de Kubernetes sincroniza el secreto en todos los espacios de nombres supervisados. Para obtener más información, consulte la registry.imagePullSecrets configuración en la configuración de instalación de Helm.

En el mongodb-kubernetes.yaml archivo, reemplace <namespace> por el espacio de nombres donde desea instalar el operador de Kubernetes. Use oc o la interfaz de usuario de OpenShift Container Platform para aplicar el archivo YAML resultante.

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

Crear cuentas de servicio locales de Kubernetes:
Para cada espacio de nombres, cree algunas o todas las siguientes cuentas de servicio locales de Kubernetes:
- Si desea implementar una instancia de MongoDB en el espacio de nombres, utilice mongodb-kubernetes-database-pods.
- Si desea implementar Ops Manager en el espacio de nombres, utilice mongodb-kubernetes-appdb y mongodb-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 vigilar todos los espacios de nombres:
```
helm install mongodb-kubernetes-operator mongodb/mongodb-kubernetes \
  --set operator.watchNamespace="*" \
```

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

Crear cuentas de servicio locales de Kubernetes:
Para cada espacio de nombres, cree algunas o todas las siguientes cuentas de servicio locales de Kubernetes:
- Si desea implementar una instancia de MongoDB en el espacio de nombres, utilice mongodb-kubernetes-database-pods.
- Si desea implementar Ops Manager en el espacio de nombres, utilice mongodb-kubernetes-appdb y mongodb-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 configurar el alcance para el operador Controladores MongoDB para Kubernetes, puede:

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