{"id":13560886,"url":"https://github.com/apecloud/kubeblocks","last_synced_at":"2026-03-12T10:17:55.379Z","repository":{"id":173017917,"uuid":"527483772","full_name":"apecloud/kubeblocks","owner":"apecloud","description":"KubeBlocks is an open-source control plane software that runs and manages databases, message queues and other stateful applications on K8s.","archived":false,"fork":false,"pushed_at":"2025-05-12T01:51:08.000Z","size":87328,"stargazers_count":2676,"open_issues_count":178,"forks_count":208,"subscribers_count":28,"default_branch":"main","last_synced_at":"2025-05-12T13:08:46.687Z","etag":null,"topics":["database","dbaas","dbpaas","kafka","kubernetes","mongodb","mysql","operator","postgresql","redis"],"latest_commit_sha":null,"homepage":"https://kubeblocks.io","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"agpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/apecloud.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"docs/CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":"SECURITY.md","support":null,"governance":"GOVERNANCE.md","roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2022-08-22T08:53:25.000Z","updated_at":"2025-05-12T10:25:32.000Z","dependencies_parsed_at":"2023-09-26T10:14:39.184Z","dependency_job_id":"0dda7b96-3a0b-41ae-9d83-cedd78f0c7b8","html_url":"https://github.com/apecloud/kubeblocks","commit_stats":null,"previous_names":["apecloud/kubeblocks"],"tags_count":537,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/apecloud%2Fkubeblocks","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/apecloud%2Fkubeblocks/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/apecloud%2Fkubeblocks/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/apecloud%2Fkubeblocks/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/apecloud","download_url":"https://codeload.github.com/apecloud/kubeblocks/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253745160,"owners_count":21957317,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["database","dbaas","dbpaas","kafka","kubernetes","mongodb","mysql","operator","postgresql","redis"],"created_at":"2024-08-01T13:00:50.524Z","updated_at":"2025-12-30T12:31:48.355Z","avatar_url":"https://github.com/apecloud.png","language":"Go","readme":"# Welcome to the KubeBlocks project!\n\n[![OpenSSF Best Practices](https://bestpractices.coreinfrastructure.org/projects/7544/badge)](https://bestpractices.coreinfrastructure.org/projects/7544)\n[![CICD Push](https://github.com/apecloud/kubeblocks/actions/workflows/cicd-push.yml/badge.svg)](https://github.com/apecloud/kubeblocks/actions/workflows/cicd-push.yml)\n[![CodeQL](https://github.com/apecloud/kubeblocks/actions/workflows/codeql.yml/badge.svg)](https://github.com/apecloud/kubeblocks/actions/workflows/codeql.yml)\n[![Releases](https://github.com/apecloud/kubeblocks/workflows/RELEASE-VERSION/badge.svg)](https://github.com/apecloud/kubeblocks/actions/workflows/release-version.yml)\n[![Release](https://img.shields.io/github/v/release/apecloud/kubeblocks)](https://github.com/apecloud/kubeblocks/releases/latest)\n[![LICENSE](https://img.shields.io/github/license/apecloud/kubeblocks.svg?style=flat-square)](/LICENSE)\n[![Go Report Card](https://goreportcard.com/badge/github.com/apecloud/kubeblocks)](https://goreportcard.com/report/github.com/apecloud/kubeblocks)\n[![Docker Pulls](https://img.shields.io/docker/pulls/apecloud/kubeblocks)](https://hub.docker.com/r/apecloud/kubeblocks)\n[![Codecov](https://codecov.io/gh/apecloud/kubeblocks/branch/main/graph/badge.svg?token=GEH4I1C80Y)](https://codecov.io/gh/apecloud/kubeblocks)\n![maturity](https://img.shields.io/static/v1?label=maturity\u0026message=alpha\u0026color=red)\n[![Artifact Hub](https://img.shields.io/endpoint?url=https://artifacthub.io/badge/repository/kubeblocks)](https://artifacthub.io/packages/search?repo=kubeblocks)\n\n![image](./docs/img/banner-readme.jpeg)\n\n## Motivation\n\nIf you are a developer using multiple types of databases in your application and are considering deploying both your application and databases on K8s for cost or efficiency reasons, you need to find suitable operators for each database. Learning so many different operators and their APIs introduces a significant learning curve and time costs, not to mention the effort required to maintain them.\n\nKubeBlocks uses a unified set of APIs (CRDs) and code to manage various databases on K8s. For example, we can use the `Cluster` resource to create a PostgreSQL cluster, a Redis cluster, or a Kafka cluster. This abstraction and unified API allow us to further use a single set of operator code to manage multiple types of databases, as well as handle day-2 operations, theoretically extending to any type of database engine.\n\n## What is KubeBlocks\n\nKubeBlocks is an open-source control plane software that runs and manages multiple popular database engines on K8s through a unified set of code and APIs. The core of KubeBlocks is a K8s operator, which defines a set of CRDs to abstract the common attributes of various database engines and uses these abstractions to manage the engine's lifecycle and day-2 operations.\n\nKubeBlocks manages various types of stateful engines, including RDBMSs (MySQL, PostgreSQL), Caches(Redis), NoSQLs (MongoDB), MQs(Kafka, Pulsar), vector databases(Milvus, Qdrant, Weaviate), and data warehouses(ClickHouse, ElasticSearch, OpenSearch, Doris, StarRocks). Adding a new engine to KubeBlocks can be achieved by writing a KubeBlocks Addon. The community is actively integrating more types of engines into KubeBlocks, and it currently supports 35 types of engines.\n\nThe name KubeBlocks is inspired by Kubernetes and LEGO blocks, signifying that through the KubeBlocks API, adding, composing and managing database engines on K8s can be easy, standard and productive, like playing with LEGO blocks.\n\n### Why you need KubeBlocks\n\nKubeBlocks integrates the most popular database engines and provides rich management functions, along with declarative APIs, in various environments. KubeBlocks offers the following benefits:\n\n* Production-level\n\n  KubeBlocks has already been adopted by large internet companies, private clouds, the financial industry including banks and securities firms, telecom industry, the automotive industry, and SaaS software providers.\n\n* Reliability\n\n  KubeBlocks supports the integration of various mature high-availability best practices, such as Orchestrator, Patroni, and Sentinel. KubeBlocks also supports full backups, continuous backups, and point-in-time recovery (PITR).\n\n* Ease of use\n\n  KubeBlocks not only provides a YAML-based API but also offers an interactive `kbcli` tool to further simplify usage as a complement to `kubectl`. For example, you can install KubeBlocks and launch a playground environment on a desktop or cloud with a single command.\n\n* Observability\n\n  KubeBlocks collects monitoring metrics from rich data sources, integrates with the Prometheus stack, and provides insightful Grafana templates. In addition, troubleshooting tools such as slow logs are also provided.\n\n* Extensibility\n\n  KubeBlocks provides the addon mechanism for integrating new engines. So it can be extended to run the databases your project needs.\n\n### Goals\n\n- Smoothing the learning curve of managing various databases on K8s\n- Exploring standard APIs for managing databases on Kubernetes\n- Being open and cloud-neutral, as well as engine-neutral\n\n### Key features\n\n- Supports various databases, including MySQL, PostgreSQL, Redis, MongoDB, Kafka, Clickhouse, ElasticSearch and more\n- Provides production-level performance, resilience, and observability\n- Simplifies day-2 operations, such as upgrading, scaling, monitoring, backup, and restore\n- Contains a powerful and intuitive command line tool\n- Be compatible with AWS, GCP, Azure, Alibaba Cloud and more CSP\n\n## Get started with KubeBlocks\n\n[Quick Start](https://kubeblocks.io/docs/preview/user_docs/overview/install-kubeblocks) shows you the quickest way to get started with KubeBlocks.\n\n## Resources\n\n[API Reference](https://kubeblocks.io/docs/preview/user_docs/references/api-reference/cluster)\n\n[KubeBlocks: Cloud-Native Data Infrastructure for Kubernetes](https://www.youtube.com/watch?v=KNwpG51Whzg) (A Video made by Viktor Farcic)\n\n[KubeBlocks Enterprise Demo](https://console.kubeblocks.io/)\n\n## KubeBlocks at KubeCon\n\nKubeCon 2024 in HongKong from 21-23 August 2024: [How to Manage Database Clusters Without a Dedicated Operator, By Shanshan Ying, ApeCloud \u0026 Shun Ding, China Mobile Cloud](https://kccncossaidevchn2024.sched.com/event/1eYYL/how-to-manage-database-clusters-without-a-dedicated-operator-nanoxi-operatorzha-fa-lia-zhong-shi-shanshan-ying-apecloud-shun-ding-china-mobile-cloud)\n\nKubeCon 2024 in HongKong from 21-23 August 2024: [KuaiShou's 100% Resource Utilization Boost: 100K Redis Migration from Bare Metal to Kubernetes, By XueQiang Wu, ApeCloud \u0026 YuXing Liu, Kuaishou](https://kccncossaidevchn2024.sched.com/event/1eYat/kuaishous-100-resource-utilization-boost-100k-redis-migration-from-bare-metal-to-kubernetes-zha-100pian-zhi-yi-daeplie-hui-zhe-100k-rediskubernetes-xueqiang-wu-apecloud-yuxing-liu-kuaishou)\n\n## Community\n\nIf you have any questions, you can reach out to us through:\n\n- KubeBlocks [Slack Channel](https://join.slack.com/t/kubeblocks/shared_invite/zt-2pjob3ezp-FzaZM7NId~Tbzp6PYNbOzQ)\n- KubeBlocks GitHub [Discussions](https://github.com/apecloud/kubeblocks/discussions)\n- KubeBlocks Wechat Account:\n\n   \u003cimg src=\".\\docs\\img\\wechat-assistant.jpg\" alt=\"wechat\" width=\"100\" height=\"100\"\u003e\n\nYou can also follow us on:\n\n- [Twitter](https://x.com/KubeBlocks)\n- [LinkedIn](https://www.linkedin.com/company/apecloud-ptd-ltd/)\n\n## Contributing to KubeBlocks\n\nYour contributions are welcomed and appreciated.\n\n- See the [Contributor Guide](docs/CONTRIBUTING.md) for details on typical contribution workflows.\n- See the [Developer Guide](docs%2F00%20-%20index.md) to get started with building and developing.\n\n## Report Vulnerability\n\nWe consider security as the top priority issue. If you find any security issues, please [Report a security vulnerability](https://github.com/apecloud/kubeblocks/security/advisories/new) issue.\n\n## License\n\nKubeBlocks is under the GNU Affero General Public License v3.0.\nSee the [LICENSE](./LICENSE) file for details.","funding_links":[],"categories":["Go","Software Packages","软件包","sql","Go Tools","Databases"],"sub_categories":["DevOps Tools","DevOps 工具"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fapecloud%2Fkubeblocks","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fapecloud%2Fkubeblocks","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fapecloud%2Fkubeblocks/lists"}