### **体验简介**

场景将提供一台配置了CentOS 8.5操作系统的ECS实例（云服务器）。通过本教程的操作，您可以在一台CentOS 8.5操作系统的ECS实例上通过Docker镜像部署PolarDB-X。[立即点击前往](http://https://developer.aliyun.com/adc/series/activity/polardb-x/2)

![](https://img.alicdn.com/imgextra/i3/O1CN01ygVXNi1LvqCqb7x2H_!!6000000001362-0-tps-940-400.jpg)

### 实验准备

1\. 步骤一：创建实验资源

开始实验之前，您需要先创建ECS实例资源。

1.  在实验室页面，单击**创建资源**。

**说明**：资源创建过程需要1~3分钟。

1.  （可选）在实验室页面左侧导航栏中，单击**云产品资源**列表，可查看本次实验资源相关信息（例如IP地址、用户信息等）。

2\. 步骤二：安装依赖

本步骤将指导您如何安装并启动依赖Docker。

1.  执行如下命令，安装Docker。

```
curl -fsSL https://get.docker.com | bash -s docker --mirror Aliyun

```

2.  执行如下命令，启动Docker。

```
systemctl start docker

```

3\. 步骤三：安装PolarDB-X数据库

本步骤将指导您如何使用Docker镜像安装PolarDB-X。

1.  执行如下命令，拉取PolarDB-X容器镜像。

```
docker pull polardbx/polardb-x

```

2.  执行如下命令，运行PolarDB-X容器。

```
docker run -d --name some-polardb-x -p 8527:8527 polardbx/polardb-x

```

4\. 步骤四：体验PolarDB-X数据库

本步骤将指导您如何登录PolarDB-X并体验PolarDB-X的分布式特性。

PolarDB-X支持通过MySQL Client命令行、第三方客户端以及符合MySQL交互协议的第三方程序代码进行连接。本实验场景主要介绍如何通过MySQL Client命令行连接到PolarDB-X数据库。

1.  执行如下命令，安装MySQL。

```
yum install mysql -y

```

2.  执行如下命令，查看MySQL版本号。

```
mysql -V

```

返回结果如下，表示您已成功安装MySQL。

![](https://oscimg.oschina.net/oscnet/up-db05007d8b7aeb1d3697751450d694e3866.png)

3.  执行如下命令，登录PolarDB-X数据库。

```
mysql -h127.0.0.1 -P8527 -upolardbx_root -p123456

```

**说明**：

本实验场景中的PolarDB-X数据库用户名和密码已预设，请您使用下方命令登录即可。

如遇到mysql: \[Warning\] Using a password on the command line interface can be insecure. ERROR 2013 (HY000): Lost connection to MySQL server at 'reading initial communication packet', system error: 0报错，重新执行登录命令即可。

4.  执行如下SQL语句，检查GMS。

```
select * from information_schema.schemata;

```

5.  体验PolarDB-X数据库的分布式特性。
    
    1.  执行如下SQL语句，创建数据库。

```
create database polarx_example mode='auto';

```

2.  执行如下SQL语句，使用polarx_example数据库。

```
use polarx_example;

```

3.  执行如下SQL语句，创建数据表。

```
create table example (
  `id` bigint(11) auto_increment NOT NULL,
  `name` varchar(255) DEFAULT NULL,
  `score` bigint(11) DEFAULT NULL,
  primary key (`id`)
) engine=InnoDB default charset=utf8 
partition by hash(id) 
partitions 8;

```

4.  执行如下SQL语句，向example数据表中插入数据。

```
insert into example values(null,'lily',375),(null,'lisa',400),(null,'ljh',500);

```

5.  执行如下SQL语句，查询example表所有数据。

```
select * from example;

```

6.  执行如下SQL语句，查看example数据表的分区。

```
show topology from example;

```

返回结果如下，您可以看到example数据表分布在8个分区。

![](https://oscimg.oschina.net/oscnet/up-4cfb961f51f41c95225efa7b2a2f15e0c15.png)

6.  执行如下SQL语句，检查CDC。

```
show master status;
show binlog events  in 'binlog.000001' from 4;

```

7.  执行如下SQL语句，检查DN和CN。

```
show storage;  
show mpp;

```

8.  输入exit退出数据库。

![](https://oscimg.oschina.net/oscnet/up-92894d6944dfa51f5a446265b523026843b.png)

9.  执行如下命令，停止PolarDB-X容器。

```
docker stop some-polardb-x

```

5\. (选做)步骤五：使用PXD工具一键安装

PolarDB-X

本步骤将指导您如何使用PXD工具一键安装PolarDB-X，详细文档参考[使用PXD工具一键安装PolarDB-X](https://doc.polardbx.com/quickstart/topics/quickstart-pxd-cluster.html)。

1.  安装 PXD

PXD是PolarDB-X的部署工具，除了支持在本地一键快速拉起测试环境外，也支持在Linux集群中通过指定的拓扑的方式部署PolarDB-X分布式数据库。

**说明**：本实验场景使用virtual environment安装PXD工具。

1.  执行如下命令，创建并激活虚拟场景。

```
python3 -m venv venv
source venv/bin/activate

```

2.  执行如下命令，升级pip。

```
pip install --upgrade pip

```

3.  执行如下命令，安装PXD。

```
pip install pxd

```

2.  部署PolarDB-X。

**说明**：部署PolarDB-X有两种方式，请您选择其中一种方式即可。

-   方式一：执行如下命令，创建一个PolarDB-X数据库，其中GMS、CN、DN和CDC节点个数为1。

```
pxd tryout

```

-   方式二：执行如下命令，创建一个PolarDB-X数据库，指定CN、DN和CDC节点个数为1以及版本为latest。

```
pxd tryout -cn_replica 1 -cn_version latest -dn_replica 1 -dn_version latest -cdc_replica 1 -cdc_version latest

```

返回结果如下，表示您已成功部署PolarDB-X数据库，您可以看到输出的连接信息，通过MySQL Client即可连接。

**注意**：PolarDB-X管理员账号的密码随机生成，仅出现这一次，请注意保存。

![](https://oscimg.oschina.net/oscnet/up-4a3175ba619b58025d3fa15356b91af8ec8.png)

3.  执行如下命令，登录PolarDB-X数据库。

```
mysql -h127.0.0.1 -P8527 -upolardbx_root -p123456

```

4.  体验PolarDB-X。
    
    1.  执行如下SQL语句，检查GMS。

```
select * from information_schema.schemata;

```

2.  执行如下SQL语句，创建数据库。

```
create database polarx_example mode='auto';

```

3.  执行如下SQL语句，使用polarx_example数据库。sd

```
use polarx_example;

```

4.  执行如下SQL语句，创建数据表。

```
create table example (
  `id` bigint(11) auto_increment NOT NULL,
  `name` varchar(255) DEFAULT NULL,
  `score` bigint(11) DEFAULT NULL,
  primary key (`id`)
) engine=InnoDB default charset=utf8 
partition by hash(id) 
partitions 8;

```

5.  执行如下SQL语句，向example数据表中插入数据。

```
insert into example values(null,'lily',375),(null,'lisa',400),(null,'ljh',500);

```

6.  执行如下SQL语句，查询example表所有数据。

```
select * from example;

```

7.  执行如下SQL语句，查看example数据表的分区。

```
show topology from example;

```

返回结果如下，您可以看到example数据表分布在8个分区。

![](https://oscimg.oschina.net/oscnet/up-67e416d8a822d8d67aa4854e240d556ead6.png)

8.  执行如下SQL语句，检查CDC。

```
show master status;
show binlog events  in 'binlog.000001' from 4;

```

9.  执行如下SQL语句，检查DN和CN。

```
show storage;  
show mpp;

```

10.  输入exit退出数据库。

![](https://oscimg.oschina.net/oscnet/up-1eb477bf93da340fe8ee037db91cac37982.png)

5.  查看PolarDB-X状态。

执行如下命令，查看当前环境的PolarDB-X状态。

```
pxd list

```

返回如下结果，您可查看到PolarDB-X状态。

![](https://oscimg.oschina.net/oscnet/up-3a50343d25d0e8fae800470178dcbde469d.png)

6.  清理PolarDB-X。

执行如下命令，清理本地环境所有的PolarDB-X

```
pxd cleanup

```

6\. (选做)步骤六：使用Kubernetes安装

本步骤将指导您如何创建一个简单的Kubernetes集群并部署PolarDB-X Operator ，使用Operator部署一个完整的PolarDB-X集群，详细文档请参考[通过](https://doc.polardbx.com/quickstart/topics/quickstart-k8s.html)。

1.  安装kubectl。
    
    1.  执行如下命令，下载kubectl文件。

```
curl -LO https://storage.googleapis.com/kubernetes-release/release/$(curl -s https://storage.googleapis.com/kubernetes-release/release/stable.txt)/bin/linux/amd64/kubectl

```

2.  执行如下命令，赋予可执行权限。

```
chmod +x ./kubectl

```

3.  执行如下命令，移动到系统目录。

```
mv ./kubectl /usr/local/bin/kubectl

```

2.  安装minikube。

执行如下命令，下载并安装minikube。

```
curl -LO https://storage.googleapis.com/minikube/releases/latest/minikube-linux-amd64
sudo install minikube-linux-amd64 /usr/local/bin/minikube

```

3.  安装Helm3。
    
    1.  执行如下命令，下载Helm3。

```
wget https://labfileapp.oss-cn-hangzhou.aliyuncs.com/helm-v3.9.0-linux-amd64.tar.gz

```

2.  执行如下命令，解压Helm3。

```
tar -zxvf helm-v3.9.0-linux-amd64.tar.gz

```

3.  执行如下命令，移动到系统目录。

```
mv linux-amd64/helm /usr/local/bin/helm

```

4.  使用minikube创建Kubernetes集群。

minikube是由社区维护的用于快速创建Kubernetes测试集群的工具，适合测试和学习Kubernetes。使用minikube创建的Kubernetes集群可以运行在容器或是虚拟机中，本实验场景以CentOS 8.5上创建Kubernetes为例。

**说明**：如您使用其他操作系统部署minikube，例如macOS或Windows，部分步骤可能略有不同。

1.  执行如下命令，新建账号galaxykube，并将galaxykube加入docker组中。minikube要求使用非root账号进行部署，所有您需要新建一个账号。

```
useradd -ms /bin/bash galaxykube 
usermod -aG docker galaxykube

```

2.  执行如下命令，切换到账号galaxykube。

```
su galaxykube

```

3.  执行如下命令，进入到home/galaxykube目录。

```
cd

```

4.  执行如下命令，启动一个minikube。

**说明**：这里我们使用了阿里云的minikube镜像源以及USTC提供的docker镜像源来加速镜像的拉取。

```
minikube start --cpus 4 --memory 7168 --image-mirror-country cn --registry-mirror=https://docker.mirrors.sjtug.sjtu.edu.cn

```

返回结果如下，表示minikube已经正常运行，minikube将自动设置kubectl的配置文件。

![](https://oscimg.oschina.net/oscnet/up-228a9af1639b18b2f3114dacde670d834f6.png)

5.  执行如下命令，使用kubectl查看集群信息。

```
minikube kubectl -- cluster-info

```

返回如下结果，您可以查看到集群相关信息.

![](https://oscimg.oschina.net/oscnet/up-48852f66f30ebb9abf61ebe0e35790ff5dc.png)

5.  部署 PolarDB-X Operator。
    
    1.  执行如下命令，创建一个名为polardbx-operator-system的命名空间。

```
kubectl create namespace polardbx-operator-system

```

2.  执行如下命令，安装PolarDB-X Operator。

```
helm install --namespace polardbx-operator-system polardbx-operator https://github.com/ApsaraDB/galaxykube/releases/download/v1.2.1/polardbx-operator-1.2.1.tgz

```

3.  执行如下命令，查看PolarDB-X Operator组件的运行情况。

```
kubectl get pods --namespace polardbx-operator-system

```

返回结果如下，请您耐心等待2分钟，等待所有组件都进入Running状态，表示PolarDB-X Operator已经安装完成。

![](https://oscimg.oschina.net/oscnet/up-38d12b27c444626f868bc814282466d4c1d.png)

6.  部署 PolarDB-X 集群。
    
    1.  执行如下命令，部署一个PolarDB-X集群，它包含1个GMS 节点、1个 CN节点、1个DN节点和1 个CDC节点。

```
echo "apiVersion: polardbx.aliyun.com/v1
kind: PolarDBXCluster
metadata:
  name: quick-start
  annotations:
    polardbx/topology-mode-guide: quick-start" | kubectl apply -f -

```

2.  执行如下命令，查看创建状态。

```
kubectl get polardbxcluster -w

```

返回结果如下，请您耐心等待大约七分钟，当PHASE显示为Running时，表示PolarDB-X集群已经部署完成。现在您可以开始连接并体验PolarDB-X分布式数据库了。

![](https://oscimg.oschina.net/oscnet/up-b3d2f46c25049a4a8d7f653c2d058df3660.png)

7\. (选做)步骤七：源码编译安装PolarDB-X

本步骤将指导您如何使用源码编译安装PolarDB-X，详细文档请详见[源码编译安装PolarDB-X](https://doc.polardbx.com/quickstart/topics/quickstart-development.html)。

1.  执行如下命令，安装git。

```
yum -y install git

```

2.  执行如下命令，下载源码。

```
git clone https://github.com/ApsaraDB/PolarDB-X.git

```

3.  执行如下命令，进入PolarDB-X目录。

```
cd PolarDB-X

```

4.  执行如下命令，编译。

**说明**：make将下载所有源码、工具和库，并构建和安装PolarDB-X。源码将下载到./build目录下，编译好的二进制文件将安装到./build/run目录下。您可以运行make clean来移除安装，并尝试再次构建PolarDB-X。您也可以运行make cleanAll来删除./build下的所有东西。这个过程可能需要半个多小时，取决于您的网络带宽。

```
make

```

5.  执行如下命令，运行PolarDB-X。

```
./build/run/bin/polardb-x.sh start

```

6.  执行如下命令，停止PolarDB-X。

```
./build/run/bin/polardb-x.sh stop

```

8\. 了解更多

有关PolarDB-X Github源码地址请详见[PolarDB-X源码](https://github.com/ApsaraDB/galaxysql)，说明文档请详见[PolarDB-X说明文档](https://doc.polardbx.com/)。若您对PolarDB-X内部实现原理感兴趣，可关注我们的知乎官号[PolarDB-X](https://www.zhihu.com/org/polardb-x)。

下个实验我们将以Spring和WordPress官方教程为例，带你体验Spring Boot+PolarDB-X和WordPress+PolarDB-X的应用开发之旅，敬请期待。

ITPub博客

阿里云体验有奖：如何一键安装部署PolarDB-X

最新文章