Skip to content
logo
Percona Operator for MongoDB
Percona Operator for MongoDB 1.12.0 (2022-05-05)
Initializing search
    percona/k8spsmdb-docs
    percona/k8spsmdb-docs
    • Welcome
      • Design and architecture
      • Comparison with other solutions
      • Install with Helm
      • Install with kubectl
      • System requirements
      • Install on Minikube
      • Install on Google Kubernetes Engine (GKE)
      • Install on Amazon Elastic Kubernetes Service (AWS EKS)
      • Install on Microsoft Azure Kubernetes Service (AKS)
      • Generic Kubernetes installation
      • Install on OpenShift
      • Application and system users
      • Changing MongoDB options
      • Anti-affinity and tolerations
      • Labels and annotations
      • Exposing the cluster
      • Local storage support
      • Arbiter and non-voting nodes
      • MongoDB sharding
      • Transport encryption (TLS/SSL)
      • Data at rest encryption
      • Telemetry
        • About backups
        • Configure storage for backups
        • Making scheduled backups
        • Making on-demand backup
        • Storing operations logs for point-in-time recovery
        • Restore from a previously saved backup
        • Delete the unneeded backup
      • Upgrade MongoDB and the Operator
      • Horizontal and vertical scaling
      • Multi-cluster and multi-region deployment
      • Monitor with Percona Monitoring and Management (PMM)
      • Add sidecar containers
      • Restart or pause the cluster
      • Debug and troubleshoot
      • OpenLDAP integration
      • How to use private registry
      • Creating a private S3-compatible cloud for backups
      • Restore backup to a new Kubernetes-based environment
      • How to use backups to move the external database to Kubernetes
      • Install Percona Server for MongoDB in multi-namespace (cluster-wide) mode
      • Upgrading Percona Server for MongoDB manually
      • Custom Resource options
      • Percona certified images
      • Operator API
      • Frequently asked questions
      • Old releases (documentation archive)
      • Release notes index
      • Percona Operator for MongoDB 1.14.0 (2023-03-13)
      • Percona Operator for MongoDB 1.13.0 (2022-09-15)
      • Percona Operator for MongoDB 1.12.0 (2022-05-05)
        • Release Highlights
        • New Features
        • Improvements
        • Bugs Fixed
        • Known Issues
        • Deprecation, Rename and Removal
        • Supported Platforms
      • Percona Distribution for MongoDB Operator 1.11.0 (2021-12-21)
      • Percona Distribution for MongoDB Operator 1.10.0 (2021-09-30)
      • Percona Distribution for MongoDB Operator 1.9.0 (2021-07-29)
      • Percona Kubernetes Operator for Percona Server for MongoDB 1.8.0 (2021-05-06)
      • Percona Kubernetes Operator for Percona Server for MongoDB 1.7.0 (2021-03-08)
      • Percona Kubernetes Operator for Percona Server for MongoDB 1.6.0 (2020-12-22)
      • Percona Kubernetes Operator for Percona Server for MongoDB 1.5.0 (2020-09-07)
      • Percona Kubernetes Operator for Percona Server for MongoDB 1.4.0 (2020-03-31)
      • Percona Kubernetes Operator for Percona Server for MongoDB 1.3.0 (2019-12-11)
      • Percona Kubernetes Operator for Percona Server for MongoDB 1.2.0 (2019-09-20)
      • Percona Kubernetes Operator for Percona Server for MongoDB 1.1.0 (2019-07-15)
      • Percona Kubernetes Operator for Percona Server for MongoDB 1.0.0 (2019-05-29)

    • Release Highlights
    • New Features
    • Improvements
    • Bugs Fixed
    • Known Issues
    • Deprecation, Rename and Removal
    • Supported Platforms

    Percona Operator for MongoDB 1.12.0¶

    • Date

      May 5, 2022

    • Installation

      Installing Percona Operator for MongoDB

    Release Highlights¶

    • With this release, the Operator turns to a simplified naming convention and changes its official name to Percona Operator for MongoDB

    • The Operator is able now to use the Amazon Web Services feature of authenticating applications running on EC2 instances based on Identity and Access Management (IAM) roles assigned to the instance; this makes it possible to configure S3 backup on AWS without using IAM keys saved in Secrets

    • This release brings support for the Multi Cluster Services (MCS). This allows users to deploy MongoDB with Percona Operator across multiple Kubernetes clusters using MCS, which extends the reach of the Service object beyond one cluster, so one Service can be used across multiple clusters. It can be used to provide disaster recovery or perform a migration for MongoDB clusters.

    • The OpenAPI schema is now generated for the Operator , which allows Kubernetes to perform Custom Resource validation and saves user from occasionally applying deploy/cr.yaml with syntax typos

    New Features¶

    • K8SPSMDB-185: Allow using AWS EC2 instances for backups with IAM roles assigned to the instance instead of using stored IAM credentials (Thanks to Oleksii for reporting this issue)

    • K8SPSMDB-625: Integrate the Operator with Multi Cluster Services (MCS)

    • K8SPSMDB-668: Adding support for enabling replication over a service mesh (Thanks to Jo Lyshoel for contribution)

    Improvements¶

    • K8SPSMDB-473: Allow to skip TLS verification for backup storage, useful for self-hosted S3-compatible storage with a self-issued certificate

    • K8SPSMDB-644: Make cacheSizeRatio parameter available as a custom value in psmdb-db-1.11.0 helm chart (Thanks to Richard CARRE for reporting this issue)

    • K8SPSMDB-574: Allow user to choose the validity duration of the external certificate for cert manager

    • K8SPSMDB-634: Support point-in-time recovery compression levels for backups (Thanks to Damiano Albani for reporting this issue)

    • K8SPSMDB-570: The Operator documentation now includes a How-To on using Percona Server for MongoDB with LDAP authentication and authorization

    • K8SPSMDB-537: PMM container does not cause the crash of the whole database Pod if pmm-agent is not working properly

    • K8SPSMDB-684: Generate OpenAPI schema for and validate Custom Resource

    Bugs Fixed¶

    • K8SPSMDB-597: Fix a bug in the Operator helm chart which caused deleting the watched Namespace on uninstall (Thanks to Andrei Nistor for reporting this issue)

    • K8SPSMDB-640: Fix a regression which prevented labels from being applied to Pods after the Custom Resource change

    • K8SPSMDB-583: Fix a bug which caused backup crashing if spec.mongod.net.port not set or set to zero

    • K8SPSMDB-540 and K8SPSMDB-563: Fix a bug which could cause a cluster crash when reducing the configured Replicaset size between deletion and re-creation of the cluster

    • K8SPSMDB-608: Fix a bug due to which the password of backup user was printed in backup agent logs (Thanks to Antoine Ozenne for reporting this issue)

    • K8SPSMDB-599: A new mongos.expose.servicePerPod option allows deploying a separate ClusterIP Service for each mongos instance, which prevents the failure of a multi-threaded transaction executed with the same driver instance and ended up on a different mongos. Starting from this release, mongos is deployed by StatefulSet instead of Deployment object

    • K8SPSMDB-656: Fix a bug which caused cluster name being not displayed in the backup Custom Resource output with psmdbCluster set in the backup spec

    • K8SPSMDB-653: Fix a bug due to which spec.ImagePullPolicy options from deploy/cr.yaml wasn’t applied to backup and pmm-client images

    • K8SPSMDB-632: Fix a bug which caused the Operator to perform Smart Update on the initial deployment

    • K8SPSMDB-624: Fix a bug due to which the Operator didn’t grant enough permissions to the Cluster Monitor user necessary for Percona Monitoring and Management (PMM) (Thanks to Richard CARRE for reporting this issue)

    • K8SPSMDB-618: Improve security and meet compliance requirements by building MongoDB Operator based on Red Hat Universal Base Image (UBI) 8 instead of UBI 7

    • K8SPSMDB-602: Fix a thread leak in a mongod container of the Replica Set Pods, which occurred when setting setFCV flag to true in Custom Resource

    • K8SPSMDB-560: Fix a bug due to which serviceName tag was not set to all members in the Replica Set

    • K8SPSMDB-533: Fix a bug due to which setting password with a special character for a system user was breaking the cluster

    Known Issues¶

    • K8SPSMDB-686: The Operator versions 1.11.0 and 1.12.0 can not be downscaled from a sharding to non-sharding/Replica Set configuration on Google Kubernetes Engine (GKE) 1.19-1.21 (GKE 1.22 is not affected)

    Deprecation, Rename and Removal¶

    • K8SPSMDB-596: The spec.mongod section is removed from the Custom Resource configuration. Starting from now, mongod options should be passed to Replica Sets using spec.replsets.[].configuration key, except the following 3 options:

      • mongod.security.encryptionKeySecret key was left in a deprecated state in favor of the new spec.secrets.encryptionKey option

      • mongod.storage.wiredTiger.engineConfig.cacheSizeRatio and mongod.storage.inMemory.engineConfig.inMemorySizeRatio options are now only available from the replsets.storage section

    Before the upgrade, please ensure that you have moved all custom MongoDB parameters to proper places!

    • K8SPSMDB-228: The spec.psmdbCluster option in the example on-demand backup configuration file backup/backup.yaml was renamed to spec.clusterName (psmdbCluster will be valid till 1.15 version)

    Supported Platforms¶

    The following platforms were tested and are officially supported by the Operator 1.12.0:

    • OpenShift 4.7 - 4.10

    • Google Kubernetes Engine (GKE) 1.19 - 1.22

    • Amazon Elastic Container Service for Kubernetes (EKS) 1.19 - 1.22

    • Minikube 1.23

    This list only includes the platforms that the Percona Operators are specifically tested on as part of the release process. Other Kubernetes flavors and versions depend on the backward compatibility offered by Kubernetes itself.

    Contact Us

    For free technical help, visit the Percona Community Forum.

    To report bugs or submit feature requests, open a JIRA ticket.

    For paid support and managed or consulting services , contact Percona Sales.

    Last update: 2023-05-23
    Percona LLC and/or its affiliates, © 2009 - 2023
    Made with Material for MkDocs

    Cookie consent

    We use cookies to recognize your repeated visits and preferences, as well as to measure the effectiveness of our documentation and whether users find what they're searching for. With your consent, you're helping us to make our documentation better.