本教程适用于以下操作系统版本
- Debian 12 (Bookworm)
- Debian 11 (Bullseye)
本页内容
- 前提条件
- 在全部 3 台服务器上安装 CockroachDB
- 设置防火墙
- 初始化 CockroachDB cluster
- 测试在 CockroachDB 上创建新数据库
- 结论
CockroachDB 是一款面向云应用的开源分布式可扩展 SQL 数据库。CockroachDB 提供更高层次的一致性、复制式 SQL 数据库以及事务型数据存储。CockroachDB 将你的数据存储在多个位置,使数据交付更快。此外,它易于扩展,并为你的应用提供高可用性和容错能力。
在本教程中,我们将向你展示如何在 Debian 11 服务器上安装 CockroachDB cluster。
前提条件
- 两台或更多 Debian 11 服务器。
- 服务器上已配置 root 密码。
在全部 3 台服务器上安装 CockroachDB
在安装方面,cockroachdb 易于安装。这是因为 cockroachdb 为 Linux 系统提供了一个二进制文件,你可以将其下载到你的系统中。
使用以下命令下载适用于 Linux 的 cockroachdb 二进制文件。该命令将下载 cockroachdb 二进制文件,解压压缩文件,然后将 cockroachdb 的二进制文件移动到 /usr/local/bin 目录。
curl https://binaries.cockroachdb.com/cockroach-v21.2.8.linux-amd64.tgz | tar -xz && sudo cp -i cockroach-v21.2.8.linux-amd64/cockroach /usr/local/bin/
cockroachdb 使用了定制的内置 GEOS 库。GEOS 库包含在 cockroachdb 的压缩文件中,必须安装到 lib 目录中。
使用以下命令创建一个新目录 /usr/local/lib/cockroach。
mkdir -p /usr/local/lib/cockroach
现在将 GEOS 库复制到 /usr/local/lib/cockroach 目录。
cp -i cockroach-v21.2.8.linux-amd64/lib/libgeos.so /usr/local/lib/cockroach/
cp -i cockroach-v21.2.8.linux-amd64/lib/libgeos_c.so /usr/local/lib/cockroach/
cockroachdb 的基础安装已在 Debian 服务器上完成。

运行以下命令检查 cockroachdb 二进制文件以及你刚刚安装的 cockroachdb 的当前版本。
which cockroach
cockroach version
你将得到以下输出。

设置防火墙
如果你的 Debian 服务器上运行着防火墙,你需要将 cockroachdb 端口添加到防火墙配置中。
cockroachdb 使用端口 8080 用于基于 Web 的 cockroachdb 管理,端口 26257 用于用户连接和 cluster 配置。
使用以下命令将端口 8080 和 25267 添加到 UFW 防火墙。
sudo ufw allow 8080/tcp
sudo ufw allow 26257/tcp
现在重新加载 UFW 防火墙规则并验证防火墙规则的当前状态。
sudo ufw reload
sudo ufw status
下面你可以看到端口 8080 和 25267 已添加到 UFW 防火墙。

初始化 CockroachDB cluster
要初始化 cockroachdb cluster,在 server11 上运行以下命令。
你需要更改以下选项的值:
- --store:用于存储 CockroachDB cluster 的数据。
- --listen-addr:cockroachdb 将在服务器上运行的 IP 地址。cockroachdb 的默认端口是端口 25267。
- --http-addr:cockroachdb 基于 Web 的管理将在其上运行的 IP 地址。cockroachdb 基于 Web 的管理的默认端口是端口 8080。
cockroach start \
--insecure \
--store=server11 \
--listen-addr=192.168.10.11:26257 \
--http-addr=192.168.10.11:8080 \
--join=192.168.10.11:26257,192.168.10.13:26258,192.168.10.14:26259 \
--background
你将得到以下输出。

现在切换到 server2 并运行以下命令启动 cockroachdb 并加入 cluster。将 --listen-addr 和 --http-addr 的 IP 地址改为 server2 的 IP 地址。
cockroach start \
--insecure \
--store=server2 \
--listen-addr=192.168.10.13:26257 \
--http-addr=192.168.10.13:8080 \
--join=192.168.10.11:26257,192.168.10.13:26258,192.168.10.14:26259 \
--background
你将从 server2 得到以下输出。

接下来,切换到 server3 并运行以下命令启动 cockroachdb 并加入 cockroachdb cluster。同时,将 --listen-addr 和 --http-addr 的 IP 地址改为 server3 的 IP 地址。
cockroach start \
--insecure \
--store=server3 \
--listen-addr=192.168.10.14:26257 \
--http-addr=192.168.10.14:8080 \
--join=192.168.10.11:26257,192.168.10.13:26258,192.168.10.14:26259 \
--background
你将从 server3 得到以下输出。

全部完成后,返回 server11 并运行以下命令初始化 cockroachdb cluster。
cockroach init --insecure --host=192.168.10.11:26257
你将得到输出消息' cluster successfully initialized ',这表示 cockroachdb cluster 已成功初始化。
你可以运行下面的 grep 命令来查看 cockroachdb 初始化的日志。将 server11 目录替换为你的 --store cockroachdb 目录。
grep 'node starting' server11/logs/cockroach.log -A 11
下面你可以看到 server11 上 cockroachdb cluster 初始化的日志。

最后,打开你的 Web 浏览器并访问后跟端口 8080 的服务器 IP 地址。
http://192.168.10.11:8080/
下面你可以看到 cockroachdb cluster 中有三个 node。

测试在 CockroachDB 上创建新数据库
现在 cockroachdb cluster 已在运行,你可以使用任意服务器作为 SQL gateway 来访问 cockroachdb。
在 server11 上运行 cockroach 命令以连接到 cockroachdb cluster。
cockroach sql --insecure --host=192.168.10.11:26257

连接到 SQL shell 后,运行以下查询创建一个新数据库。
CREATE DATABASE bank;
现在使用以下查询在该数据库中创建一个新表。
CREATE TABLE bank.accounts (id INT PRIMARY KEY, balance DECIMAL);
接下来,向表中导入示例数据。
INSERT INTO bank.accounts (1, 1000.50);
使用以下查询验证数据库中的数据。
SELECT * FROM bank.accounts;
你将得到以下输出。

接下来,切换到 server2 或 server3 并使用以下命令登录 cockroachdb SQL shell。
cockroach sql --insecure --host=192.168.10.14:26257
连接到 server3 上的 SQL shell 后,运行以下查询检查并验证数据库复制。
SELECT * FROM bank.accounts;
你将看到来自 server11 的数据库和数据已自动复制到 server2 和 server3。

结论
恭喜!你现在已经在 Debian 11 服务器上安装并配置了 cockroachdb cluster。此外,你还学习了如何连接到 cockroachdb shell 以及用于创建数据库和插入数据的基本 SQL 命令。