Project: KubeBlocks by ApeCloud (App Definition and Development / Database)
File: v0.5.0.md

We're happy to announce the release of KubeBlocks 0.5.0! This release introduces Redis, a key-value database, and MongoDB, a document-based database. It also supports the primary-secondary topology of PostgreSQL, adapts to more public cloud vendors' hosted Kubernetes versions, improves data backup and recovery experiences, and builds basic data migration capability. We noticed that some users may think that K8s reduces database performance. So in this release we include a comparison test result to explain the throughput and RT differences of various MySQL 8.0 deployment forms on AWS. We would like to extend our appreciation to all contributors who helped make this release happen. KubeBlocks supports the primary-secondary topology of PostgreSQL Users can actively switch the primary-secondary role of the database cluster with kbcli, or passively trigger failover by deleting a specified Kubernetes pod with kubectl. Failover generally completes within 30 seconds when there are no long transactions and large table DDLs. KubeBlocks supports Redis v7.0 Redis is currently the most popular open-source key-value database, supporting data types such as key-value, string, list, set, hash table, and ordered set. It provides extremely fast data read and write operations and is suitable for cache scenarios in e-commerce, social communication, game, and other internet applications. To provide stable, secure, and efficient Redis services to users, KubeBlocks has adopted Redis 7.0 version, which is currently recommended officially, supporting standalone and primary-secondary topologies. Thus, users can perform operations such as creating, deleting, scaling, backing up, restoring, monitoring, alerting, and changing parameters of Redis clusters in development, testing, and production environments. KubeBlocks supports MongoDB v5.0 MongoDB is currently the most popular document-based database, using JSON data types and dynamic schema designs to maintain high flexibility and scalability. KubeBlocks supports the replica set topology of MongoDB v5.0, providing data redundancy and automatic failover capabilities, ensuring data availability and consistency in the event of a node failure. The replica set topology cluster has one primary node (Primary) and several secondary nodes (Secondary), with the primary node handling all write requests and the secondary nodes handling some read requests. If the primary node fails, one of the secondary nodes is elected as the new primary node. KubeBlocks supports the private deployment of ChatGPT retrieval plugin For users who do not want to expose sensitive information (such as company documents, meeting minutes, emails), OpenAI has open-sourced the ChatGPT retrieval plugin to enhance the ChatGPT experience. As long as users meet OpenAI's requirements, they can run the ChatGPT retrieval plugin through KubeBlocks addon, store the vectorized data of sensitive information in a private database, and enable ChatGPT to have longer memory of the context while ensuring information

KubeBlocks supports one-command launching of playgrounds on Alibaba Cloud, Tencent Cloud, and GCP Public cloud vendors' hosted Kubernetes services have significant differences in version, functionality, and integration, so even if the deployment of stateful services is not difficult, but Kubernetes administrators have to do a lot of extra heavy lifting to run stateful services normally. After supporting AWS, KubeBlocks provides the ability to one-command launch playgrounds on Alibaba Cloud, Tencent Cloud, and GCP. Users only need to set up public cloud AK locally, and then execute the kbcli playground init command, and KubeBlocks will automatically apply for resources and configure permissions in the specified region, making it easy for users to experience complete functionality. After trying KubeBlocks out, you can clean up the playground environment with one command to avoid incurring costs. Breaking changes between v0.5 and v0.4. Uninstall v0.4 (including any older version) before installing v0.5. Move the backupPolicyTemplate API from dataprotection group to apps group. Before installing v0.5, please ensure that the resources have been cleaned up: ``` kubectl delete backuppolicytemplates.dataprotection.kubeblocks.io --all kubectl delete backuppolicies.dataprotection.kubeblocks.io --all ``` redefines the phase of cluster and component. Before installing v0.5, please ensure that the resources have been cleaned up: ``` kubectl delete clusters.apps.kubeblocks.io --all kubectl delete opsrequets.apps.kubeblocks.io --all ``` `addons.extensions.kubeblocks.io` API deleted `spec.helm.valuesMapping.jsonMap.additionalProperties`, `spec.helm.valuesMapping.valueMap.additionalProperties`, `spec.helm.valuesMapping.extras.jsonMap.additionalProperties` and `spec.helm.valuesMapping.extras.valueMap.additionalProperties` attributes that was introduced by CRD generator, all existing Addons API YAML shouldn't have referenced these attributes. Limitations of cluster's horizontal scale operation: Only support VolumeSnapshot API to make a clone of Cluster's PV for syncing data when horizontal scaling. Only 1st pod container and 1st volume mount associated PV will be processed for VolumeSnapshot, do assure that data volume is placed in 1st pod container's 1st volume mount. Unused PVCs will be deleted in 30 minutes after scale in. If you're new to KubeBlocks, visit the page and get a quick start with KubeBlocks. Note: This release contains a few . See section to upgrade KubeBlocks to version 0.5.0. Thanks to everyone who made this release possible! @1aal, @free6om, @heng4fun, @iziang, @kizuna-lek, @ldming, @nashtsai, @nayutah, @sophon-zt, @TalktoCrystal, @xuriwuyun, @Y-Rookie, @yangmeilly, @ZhaoDiankui Support ZEngine storage engine Account management supports creating, modifying, and deleting database accounts with different permissions PostgreSQL Support migration from AWS RDS to KubeBlocks, supporting pre-checks, full migration, and incremental synchronization, verifying the data migration capabilities of CadenceWorkflow and OpenStreetMap Support for pgvector extension Support for the primary-secondary topology of PostgreSQL Automated failover and self-healing Support point-in-time recovery Account management supports creating, modifying, and deleting database accounts with different permissions Full lifecycle management, including creation, deletion, restart, horizontal/vertical scaling Support Redis primary-secondary topology Automated failover and self-healing Support snapshot backup and recovery Metric monitoring, including cluster's basic operation status, connection, OS resources, performance, primary-secondary replication status and other metrics Alerts including cluster downtime, OS resource, abnormal connection number, primary-secondary replication abnormality,

Parameter reconfigure Account management Full lifecycle management, including creation, deletion, restart, vertical scaling, and disk expansion Endpoint exposes the access addresses of all nodes File-based full backup and recovery Automated failover and self-healing Monitoring, alerting and logs Parameter reconfigure add support of Redis cluster (, @heng4fun) add support of ApeCloud MySQL-Scale (Vitess) cluster (, @ZhaoDiankui) add support of MongoDB cluster (, , @xuriwuyun) kbcli playground add supports of more cloud providers (, @ldming) add support of standalone Milvus DB (VectorDB) (, @nayutah) PostgreSQL add support of pgvector extension (, @ldming) complete cleanup of KubeBlocks for playground destroy (, @ldming) Addon resources add failed pod logs to status condition errors and events (, @nashtsai) cli playground use default kubeconfig file (, @ldming) update running check (, @xuriwuyun) set cluster default storage size to 20Gi (, @ldming) cli kubeblocks upgrade command output dashboard info (, @ldming) set default storage size to 10Gi for TKE (, @ldming) cli playground pull latest cloud provider repo (, @ldming) cli playground does not output error message when kubernetes cluster is not ready (, @ldming) github action uploads kbcli asset for windows and add powershell script to install on windows (, @1aal) trim single quotes for the parameters value in the pg config file (#2523) (, @sophon-zt) config change does not take effect (#2511) (, @sophon-zt) KBMYSQLFOLLOWERS env inconsistent with cluster status after scale-in (, @free6om) BackupPolicyTemplate name of mysql-scale error (, @ZhaoDiankui) probe pg checkrole (, @xuriwuyun) adjust vtgate healthcheck options (, @ZhaoDiankui) add secure sql type (, @kizuna-lek) take cluster cmd 'kbcli cluster update --enabled-all-logs' effect (, @yangmeilly) h-scale pvc unexpected deleting (, @free6om) support mongodb backup (, @xuriwuyun) replicationSet cluster stop failed fix (, @Y-Rookie) h-scale pvc unexpected deleting (#2680) (, @free6om) mongodb support addon (, @xuriwuyun) mongodb support addon (#2758) (, @xuriwuyun) h-scale volumesnapshot unexpected deleted (, @free6om) set driver for bench config (, @ldming) h-scale pvc pending with WaitForFirstConsumer (, @free6om) cli list-instances throw error when node is not found (, @ldming) wrong viper setting in ut (, @free6om) mysql cluster execute ops VolumeExpansion Failed (, @free6om) cluster always updating after termination-policy updated (, @free6om) h-scale too many backup error warning events (, @free6om) some command examples can not be executed (, @ldming) adjust dependency resource deletion order when cluster deletion (, @Y-Rookie) mongodb restart alert title is incorrect (#3171) (, @yangmeilly) observed generation wrong patched (, @free6om) cli playground failed (, @ldming) lifecycle dag (, @free6om) add cluster default webhook for `PrimaryIndex` (, @heng4fun) refactor labels usage (, @heng4fun) update probe mysql tests (, @xuriwuyun) update pg probe url (, @xuriwuyun) cli support to output addon install progress (, @ldming) rewrite overview (, @TalktoCrystal) move loadbalancer sub-module to a separate repo https (, @iziang) use gitlab helm repo if failed to get ip location (, @ldming) update redis role probe (, @xuriwuyun) update mongodb helm (, @xuriwuyun) kbcli support mongodb (, @xuriwuyun) support xengine for apecloud-mysql (, @sophon-zt) support postgresql 14.7 instead of

(, @ldming) improve cluster create examples (, @ldming) ut for nil backup policy (, @free6om) sqlchannel add test (, @xuriwuyun) configure does not take effect (, @sophon-zt) remove default postgresql metrics service and optimize redis sentinel configuration (, @Y-Rookie) cli set default cluster value based on workload and component type (, @ldming) disable hook when uninstall KubeBlocks (, @ldming) refine kbcli for mongodb (, @xuriwuyun) refine kbcli for mongodb (#2834) (, @xuriwuyun) improve cli cluster describe (, @ldming) refine kbcli for mongodb (, @xuriwuyun) cli supports to create additional resource for postgresql (, @ldming) add kbcli connect example support for mongodb (, @xuriwuyun) improve kubeblocks install and uninstall command (, @ldming) local playground with one replica (, @ldming) improve ApeCloud mysql description (, @ldming) `kbcli playground` supports one-command launching on running environments of Alibaba Cloud, Tencent Cloud, and GCP to experience complete KubeBlocks functionality kbcli supports creating clusters by entering CPU, memory, or class type kbcli supports tagging related resources of cluster kbcli is compatible with macOS package manager `brew` kbcli supports `preflight` command to check whether the environment meets the requirements for installing KubeBlocks kbcli adds object storage addon for storing full file backups, logs, and other data `kbcli install` runs preflight to check whether the environment meets the requirements, including node taints, storage class, and other check rules kbcli addon adds timeout parameter, printing exception information when enable fails Addon inherits the affinity and tolerations configuration of KubeBlocks `kbcli uninstall` prompts information to delete backup files, printing log information if the deletion fails ClusterDefinition API `spec.connectionCredential` add following built-in variables: Headless service FQDN `$(HEADLESSSVCFQDN)` placeholder, value pattern - `$(CLUSTERNAME)-$(1STCOMPNAME)-headless.$(NAMESPACE).svc`, where 1STCOMP_NAME is the 1st component that provide `ClusterDefinition.spec.componentDefs[].service` attribute Compatible with AWS EKS v1.22/v1.23/v1.24/v1.25 Compatible with Alibaba Cloud ACK v1.22/v1.24 Compatible with Tencent Cloud TKE standard cluster v1.22/v1.24 Compatible with GCP GKE standard cluster v1.24/v1.25 KubeBlocks limits the combination of CPU and memory to avoid unreasonable configurations that reduce resource utilization or system stability High-availability MySQL 8.0 with 4C 8GB 500GB, throughput and RT differences of various products on AWS, including ApeCloud MySQL Raft group, AWS RDS operator, Operator for Percona Server for MySQL, Oracle MySQL Operator for Kubernetes New APIs: backuppolicytemplates.apps.kubeblocks.io componentclassdefinitions.apps.kubeblocks.io componentresourceconstraints.apps.kubeblocks.io Deleted APIs: backuppolicytemplates.dataprotection.kubeblocks.io New API attributes: clusterdefinitions.apps.kubeblocks.io API spec.type spec.componentDefs.customLabelSpecs clusterversions.apps.kubeblocks.io API spec.componentVersions.clientImage (EXPERIMENTAL) clusters.apps.kubeblocks.io API spec.componentSpecs.classDefRef spec.componentSpecs.serviceAccountName configconstraints.apps.kubeblocks.io API spec.reloadOptions.shellTrigger.namespace spec.reloadOptions.shellTrigger.scriptConfigMapRef spec.reloadOptions.tplScriptTrigger.sync spec.selector opsrequests.apps.kubeblocks.io API spec.restoreFrom spec.verticalScaling.class status.reconfiguringStatus.configurationStatus.updatePolicy backuppolicies.dataprotection.kubeblocks.io API spec.full spec.logfile spec.retention backups.dataprotection.kubeblocks.io status.manifests backuptools.dataprotection.kubeblocks.io spec.type Renamed API attributes: clusterdefinitions.apps.kubeblocks.io API spec.componentDefs.horizontalScalePolicy.backupTemplateSelector -> spec.componentDefs.horizontalScalePolicy.backupPolicyTemplateName spec.componentDefs.probe.roleChangedProbe -> spec.componentDefs.probe.roleProbe backuppolicies.dataprotection.kubeblocks.io API spec.full restorejobs.dataprotection.kubeblocks.io API spec.target.secret.passwordKeyword -> spec.target.secret.passwordKey spec.target.secret.userKeyword -> spec.target.secret.usernameKey addons.extensions.kubeblocks.io API spec.helm.installValues.secretsRefs -> spec.helm.installValues.secretRefs Deleted API attributes: opsrequests.apps.kubeblocks.io API status.observedGeneration backuppolicies.dataprotection.kubeblocks.io API spec.backupPolicyTemplateName spec.backupToolName spec.backupType spec.backupsHistoryLimit spec.hooks spec.incremental backups.dataprotection.kubeblocks.io API spec.ttl status.CheckPoint status.checkSum addons.extensions.kubeblocks.io API spec.helm.valuesMapping.jsonMap.additionalProperties spec.helm.valuesMapping.valueMap.additionalProperties spec.helm.valuesMapping.extras.jsonMap.additionalProperties spec.helm.valuesMapping.extras.valueMap.additionalProperties Updates API Status info: clusters.apps.kubeblocks.io API status.components.phase valid values are Running, Stopped, Failed, Abnormal, Creating, Updating; REMOVED phases are SpecUpdating, Deleting, Deleted, VolumeExpanding, Reconfiguring, HorizontalScaling, VerticalScaling, VersionUpgrading, Rebooting, Stopping, Starting. status.phase valid values are Running, Stopped, Failed, Abnormal, Creating, Updating; REMOVED phases are ConditionsError, SpecUpdating, Deleting, Deleted, VolumeExpanding, Reconfiguring, HorizontalScaling, VerticalScaling, VersionUpgrading, Rebooting, Stopping, Starting. opsrequests.apps.kubeblocks.io API status.components.phase valid values are Running, Stopped, Failed, Abnormal, Creating, Updating; REMOVED phases are SpecUpdating, Deleting, Deleted, VolumeExpanding, Reconfiguring, HorizontalScaling, VerticalScaling, VersionUpgrading, Rebooting, Stopping, Starting, Exposing. status.phase added 'Creating' phase. N/A if upgrading from 0.4 or older version.