Migrar MongoDBSearch de la vista previa pública a la versión general

Antes de comenzar

GA impone una versión mínima compatible mongot, 1.70.1. Si su recurso MongoDBSearch especifica una versión spec.version anterior a 1.70.1, la reconciliación fallará después de la actualización con un error de versión no compatible. Si no configura spec.version, el operador de Kubernetes proporciona su propia versión predeterminada (1.70.1 a partir de esta versión GA) y no necesita realizar ninguna acción.

Antes de actualizar, compruebe qué versión, si la hay, tiene fijada:

kubectl get mongodbsearch <name> -n <namespace> -o jsonpath='{.spec.version}'

Si el comando imprime una versión anterior a 1.70.1, actualice spec.version a 1.70.1 o posterior como parte de los cambios del manifiesto en la siguiente sección.

Actualiza tu configuración de MongoDBSearch

Un recurso personalizado de MongoDBSearch en vista previa pública nunca tuvo un campo spec.clusters. En la versión GA, spec.clusters es obligatorio, y varios campos que antes se encontraban en el nivel superior de spec ahora solo se encuentran dentro de spec.clusters[0]. Todos los manifiestos existentes requieren la misma edición mecánica, una sola vez, independientemente de la topología.

Los ejemplos de esta sección utilizan un recurso MongoDBSearch llamado my-search en el espacio de nombres mongodb. Sustituya el nombre y el espacio de nombres de su propio recurso.

apiVersion: mongodb.com/v1
kind: MongoDBSearch
metadata:
  name: my-search
  namespace: mongodb
spec:
  source:
    mongodbResourceRef:
      name: my-replica-set
  replicas: 3
  persistence:
    single:
      storage: 20Gi
  resourceRequirements:
    requests:
      cpu: "1"
      memory: 2Gi
    limits:
      cpu: "2"
      memory: 4Gi
  statefulSet:
    spec:
      template:
        spec:
          nodeSelector:
            disktype: ssd
  loadBalancer:
    managed:
      replicas: 2
  jvmFlags:
    - "-Xmx2g"

apiVersion: mongodb.com/v1
kind: MongoDBSearch
metadata:
  name: my-search
  namespace: mongodb
spec:
  source:
    mongodbResourceRef:
      name: my-replica-set
  clusters:
    - replicas: 3
      persistence:
        single:
          storage: 20Gi
      resourceRequirements:
        requests:
          cpu: "1"
          memory: 2Gi
        limits:
          cpu: "2"
          memory: 4Gi
      statefulSet:
        spec:
          template:
            spec:
              nodeSelector:
                disktype: ssd
      loadBalancer:
        managed:
          replicas: 2
      jvmFlags:
        - "-Xmx2g"

spec:
  prometheus:
    port: 9946

spec:
  observability:
    prometheus:
      port: 9946

spec:
  observability:
    prometheus:
      mode: disabled

apiVersion: v1
kind: Secret
metadata:
  name: my-search-external-ca
  namespace: mongodb
type: Opaque
stringData:
  ca.crt: |
    -----BEGIN CERTIFICATE-----
    ...
    -----END CERTIFICATE-----

apiVersion: v1
kind: ConfigMap
metadata:
  name: my-search-external-ca
  namespace: mongodb
data:
  ca.crt: |
    -----BEGIN CERTIFICATE-----
    ...
    -----END CERTIFICATE-----

apiVersion: mongodb.com/v1
kind: MongoDBSearch
metadata:
  name: my-search
  namespace: mongodb
spec:
  source:
    external:
      hostAndPorts:
        - mongodb-0.example.com:27017
      tls:
        ca:
          name: my-search-external-ca

kubectl create configmap my-search-external-ca \
  --from-file=ca.crt=./ca.crt \
  --namespace mongodb

¿Qué sucede con tus recursos de Kubernetes?

Esta sección describe qué sucede con los objetos de Kubernetes subyacentes que administra el operador de Kubernetes, y qué se debe verificar y limpiar posteriormente. Los cambios dependen de si el recurso MongoDBSearch se sincroniza desde un conjunto de réplicas o un clúster fragmentado.

kubectl delete statefulset my-search-search -n mongodb
kubectl delete service my-search-search-svc -n mongodb
kubectl delete configmap my-search-search-config -n mongodb

# Preview the PVCs to delete:
PVCS=$(kubectl get pvc -n mongodb -o name \
  | grep -E 'data-my-search-search-[0-9]+$')
echo "$PVCS"
# After confirming, delete exactly what you previewed:
echo "$PVCS" | xargs kubectl delete -n mongodb

Verificación

Complete esta lista de verificación después de actualizar el operador de Kubernetes y aplicar los cambios del manifiesto, y antes de eliminar cualquier recurso antiguo:

• Confirme que kubectl get mongodbsearch <name> -n <namespace> -o yaml muestra spec.clusters completado, y que no quedan campos de nivel superior replicas, persistence, resourceRequirements, statefulSet, loadBalancer, jvmFlags u prometheus.

• Confirme que el nuevo mongot StatefulSet, <name>-search-0 para una implementación de clúster único, tiene todos los pods Running y Ready.

• Confirma que mongot haya finalizado la reindexación en los nuevos pods antes de eliminar cualquier elemento del StatefulSet anterior. Comprueba los registros o el estado del índice de mongot para verificar la finalización, no solo la disponibilidad del pod.

• Si utilizas el web scraping de Prometheus, confirma que tu configuración de scraping o tus paneles reflejen el nuevo comportamiento habilitado por defecto: o bien las métricas aparecen ahora, o bien tu configuración explícita mode: disabled las mantiene deshabilitadas.

• Si utiliza spec.source.external con TLS, confirme que la CA ConfigMap a la que hace referencia spec.source.external.tls.ca.name existe y contiene una clave ca.crt válida, y que la conexión de mongot con la implementación externa de MongoDB es saludable.

• Para fuentes de conjuntos de réplicas, confirme que ha localizado y eliminado los objetos <name>-search, <name>-search-svc y <name>-search-config antiguos y sus PVC huérfanos. Para fuentes fragmentadas, confirme que ha eliminado los secretos TLS antiguos por fragmento.

Obtenga soporte

Si alguna parte de su actualización no coincide con lo que describe esta guía, o si encuentra un problema que esta guía no cubre, comuníquese con el soporte de MongoDB. Incluya su manifiesto de MongoDBSearch con los secretos ocultos, la versión del operador de Kubernetes desde la que está actualizando y a la que está actualizando, y la salida de:

kubectl describe mongodbsearch <name> -n <namespace>

Obtén más información

• Compatibilidad y requisitos de búsqueda y búsqueda vectorial
• Actualizar o degradar
• Especificación de recursos de MongoDBSearch
• mongot Preguntas frecuentes sobre el despliegue