Public Preview에서 GA로 MongoDBSearch 마이그레이션

시작하기 전에

GA는 최소 지원 mongot 버전인 1.70.1을 시행합니다. MongoDBSearch 리소스가 1.70.1보다 이전의 명시적 spec.version 를 고정하는 경우 업그레이드 후 지원되지 않는 버전 오류로 인해 조정이 실패합니다. spec.version를 설정하지 않은 경우 Kubernetes Operator가 자체 기본값(1.70.1 이 GA 릴리즈 기준) 을 제공하므로 별도의 조치를 취할 필요가 없습니다.

업그레이드하기 전에 고정한 버전이 있는지 확인하십시오.

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

명령이 1.70.1 이전 버전을 인쇄하면 다음 섹션의 매니페스트 변경 내용의 일부로 spec.version 을 1.70.1 또는 이후 버전으로 업데이트합니다.

MongoDBSearch 구성 업데이트

공개 미리 보기 MongoDBSearch 사용자 지정 리소스에는 spec.clusters 필드가 없습니다. GA에서는 spec.clusters 이(가) 필요하며, 이전에 spec 의 최상위 수준에 있던 여러 필드가 이제는 spec.clusters[0] 내부에만 있습니다. 모든 기존 매니페스트에는 토폴로지에 관계없이 동일한 기계적 편집이 한 번 필요합니다.

이 섹션의 예시에서는 mongodb 네임스페이스에 있는 my-search 이라는 MongoDBSearch 리소스를 사용합니다. 리소스의 이름과 네임스페이스를 대체합니다.

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

Kubernetes 리소스에 어떤 일이 발생하나요

이 섹션에서는 Kubernetes 연산자가 관리하는 기본 Kubernetes 객체에 대해 설명하고 이후 확인하고 정리해야 할 사항을 설명합니다. 변경 사항은 MongoDBSearch 리소스가 복제본 세트에서 동기화되는지 샤딩된 클러스터에서 동기화되는지에 따라 다릅니다.

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

검증

Kubernetes 연산자를 업그레이드하고 매니페스트 변경 사항을 적용한 후 이 체크리스트를 완료하고 오래된 리소스를 삭제하기 전에 다음 사항을 수행합니다.

• kubectl get mongodbsearch <name> -n <namespace> -o yaml 에 spec.clusters 이 채워지고 남아 있는 최상위 replicas, persistence, resourceRequirements, statefulSet, loadBalancer, jvmFlags 또는 prometheus 필드가 없는지 확인합니다.

• 단일 클러스터 배포서버의 새 mongot StatefulSet인 <name>-search-0 에 모든 팝이 Running 및 Ready인지 확인합니다.

• 이전 StatefulSet에서 문서를 삭제하기 전에 mongot 이 새 팟에서 인덱싱을 다시 시작했는지 확인합니다. 팟 준비 완료 여부만 확인하지 말고 mongot의 로그 또는 인덱스 상태를 확인하여 완료 여부를 확인합니다.

• Prometheus 스크래핑에 의지하는 경우 스크래핑 구성 또는 대시보드에 새로운 기본값 사용 가능 동작이 반영되어 있는지 확인합니다. 지표가 표시되거나 명시적인 mode: disabled 설정이 지표를 비활성화되어 있는지 확인합니다.

• TLS와 함께 spec.source.external 를 사용하는 경우 spec.source.external.tls.ca.name 에서 참조하는 CA ConfigMap 이 존재하고 유효한 ca.crt 키가 포함되어 있는지, mongot의 외부 MongoDB 배포서버에 대한 연결이 정상적인지 확인합니다.

• 복제본 세트 소스의 경우 이전 <name>-search, <name>-search-svc 및 <name>-search-config 객체와 이들의 오퍰 PVC를 찾아 삭제했는지 확인합니다. 샤딩된 소스의 경우 이전 샤드별 TLS 시크릿을 삭제했는지 확인합니다.

지원 받기

업그레이드의 어떤 부분이 이 가이드에 설명된 내용과 일치하지 않거나 이 가이드에서 다루지 않는 문제가 발생하면 MongoDB 지원에 문의하세요. 시크릿이 삭제된 MongoDBSearch 매니페스트, 업그레이드하는 Kubernetes 연산자 버전 및 다음의 출력을 포함하세요.

kubectl describe mongodbsearch <name> -n <namespace>

자세히 알아보기

• 검색 및 벡터 검색 호환성 및 요구 사항
• 업그레이드 또는 다운그레이드
• MongoDBSearch 리소스 사양
• mongot 배포서버 자주 묻는 질문