Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

docs:Add a description of service_name connection method #401 #402

Merged
merged 2 commits into from Mar 10, 2022
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Jump to
Jump to file
Failed to load files.
Diff view
Diff view
36 changes: 21 additions & 15 deletions docs/zh-cn/deploy_radondb-mysql_operator_on_k8s.md
Expand Up @@ -61,7 +61,7 @@ helm install demo radondb/mysql-operator

### 步骤 3: 部署 RadonDB MySQL 集群

执行以下指令,以默认参数为 CRD `mysqlclusters.mysql.radondb.com` 创建一个实例,即创建 RadonDB MySQL 集群。您可参见[配置参数](../config_para.md)说明,自定义集群部署参数。
执行以下指令,以默认参数为 CRD `mysqlclusters.mysql.radondb.com` 创建一个实例,即创建 RadonDB MySQL 集群。您可参见[配置参数](./config_para.md)说明,自定义集群部署参数。

```kubectl
kubectl apply -f https://github.com/radondb/radondb-mysql-kubernetes/releases/latest/download/mysql_v1alpha1_mysqlcluster.yaml
Expand Down Expand Up @@ -123,8 +123,28 @@ service/sample-mysql ClusterIP None <none> 3306/

以下为客户端与数据库在同一 Kubernetes 集群内,访问 RadonDB MySQL 的方式。

### `clusterIP` 方式

RadonDB MySQL 的高可用读写 IP 指向 leader 服务的 `clusterIP`,高可用只读 IP 指向 follower 服务的 `clusterIP`。

```shell
mysql -h <clusterIP> -P <mysql_Port> -u <user_name> -p
```

以下示例用户名为 `radondb_usr`, leader 服务的 clusterIP 为 `10.10.128.136` ,连接示例如下:

```shell
mysql -h 10.10.128.136 -P 3306 -u radondb_usr -p
```

### `service_name` 方式

Kubernetes 集群的 Pod 之间支持通过 `service_name` 方式访问 RadonDB MySQL。

> **说明**
>
> `service_name` 方式不适用于从 Kubernetes 集群的物理机访问数据库 Pod。

* 连接 leader 服务(RadonDB MySQL 主节点)

```shell
Expand All @@ -149,20 +169,6 @@ service/sample-mysql ClusterIP None <none> 3306/
mysql -h sample-follower.default -u radondb_usr -p
```

### `clusterIP` 方式

RadonDB MySQL 的高可用读写 IP 指向 leader 服务的 `clusterIP`,高可用只读 IP 指向 follower 服务的 `clusterIP`。

```shell
mysql -h <clusterIP> -P <mysql_Port> -u <user_name> -p
```

以下示例用户名为 `radondb_usr`, leader 服务的 clusterIP 为 `10.10.128.136` ,连接示例如下:

```shell
mysql -h 10.10.128.136 -P 3306 -u radondb_usr -p
```

## 卸载

### 卸载 Operator
Expand Down
44 changes: 25 additions & 19 deletions docs/zh-cn/deploy_radondb-mysql_operator_on_rancher.md
Expand Up @@ -108,7 +108,7 @@ RadonDB MySQL 支持在 Rancher 上安装部署和管理,自动执行与运行

1. 下载 [RadonDB MySQL 集群配置样例](/config/samples/mysql_v1alpha1_mysqlcluster.yaml),修改 YAML 文件中配置参数值。

详细配置参数说明,请参见[配置参数](../config_para.md)。
详细配置参数说明,请参见[配置参数](./config_para.md)。

2. 在 Rancher 集群管理页面,点击右上角 YAML 导入图标。在弹出的窗口中,导入修改后的 YAML 文件。

Expand Down Expand Up @@ -155,42 +155,48 @@ RadonDB MySQL 支持在 Rancher 上安装部署和管理,自动执行与运行

以下为客户端与数据库在同一 Rancher 集群内,访问 RadonDB MySQL 的方式。

### `clusterIP` 方式

RadonDB MySQL 的高可用读写 IP 指向 leader 服务的 `clusterIP`,高可用只读 IP 指向 follower 服务的 `clusterIP`。

```shell
$ mysql -h <clusterIP> -P <mysql_Port> -u <user_name> -p
```

以下示例用户名为 `radondb_usr`, leader 服务的 clusterIP 为 `10.10.128.136` ,连接示例如下:

```shell
$ mysql -h 10.10.128.136 -P 3306 -u radondb_usr -p
```

### `service_name` 方式

Rancher 集群的 Pod 之间支持通过 `service_name` 方式访问 RadonDB MySQL。

> **说明**
>
> `service_name` 方式不适用于从 Rancher 集群的物理机访问数据库 Pod。

* 连接 leader 服务(RadonDB MySQL 主节点)

```shell
$ mysql -h <leader_service_name>.<namespace> -u <user_name> -p
mysql -h <leader_service_name>.<namespace> -u <user_name> -p
```

用户名为 `radondb_usr`,release 名为 `sample`,RadonDB MySQL 命名空间为 `default` ,连接示例如下:

```shell
$ mysql -h sample-leader.default -u radondb_usr -p
mysql -h sample-leader.default -u radondb_usr -p
```

* 连接 follower 服务(RadonDB MySQL 从节点)

```shell
$ mysql -h <follower_service_name>.<namespace> -u <user_name> -p
mysql -h <follower_service_name>.<namespace> -u <user_name> -p
```

用户名为 `radondb_usr`,release 名为 `sample`,RadonDB MySQL 命名空间为 `default` ,连接示例如下:

```shell
$ mysql -h sample-follower.default -u radondb_usr -p
mysql -h sample-follower.default -u radondb_usr -p
```

### `clusterIP` 方式

RadonDB MySQL 的高可用读写 IP 指向 leader 服务的 `clusterIP`,高可用只读 IP 指向 follower 服务的 `clusterIP`。

```shell
$ mysql -h <clusterIP> -P <mysql_Port> -u <user_name> -p
```

以下示例用户名为 `radondb_usr`, leader 服务的 clusterIP 为 `10.10.128.136` ,连接示例如下:

```shell
$ mysql -h 10.10.128.136 -P 3306 -u radondb_usr -p
```