Skip to content

Commit 1110137

Browse files
authored
Merge pull request #488 from KID-G/docs
Docs: Update README.md
2 parents 62535bf + 9c87d67 commit 1110137

File tree

2 files changed

+94
-45
lines changed

2 files changed

+94
-45
lines changed

README.md

Lines changed: 93 additions & 45 deletions
Original file line numberDiff line numberDiff line change
@@ -1,73 +1,121 @@
1-
![](docs/images/logo_radondb-mysql.png) <br>
1+
> English | [简体中文](README_zh.md)
22
3-
English | [简体中文](README_zh.md)
3+
4+
<p align="center">
5+
<a href="https://radondb.com/"><img src="https://github.com/radondb/radondb-mysql-kubernetes/blob/main/docs/images/logo_radondb-mysql.png?raw=true" alt="banner" width="200px"></a>
6+
</p>
7+
<p align="center">
8+
<b><i>Cloud-Native and Databases on Kubernetes</i></b>
9+
</p>
10+
11+
<p align=center>
12+
<a href="https://goreportcard.com/report/github.com/radondb/radondb-mysql-kubernetes"><img src="https://goreportcard.com/badge/github.com/radondb/radondb-mysql-kubernetes" alt="A+"></a>
13+
<a href="https://img.shields.io/github/stars/radondb/radondb-mysql-kubernetes"><img src="https://img.shields.io/github/stars/radondb/radondb-mysql-kubernetes"></a>
14+
<a href="https://img.shields.io/github/issues/radondb/radondb-mysql-kubernetes"><img src="https://img.shields.io/github/issues/radondb/radondb-mysql-kubernetes"></a>
15+
<a href="https://img.shields.io/github/forks/radondb/radondb-mysql-kubernetes"><img src="https://img.shields.io/github/forks/radondb/radondb-mysql-kubernetes"></a>
16+
<a href="https://img.shields.io/github/v/release/radondb/radondb-mysql-kubernetes?include_prereleases"><img src="https://img.shields.io/github/v/release/radondb/radondb-mysql-kubernetes?include_prereleases"></a>
17+
<a href="https://img.shields.io/github/license/radondb/radondb-mysql-kubernetes"><img src="https://img.shields.io/github/license/radondb/radondb-mysql-kubernetes"></a>
18+
</p>
19+
20+
----
421

522
# What is RadonDB MySQL
623

7-
[RadonDB MySQL](https://github.com/radondb/radondb-mysql-kubernetes) is an open-source, cloud-native, highly availability cluster solutions based on [MySQL](https://MySQL.org). With the Raft protocol,RadonDB MySQL provides faster failover performance without losing any transactions.
24+
**RadonDB MySQL** is an open-source, cloud-native, highly availability cluster solutions based on MySQL. With the Raft protocol,RadonDB MySQL provides faster failover performance without losing any transactions.
25+
26+
**RadonDB MySQL Kubernetes** supports deployment and management of RaodnDB MySQL clusters on [Kubernetes](https://kubernetes.io/), [KubeSphere](https://kubesphere.com.cn/) and [Rancher](https://rancher.com) automates tasks related to operating a RadonDB MySQL cluster.
827

9-
## RadonDB MySQL Kubernetes
28+
## Features
29+
🧠 **High Availability MySQL**: Non-centralized automatic leader selection, Leader-follower switching in second-level, Strongly consistent data for cluster switching
30+
31+
✏️ **Cluster Management**
1032

11-
RadonDB MySQL Kubernetes supports deployment and management of RaodnDB MySQL clusters on [Kubernetes](https://kubernetes.io) or [KubeShpere](https://kubesphere.com.cn) and automates tasks related to operating a RadonDB MySQL cluster.
33+
💻 **Monitoring and Alerting**
1234

13-
## Architecture
35+
✍️ [**Backup for S3**](docs/en-us/deploy_backup_restore_s3.md)
1436

15-
- Decentralized leader automatic election through Raft protocol.
16-
- Synchronizing data based on GTID mode through Semi-Sync.
17-
- Supporting high-availability through [Xenon](https://github.com/radondb/xenon.git).
37+
🎈 **Log Management**
1838

19-
![](docs/images/radondb-mysql_Architecture.png)
39+
👨 **Account Management**
2040

21-
## Features
41+
🎨 [**Others**](docs/en-us/)
2242

23-
- High availability MySQL database
24-
- Non-centralized automatic leader selection
25-
- Leader-follower switching in second-level
26-
- Strongly consistent data for cluster switching
27-
- Cluster management
28-
- [Monitoring and alerting](docs/zh-cn/deploy_monitoring.md)
29-
- [Backups](docs/en-us/deploy_backup_restore_s3.md)
30-
- Logs
31-
- [Account management](docs/zh-cn/mgt_mysqluser.md)
3243

33-
## Quick Start
44+
## Architecture
45+
46+
1. Decentralized leader automatic election through Raft protocol.
3447

35-
### Operator
48+
2. Synchronizing data based on GTID mode through Semi-Sync.
3649

37-
- [Deploy RadonDB MySQL on Kubernetes](/docs/zh-cn/deploy_radondb-mysql_operator_on_k8s.md)
38-
- [Deploy RadonDB MySQL on KubeSphere](/docs/en-us/deploy_radondb-mysql_operator_on_kubesphere.md)
39-
- [Deploy RadonDB MySQL on Rancher](/docs/zh-cn/deploy_radondb-mysql_operator_on_rancher.md)
50+
3. Supporting high-availability through [Xenon](https://github.com/radondb/xenon.git).
51+
52+
<p align="center">
53+
<a href="https://github.com/radondb/"><img src="https://github.com/radondb/radondb-mysql-kubernetes/blob/main/docs/images/radondb-mysql_Architecture.png?raw=true" alt="banner" width="800px"></a>
54+
</p>
4055

4156
## Roadmap
4257

4358
| Release | Features | Mode |
44-
|------|--------|--------|
45-
| 3.0 | Automatic O&M <br> Multiple node roles <br> Disaster Recovery <br> SSL transmission encryption | Operator |
46-
| 2.0 | Node management <br> Automatic expansion and shrinkage capacity <br> Upgrade <br> Backups and Restorations <br> Automatic failover <br> Automatic rebuild node <br> Automatic restart service(all or signal node)<br> Account management(API)<br> Migrating Data online | Operator |
47-
| 1.0 | Cluster management <br> Monitoring and alerting <br> Logs <br> Account management | Helm |
59+
|------|--------|------|
60+
| 3.0 | Automatic O&M <br> Multiple Node Roles <br> Disaster Recovery <br> SSL Transmission Encryption | Operator |
61+
| 2.0 | Node Management <br> Upgrade Cluster <br> Backups and Restorations <br> Automatic Failover <br> Automatic Rebuild Node <br> Account management(API) | Operator |
62+
| 1.0 | Cluster Management <br> Monitoring and Alerting <br> Log Management <br> Account management | Helm |
4863

49-
## Who are using RadonDB MySQL
64+
# Quick Start
5065

51-
![](docs/images/users.png)
66+
👀 Demonstrate how to deploy RadonDB MySQL Cluster (operator) on Kubernetes.
5267

53-
## License
68+
## Prepare
5469

55-
RadonDB MySQL is released under the Apache 2.0, see [License](./LICENSE).
70+
📦 You need to prepare a Kubernetes cluster.
5671

57-
## Discussion and Community
72+
## Deployment steps
5873

59-
- Forum
74+
### Step 1: Add a Helm Repository
6075

61-
The RadonDB MySQL topic is in [KubeSphere Community](https://kubesphere.com.cn/forum/t/radondb).
76+
```plain
77+
helm repo add radondb https://radondb.github.io/radondb-mysql-kubernetes/
78+
```
79+
### Step 2: Install Operator
6280

63-
- Please pay attention to our official account.
81+
The following sets the release name to `demo` and creates a [Deployment](https://kubernetes.io/docs/concepts/workloads/controllers/deployment/) named `demo-mysql-operator`.
6482

65-
![](docs/images/vx_code_258.jpg)
83+
```plain
84+
helm install demo radondb/mysql-operator
85+
```
86+
> **Notic**
87+
>
88+
> This step also creates the [CRD](https://kubernetes.io/docs/concepts/extend-kubernetes/api-extension/custom-resources/) required by the cluster.
6689
67-
---
68-
<p align="center">
69-
<br/><br/>
70-
Please submit any RadonDB MySQL bugs, issues, and feature requests to RadonDB MySQL GitHub Issue.
71-
<br/>
72-
</a>
73-
</p>
90+
### Step 3: Install a RadonDB MySQL Cluster
91+
92+
Run the following command to create an instance of the `mysqlclusters.mysql.radondb.com` CRD and thereby create a RadonDB MySQL cluster by using the default parameters. You can customize the cluster parameters by referring to [Configuration Parameters](https://github.com/radondb/radondb-mysql-kubernetes/blob/main/docs/zh-cn/config_para.md).
93+
94+
```plain
95+
kubectl apply -f https://github.com/radondb/radondb-mysql-kubernetes/releases/latest/download/mysql_v1alpha1_mysqlcluster.yaml
96+
```
97+
98+
99+
📖 For more information, see the documentation:
100+
101+
* [Deploy RadonDB MySQL on Kubernetes](https://github.com/radondb/radondb-mysql-kubernetes/blob/main/docs/en-us/deploy_radondb-mysql_operator_on_k8s.md)
102+
* [Deploy RadonDB MySQL on Kubernetes](https://github.com/radondb/radondb-mysql-kubernetes/blob/main/docs/en-us/deploy_radondb-mysql_operator_on_kubesphere.md)
103+
* [Deploy RadonDB MySQL on Rancher](https://github.com/radondb/radondb-mysql-kubernetes/blob/main/docs/en-us/deploy_radondb-mysql_operator_on_rancher.md)
104+
* [All Documents](https://radondb.com/en/docs/mysql/)
105+
106+
107+
# Who are using RadonDB MySQL
108+
109+
![](docs/images/%E5%AE%A2%E6%88%B7%E6%A1%88%E4%BE%8B.png)
110+
111+
## License
112+
113+
RadonDB MySQL is based on Apache 2.0 protocol. See [License](https://github.com/radondb/radondb-mysql-kubernetes/blob/main/LICENSE)
114+
115+
## Welcome to join us ❤️
116+
117+
😊 Website: [https://radondb.com/](https://radondb.com/en/)
118+
119+
😁 Forum:Please join the [RadonDB section](https://kubesphere.com.cn/forum/t/RadonDB) of kubesphere Developer Forum.
120+
121+
🦉 Community wechat group:Please add a group assistant **radondb** to invite you into the group

README_zh.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,4 @@
1+
> [English](README.md) | 简体中文
12
23
<p align="center">
34
<a href="https://radondb.com/"><img src="https://github.com/radondb/radondb-mysql-kubernetes/blob/main/docs/images/logo_radondb-mysql.png?raw=true" alt="banner" width="200px"></a>

0 commit comments

Comments
 (0)