131 lines
5.0 KiB
Markdown
131 lines
5.0 KiB
Markdown
---
|
||
author: 棠羽
|
||
date: 2022/05/09
|
||
minute: 15
|
||
---
|
||
|
||
# 基于单机文件系统部署
|
||
|
||
<ArticleInfo :frontmatter=$frontmatter></ArticleInfo>
|
||
|
||
本文将指导您在单机文件系统（如 ext4）上编译部署 PolarDB，适用于所有计算节点都可以访问相同本地磁盘存储的场景。
|
||
|
||
我们在 DockerHub 上提供了一个 [PolarDB 开发镜像](https://hub.docker.com/r/polardb/polardb_pg_devel/tags)，里面已经包含编译运行 PolarDB for PostgreSQL 所需要的所有依赖。您可以直接使用这个开发镜像进行实例搭建。镜像目前支持 AMD64 和 ARM64 两种 CPU 架构。
|
||
|
||
## 环境准备
|
||
|
||
拉取开发镜像，创建并进入容器：
|
||
|
||
```bash
|
||
docker pull polardb/polardb_pg_devel
|
||
docker run -it \
|
||
--cap-add=SYS_PTRACE --privileged=true \
|
||
--name polardb_pg \
|
||
polardb/polardb_pg_devel bash
|
||
```
|
||
|
||
进入容器后，从 [GitHub](https://github.com/ApsaraDB/PolarDB-for-PostgreSQL) 上下载 PolarDB for PostgreSQL 的源代码，稳定分支为 `POLARDB_11_STABLE`。如果因网络原因不能稳定访问 GitHub，则可以访问 [Gitee 国内镜像](https://gitee.com/mirrors/PolarDB-for-PostgreSQL)。
|
||
|
||
:::: code-group
|
||
::: code-group-item GitHub
|
||
|
||
```bash:no-line-numbers
|
||
git clone -b POLARDB_11_STABLE https://github.com/ApsaraDB/PolarDB-for-PostgreSQL.git
|
||
```
|
||
|
||
:::
|
||
::: code-group-item Gitee 国内镜像
|
||
|
||
```bash:no-line-numbers
|
||
git clone -b POLARDB_11_STABLE https://gitee.com/mirrors/PolarDB-for-PostgreSQL
|
||
```
|
||
|
||
:::
|
||
::::
|
||
|
||
代码克隆完毕后，进入源码目录：
|
||
|
||
```bash:no-line-numbers
|
||
cd PolarDB-for-PostgreSQL/
|
||
```
|
||
|
||
## 编译测试选项说明
|
||
|
||
以下表格列出了编译、初始化或测试 PolarDB 集群所可能使用到的选项及说明。更多选项及其说明详见源码目录下的 `polardb_build.sh` 脚本。
|
||
|
||
| 选项 | 描述 | 默认值 |
|
||
| ---------------------------- | ---------------------------------------------------------------------------- | ------ |
|
||
| `--withrep` | 是否初始化只读节点 | `NO` |
|
||
| `--repnum` | 只读节点数量 | `1` |
|
||
| `--withstandby` | 是否初始化热备份节点 | `NO` |
|
||
| `--initpx` | 是否初始化为 HTAP 集群（1 个读写节点，2 个只读节点） | `NO` |
|
||
| `--with-pfsd` | 是否编译 PolarDB File System（PFS）相关功能 | `NO` |
|
||
| `--with-tde` | 是否初始化 [透明数据加密（TDE）](https://zhuanlan.zhihu.com/p/84829027) 功能 | `NO` |
|
||
| `--with-dma` | 是否初始化为 DMA（Data Max Availability）高可用三节点集群 | `NO` |
|
||
| `-r`/ `-t` / <br>`--regress` | 在编译安装完毕后运行内核回归测试 | `NO` |
|
||
| `-r-px` | 运行 HTAP 实例的回归测试 | `NO` |
|
||
| `-e` /<br>`--extension` | 运行扩展插件测试 | `NO` |
|
||
| `-r-external` | 测试 `external/` 下的扩展插件 | `NO` |
|
||
| `-r-contrib` | 测试 `contrib/` 下的扩展插件 | `NO` |
|
||
| `-r-pl` | 测试 `src/pl/` 下的扩展插件 | `NO` |
|
||
|
||
如无定制的需求，则可以按照下面给出的选项编译部署不同形态的 PolarDB 集群并进行测试。
|
||
|
||
## PolarDB 各形态编译部署
|
||
|
||
### 本地单节点实例
|
||
|
||
- 1 个读写节点（运行于 `5432` 端口）
|
||
|
||
```bash:no-line-numbers
|
||
./polardb_build.sh
|
||
```
|
||
|
||
### 本地多节点实例
|
||
|
||
- 1 个读写节点（运行于 `5432` 端口）
|
||
- 1 个只读节点（运行于 `5433` 端口）
|
||
|
||
```bash:no-line-numbers
|
||
./polardb_build.sh --withrep --repnum=1
|
||
```
|
||
|
||
### 本地多节点带备库实例
|
||
|
||
- 1 个读写节点（运行于 `5432` 端口）
|
||
- 1 个只读节点（运行于 `5433` 端口）
|
||
- 1 个备库节点（运行于 `5434` 端口）
|
||
|
||
```bash:no-line-numbers
|
||
./polardb_build.sh --withrep --repnum=1 --withstandby
|
||
```
|
||
|
||
### 本地多节点 HTAP 实例
|
||
|
||
- 1 个读写节点（运行于 `5432` 端口）
|
||
- 2 个只读节点（运行于 `5433` / `5434` 端口）
|
||
|
||
```bash:no-line-numbers
|
||
./polardb_build.sh --initpx
|
||
```
|
||
|
||
## 实例回归测试
|
||
|
||
普通实例回归测试：
|
||
|
||
```bash:no-line-numbers
|
||
./polardb_build.sh --withrep -r -e -r-external -r-contrib -r-pl --with-tde
|
||
```
|
||
|
||
HTAP 实例回归测试：
|
||
|
||
```bash:no-line-numbers
|
||
./polardb_build.sh -r-px -e -r-external -r-contrib -r-pl --with-tde
|
||
```
|
||
|
||
DMA 实例回归测试：
|
||
|
||
```bash:no-line-numbers
|
||
./polardb_build.sh -r -e -r-external -r-contrib -r-pl --with-tde --with-dma
|
||
```
|