MongoDBSearchをパブリックプレビューから GA に移行する

始める前に

GAは、サポートされる最小のmongotバージョンである1.70.1を強制します。MongoDBSearchリソースで1.70.1よりも前のspec.versionが明示的にピン留めされている場合、アップグレード後にreconciliationが失敗し、サポートされていないバージョンであることを示すエラーが発生します。spec.version を設定しない場合、Kubernetes Operator が独自のデフォルト（この GA リリース時点では 1.70.1）を適用するため、アクションを実行する必要はありません。

アップグレードする前に、ピン留めているバージョンがある場合は、そのバージョンを確認してください。

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

コマンドで 1.70.1 以前のバージョンが表示される場合は、次のセクションのマニフェストの変更の一部として spec.version を 1.70.1 以降に更新します。

MongoDB 検索構成の更新

Public Preview MongoDBSearch カスタムリソースには spec.clusters フィールドがありませんでした。GA では spec.clusters が必要となり、spec のトップレベルにあったいくつかのフィールドは spec.clusters[0] 内にのみ存在するようになりました。すべての既存のマニフェストには、トポロジーに関わらず、同じ機械的な編集が 1 度だけ必要です。

このセクションの例では、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 Operator がマネージする基礎となる 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のPodの準備状況だけでなく、ログやインデックスの状態を確認して完了しているかを確認してください。

• Prometheus スクレイピングを使用する場合は、スクレイプ構成またはダッシュボードに新しいデフォルトで有効になった動作が反映されていることを確認します。つまり、メトリクスが表示されるか、明示的な mode: disabled 設定によってメトリクスが無効のままになります。

• spec.source.external を TLS と一緒に使用する場合は、spec.source.external.tls.ca.name で参照される CA ConfigMap が存在し、有効な ca.crt キーを含んでいること、および mongot の外部 MongoDB 配置への接続が正常であることを確認します。

• レプリカセット ソースの場合は、古い <name>-search、<name>-search-svc、<name>-search-config オブジェクトとそのオーファン PVC を特定して削除するしたことを確認します。シャーディングされたソースの場合は、古いシャードごとの TLS Secrets を削除したことを確認します。

サポートを受ける

アップグレードの一部がこのガイドの記述と一致しない場合、またはこのガイドでカバーされていない問題が発生した場合は、MongoDB サポートにお問い合わせください。シークレットが隠されたMongoDBSearchマニフェスト、アップグレード元のKubernetes Operatorバージョンとアップグレード先のKubernetes Operatorバージョン、および次の出力を含めてください。

kubectl describe mongodbsearch <name> -n <namespace>

詳細

• 検索とベクトル検索の互換性と要件
• アップグレードまたはダウングレード
• MongoDBSearch リソースの仕様
• mongot 配置に関するよくある質問