### **體驗簡介**

場景將提供一臺配置了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的應用開發之旅，敬請期待。

阿里雲體驗有獎：如何一鍵安裝部署PolarDB-X

相關文章