Управляемый сервис MongoDB

MongoDB — популярная документоориентированная NoSQL-база данных, известная своей гибкостью и масштабируемостью. Управляемый сервис MongoDB предоставляет самовосстанавливающийся реплицируемый кластер под управлением Percona Operator for MongoDB.

Детали развёртывания

Этот управляемый сервис контролируется Percona Operator for MongoDB, обеспечивающим эффективное управление и бесперебойную работу.

• Документация: https://docs.percona.com/percona-operator-for-mongodb/
• Github: https://github.com/percona/percona-server-mongodb-operator

Режимы развёртывания

Режим набора реплик (Replica Set, по умолчанию)

По умолчанию MongoDB разворачивается как набор реплик (replica set) с указанным числом реплик. Этот режим подходит для большинства сценариев, требующих высокой доступности.

Режим шардированного кластера

Включите sharding: true для горизонтального масштабирования по нескольким шардам. Каждый шард представляет собой набор реплик, а маршрутизаторы mongos выполняют маршрутизацию запросов.

Примечания

Внешний доступ

Когда включён external: true:

• Режим набора реплик: Трафик балансируется между всеми участниками набора реплик. Это хорошо работает для операций чтения, но для операций записи требуется подключение к первичному узлу (primary). Драйверы MongoDB автоматически определяют первичный узел, используя строку подключения к набору реплик.
• Шардированный режим: Трафик направляется через маршрутизаторы mongos, которые корректно обрабатывают и чтение, и запись.

Учётные данные

При первой установке Secret с учётными данными будет пустым, пока оператор Percona не инициализирует кластер. После готовности MongoDB выполните helm upgrade, чтобы заполнить Secret с учётными данными фактическим паролем.

Жизненный цикл данных

При удалении релиза MongoDB финализаторы оператора высвобождают ресурсы, относящиеся к релизу:

Высвобождаются финализатором percona.com/delete-psmdb-pvc:

• Все PVC, обеспечивающие хранилище набора реплик. Будут ли фактически удалены базовый PersistentVolume и данные на диске, зависит от reclaimPolicy у StorageClass (Delete удаляет их, Retain оставляет для ручной очистки).
• Управляемые оператором Secret’ы:
  • <release>-percona-server-mongodb-users — учётные данные пользователей оператора
  • internal-<release> — внутреннее состояние оператора
  • internal-<release>-users — внутренние данные пользователей оператора
  • <release>-mongodb-encryption-key — ключ шифрования данных в состоянии покоя (at-rest)

Высвобождаются командой helm uninstall:

• <release>-credentials — строка подключения для кода приложения
• <release>-user-<username> — пароли отдельных пользователей
• <release>-s3-creds — учётные данные места назначения резервных копий (если резервное копирование настроено)

Не высвобождаются автоматически:

• TLS-секреты <release>-ssl и <release>-ssl-internal (выпущенные cert-manager) остаются в пространстве имён после удаления. Удалите их вручную, если они больше не нужны.

Восстановление при зависшем удалении:

Если psmdb-operator удалён до удаления ресурсов MongoDB CR, финализаторы не могут отработать, и ресурс PerconaServerMongoDB зависает в состоянии Terminating. Для восстановления очистите финализаторы вручную:

kubectl --namespace <namespace> patch psmdb <release> --type merge --patch '{"metadata":{"finalizers":[]}}'

Учтите, что это пропускает очистку, выполняемую оператором — PVC и управляемые оператором Secret’ы останутся неиспользуемыми (orphaned) и должны быть удалены вручную.

Если нужно сохранить данные, создайте резервную копию перед удалением. См. документацию Percona Operator for MongoDB по процессам резервного копирования и восстановления.

Обновление с более ранних версий

Более ранние версии этого чарта ссылались на общий для пространства имён Secret системных пользователей (percona-server-mongodb-users). Обновление до релиза, в котором этот Secret привязан к конкретному CR (<release>-percona-server-mongodb-users), запускает ротацию паролей управляемых оператором системных пользователей. Ротация выполняется оператором Percona на месте через db.changeUserPassword() для работающего mongod (в логе оператора: Secret data changed. Updating users...); поды не перезапускаются, и кластер остаётся доступным.

Ротируются автоматически при обновлении:

• Пять управляемых оператором системных учётных записей: databaseAdmin, userAdmin, backup, clusterAdmin, clusterMonitor.
• Secret <release>-percona-server-mongodb-users (создаётся заново, для каждого CR) и internal-<release>-users получают новые значения.
• Secret <release>-credentials пересоздаётся; его ключи password и uri отражают новый пароль databaseAdmin.

Не затрагиваются:

• Пользовательские учётные записи, определённые в users: в values чарта. Их Secret’ы <release>-user-<name> не изменяются.
• Ключ шифрования данных в покое (<release>-mongodb-encryption-key) и keyfile набора реплик (<release>-mongodb-keyfile) не изменяются, поэтому данные на диске остаются читаемыми.

Требуется действие после обновления:

Рабочие нагрузки, монтирующие <release>-credentials, продолжают использовать закэшированный старый пароль, пока не перечитают Secret. Перезапустите эти поды или используйте контроллер вроде Reloader для их автоматического перезапуска (Roll). Без этого подключения приложений завершатся с ошибками аутентификации, как только истекут их текущие сессии.

Осиротевший устаревший Secret:

Прежний общий для пространства имён Secret percona-server-mongodb-users после обновления больше не используется ни одним MongoDB CR, но оператор не удаляет его автоматически. Если несколько релизов MongoDB в одном пространстве имён ранее использовали его совместно, все они переходят на собственные Secret’ы для каждого CR — пароли больше не являются общими между CR в пространстве имён, что и является ожидаемым результатом. Убедитесь, что на него не ссылаются другие потребители, затем удалите его вручную:

kubectl --namespace <namespace> delete secret percona-server-mongodb-users

storageClass помечен как неизменяемый (immutable) в схеме чарта — см. docs/storage-immutability.md, где описан этот контракт и какие потребители его обеспечивают.

Параметры

Общие параметры

Конфигурация шардирования

Конфигурация пользователей

Конфигурация баз данных

Параметры резервного копирования

Параметры начальной загрузки (восстановления)