kubeblocks

KubeBlocks is an open-source control plane software that runs and manages databases, message queues and other stateful applications on K8s.

AGPL-3.0 License

Stars
1.9K
View Code on GitHub Visit Website
Ecosystems: Kubernetes, MongoDB, MySQL, Redis, PostgreSQL

Bot releases are visible (Hide)

kubeblocks - KubeBlocks v0.6.0-alpha.22

Published by apecloud-bot over 1 year ago

What's Changed

Full Changelog: https://github.com/apecloud/kubeblocks/compare/v0.6.0-alpha.21...v0.6.0-alpha.22

kubeblocks - KubeBlocks v0.5.2

Published by apecloud-bot over 1 year ago

What's Changed

New Contributors

Full Changelog: https://github.com/apecloud/kubeblocks/compare/v0.5.1...v0.5.2

kubeblocks - KubeBlocks v0.5.1

Published by apecloud-bot over 1 year ago

KubeBlocks 0.5.1

We're happy to announce the release of KubeBlocks 0.5.1! 🚀 🎉 🎈

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.

Highlights

  • 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 security.
  • 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

  • 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.

Known issues and limitations

  • 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 getting started page and get a quick start with KubeBlocks.

Note: This release contains a few breaking changes.

See this section to upgrade KubeBlocks to version 0.5.0.

Acknowledgements

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

What's Changed

New Features

MySQL

  • 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

Redis

  • 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, etc.
  • Parameter reconfigure
  • Account management

MongoDB

  • 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

Improvements

  • add support of Redis cluster (#1886, @heng4fun)
  • add support of ApeCloud MySQL-Scale (Vitess) cluster (#2116, @ZhaoDiankui)
  • add support of MongoDB cluster (#2182, #2682, @xuriwuyun)
  • kbcli playground add supports of more cloud providers (#2241, @ldming)
  • add support of standalone Milvus DB (VectorDB) (#2310, @nayutah)
  • PostgreSQL add support of pgvector extension (#2406, @ldming)
  • complete cleanup of KubeBlocks for playground destroy (#2457, @ldming)
  • Addon resources add failed pod logs to status condition errors and events (#3058, @nashtsai)

Bug Fixes

  • cli playground use default kubeconfig file (#2150, @ldming)
  • update running check (#2174, @xuriwuyun)
  • set cluster default storage size to 20Gi (#2254, @ldming)
  • cli kubeblocks upgrade command output dashboard info (#2290, @ldming)
  • set default storage size to 10Gi for TKE (#2317, @ldming)
  • cli playground pull latest cloud provider repo (#2373, @ldming)
  • cli playground does not output error message when kubernetes cluster is not ready (#2391, @ldming)
  • github action uploads kbcli asset for windows and add powershell script to install on windows (#2449, @1aal)
  • trim single quotes for the parameters value in the pg config file (#2523) (#2527, @sophon-zt)
  • config change does not take effect (#2511) (#2543, @sophon-zt)
  • KB_MYSQL_FOLLOWERS env inconsistent with cluster status after scale-in (#2565, @free6om)
  • BackupPolicyTemplate name of mysql-scale error (#2583, @ZhaoDiankui)
  • probe pg checkrole (#2638, @xuriwuyun)
  • adjust vtgate healthcheck options (#2650, @ZhaoDiankui)
  • add secure sql type (#2656, @kizuna-lek)
  • take cluster cmd 'kbcli cluster update --enabled-all-logs' effect (#2663, @yangmeilly)
  • h-scale pvc unexpected deleting (#2680, @free6om)
  • support mongodb backup (#2683, @xuriwuyun)
  • replicationSet cluster stop failed fix (#2691, @Y-Rookie)
  • h-scale pvc unexpected deleting (#2680) (#2730, @free6om)
  • mongodb support addon (#2758, @xuriwuyun)
  • mongodb support addon (#2758) (#2764, @xuriwuyun)
  • h-scale volumesnapshot unexpected deleted (#2789, @free6om)
  • set driver for bench config (#2804, @ldming)
  • h-scale pvc pending with WaitForFirstConsumer (#2836, @free6om)
  • cli list-instances throw error when node is not found (#2936, @ldming)
  • wrong viper setting in ut (#2937, @free6om)
  • mysql cluster execute ops VolumeExpansion Failed (#2950, @free6om)
  • cluster always updating after termination-policy updated (#2956, @free6om)
  • h-scale too many backup error warning events (#2964, @free6om)
  • some command examples can not be executed (#3034, @ldming)
  • adjust dependency resource deletion order when cluster deletion (#3065, @Y-Rookie)
  • mongodb restart alert title is incorrect (#3171) (#3173, @yangmeilly)
  • observed generation wrong patched (#3184, @free6om)
  • cli playground failed (#3240, @ldming)

Miscellaneous

  • lifecycle dag (#1571, @free6om)
  • add cluster default webhook for PrimaryIndex (#1677, @heng4fun)
  • refactor labels usage (#1696, @heng4fun)
  • update probe mysql tests (#1808, @xuriwuyun)
  • update pg probe url (#2115, @xuriwuyun)
  • cli support to output addon install progress (#2132, @ldming)
  • rewrite overview (#2266, @TalktoCrystal)
  • move loadbalancer sub-module to a separate repo https (#2354, @iziang)
  • use gitlab helm repo if failed to get ip location (#2421, @ldming)
  • update redis role probe (#2554, @xuriwuyun)
  • update mongodb helm (#2575, @xuriwuyun)
  • kbcli support mongodb (#2580, @xuriwuyun)
  • support xengine for apecloud-mysql (#2608, @sophon-zt)
  • support postgresql 14.7 instead of 15.2 (#2613, @ldming)
  • improve cluster create examples (#2641, @ldming)
  • ut for nil backup policy (#2654, @free6om)
  • sqlchannel add test (#2694, @xuriwuyun)
  • configure does not take effect (#2735, @sophon-zt)
  • remove default postgresql metrics service and optimize redis sentinel configuration (#2741, @Y-Rookie)
  • cli set default cluster value based on workload and component type (#2743, @ldming)
  • disable hook when uninstall KubeBlocks (#2795, @ldming)
  • refine kbcli for mongodb (#2834, @xuriwuyun)
  • refine kbcli for mongodb (#2834) (#2841, @xuriwuyun)
  • improve cli cluster describe (#2860, @ldming)
  • refine kbcli for mongodb (#2927, @xuriwuyun)
  • cli supports to create additional resource for postgresql (#3009, @ldming)
  • add kbcli connect example support for mongodb (#3023, @xuriwuyun)
  • improve kubeblocks install and uninstall command (#3053, @ldming)
  • local playground with one replica (#3255, @ldming)
  • improve ApeCloud mysql description (#3292, @ldming)

Easy of Use

  • 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 $(HEADLESS_SVC_FQDN) placeholder, value pattern - $(CLUSTER_NAME)-$(1ST_COMP_NAME)-headless.$(NAMESPACE).svc, where 1ST_COMP_NAME is the 1st component that provide ClusterDefinition.spec.componentDefs[].service attribute

Compatibility

  • 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

Stability

  • KubeBlocks limits the combination of CPU and memory to avoid unreasonable configurations that reduce resource utilization or system stability

Performance

  • 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

API changes

  • 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.

Upgrading to KubeBlocks 0.5.1

  • N/A if upgrading from 0.4 or older version.
Package Rankings
Top 6.27% on Proxy.golang.org
Badges
Extracted from project README
Documentation status OpenSSF Best Practices CICD Push CodeQL Releases Release LICENSE Go Report Card Docker Pulls Codecov Artifact Hub
Related Projects
database-lab

DBLab Engine enables 🖖 database branching and ⚡️ thin cloning for any Postgres database and empow...

23 Oct 2019 335
cube

📊 Cube — The Semantic Layer for Building Data Applications

16 Sep 2018 17,825
database-lab-engine

DBLab enables 🖖 database branching and ⚡️ thin cloning for any Postgres database and empowers DB ...

09 Jun 2020 2,091