发表 admin at 2025年2月28日

类别

未分类

标签

如何在 Ubuntu 24.04 上安装 CockroachDB 集群

本教程适用于这些操作系统版本

Ubuntu 24.04（高贵食蚁兽）
Ubuntu 22.04（果酱水母）
Ubuntu 20.04（焦窝）
Ubuntu 18.04（仿生海狸）

在此页面上

先决条件
设置用户
下载 CockroachDB 二进制文件
生成 TLS 证书
1. 生成CA证书
2. 生成客户端证书
3. 生成服务器证书
将 CockroachDB 作为服务运行
创建 CockroachDB 集群
访问 CockroachDB 网络管理
结论

CockroachDB 是一个高度弹性和可扩展的分布式 SQL 数据库，旨在轻松处理大规模数据工作负载。当安装在 Ubuntu 上时，它提供了一个开源的云原生数据库解决方案，可提供强一致性、高可用性和水平可扩展性。 CockroachDB 的架构允许其在多个节点之间自动复制和分发数据，从而确保数据完整性并最大限度地减少硬件故障时的停机时间。它与 PostgreSQL 的兼容性使其成为寻求能够处理要求苛刻的应用程序的强大数据库系统的开发人员的多功能选择。在 Ubuntu 上安装 CockroachDB 允许用户利用这些高级功能，同时受益于 Ubuntu 操作系统的安全性和稳定性。

CockroachDB 将您的数据存储在多个位置，从而使数据传输更快。此外，它还易于扩展，并为您的应用程序提供高可用性和容错能力。

在本指南中，我们将向您展示如何在 Ubuntu 24.04 服务器上安装 CockroachDB 集群。

先决条件

在进一步操作之前，请确保您具备以下条件：

两到三台 Ubuntu 24.04 服务器。
具有管理员权限的非 root 用户。

设置用户

在安装 CockroachDB 之前，您将创建一个新的系统用户和组 cockroach。这将用于运行 CockroachDB 服务。

首先，运行以下命令添加一个新的系统用户cockroach，主目录为/opt/cockroachdb。

sudo adduser --home /opt/cockroachdb --system --group cockroach

现在，使用以下命令将 /opt/cockroachdb 目录的所有权更改为用户和组 cockroach：

sudo chown -R cockroach:cockroach /opt/cockroachdb

下载 CockroachDB 二进制文件

要安装 CockroachDB，您可以轻松地从 GitHub 页面下载它，并将 CockroachDB 二进制文件移动到 Ubuntu 系统上的 bin 目录中。

访问 CockroachDB GitHub 页面并获取最新版本的链接。使用 wget 命令下载它，如下所示：

wget https://binaries.cockroachdb.com/cockroach-v24.1.1.linux-amd64.tgz

下载完成后，解压 CockroachDB 并将 cockroach 二进制文件移动到 /usr/bin 目录。

tar -xf cockroach-v24.1.1.linux-amd64.tgz
cp -i cockroach-*/cockroach /usr/bin/

现在使用以下命令检查 CockroachDB 版本：

蟑螂--版本

在下面的输出中，您可以看到 CockroachDB v24 已安装。

生成 TLS 证书

要创建 CockroachDB 集群，您必须生成 SSL/TLS 证书来保护集群。您需要跨服务器生成和分发CA证书，然后为用户和服务器生成证书。

在进一步操作之前，请在 server1 和 server2 上运行以下命令。这样，您将为字符串 TLS 证书创建目录 certs 和 private。

mkdir -p /opt/cockroachdb/{证书，私有}

生成CA证书

在本部分中，您将从 server1 生成 CA 证书，并通过 scp 或安全副本将其上传到 server2。

在 server1 上，运行以下命令来生成 CA（证书颁发机构）证书。将生成 CA 证书 ca.crt 和 ca.key。

cockroach 证书 create-ca
–certs-dir=/opt/cockroachdb/certs
–ca-key=/opt/cockroachdb/private/ca.key

现在，使用 scp 或安全副本将 ca.crt 和 ca.key 上传到 server2。确保您可以顺利登录 server2。

scp /opt/cockroachdb/private/ca.key [电子邮件受保护]:/opt/cockroachdb/private/
scp /opt/cockroachdb/certs/ca.crt [电子邮件受保护]:/opt/cockroachdb/certs/

生成客户端证书

生成 CA 证书后，您将生成用于管理 CockroachDB 集群的客户端证书。只有拥有此证书的用户才能连接和管理 CockroachDB 集群。

为用户 root 生成并签署客户端证书，运行以下 cockroach 命令。

cockroach 证书创建客户端 \
root \
--certs-dir=/opt/cockroachdb/certs \
--ca-key=/opt/cockroachdb/private/ca.key

生成服务器证书

在本部分中，您将在 server1 和 server2 上生成服务器证书。

在 server1 上，运行以下命令生成服务器证书。确保使用您的信息更改 IP 地址和主机名。

cockroach 证书创建节点 \
server1 \
192.168.5.15 \
localhost \
--certs-dir=/opt/cockroachdb/certs \
--ca-key=/opt /cockroachdb/private/ca.key

现在，移至 server2 并使用以下内容生成节点证书。使用 server2 信息更改 IP 地址和主机名。

cockroach 证书创建节点 \
server2 \
192.168.5.16 \
localhost \
--certs-dir=/opt/cockroachdb/certs \
--ca-key=/opt /cockroachdb/private/ca.key

最后，在 server1 和 server2 上运行以下命令，将 certs 和 private 目录的所有权更改为用户蟑螂。

sudo chown -R cockroach:cockroach /opt/cockroachdb/{certs,private}

将 CockroachDB 作为服务运行

生成 SSL/TLS 证书后，您将为每个 CockroachDB 服务器创建一个 systemd 服务文件。这允许您在后台运行 CockroachDB，并且您可以使用 systemctl 轻松管理它。

使用 nano 编辑器创建一个新的 systemd 服务文件 /etc/systemd/system/cockroachdb.service。

须藤纳米 /etc/systemd/system/cockroachdb.service

对于 server1，插入以下配置。在 --advertise-addr 选项中，输入 server1 IP 地址。在 --join 选项中，输入 server1 和 server2 IP 地址。

[Unit]
Description=Cockroach Database cluster node
Requires=network.target

[Service]
Type=notify
WorkingDirectory=/opt/cockroachdb
ExecStart=/usr/bin/cockroach start --certs-dir=/opt/cockroachdb/certs --advertise-addr=192.168.5.15 --join=192.168.5.15,192.168.5.16
TimeoutStopSec=60
Restart=always
RestartSec=10
StandardOutput=syslog
StandardError=syslog
SyslogIdentifier=cockroach
User=cockroach

[Install]
WantedBy=default.target

对于 server2，插入以下配置。在 --advertise-addr 选项中，输入 server2 IP 地址。在 --join 选项中，输入 server1 和 server2 IP 地址。

[Unit]
Description=Cockroach Database cluster node
Requires=network.target

[Service]
Type=notify
WorkingDirectory=/opt/cockroachdb
ExecStart=/usr/bin/cockroach start --certs-dir=/opt/cockroachdb/certs --advertise-addr=192.168.5.16 --join=192.168.5.15,192.168.5.16
TimeoutStopSec=60
Restart=always
RestartSec=10
StandardOutput=syslog
StandardError=syslog
SyslogIdentifier=cockroach
User=cockroach

[Install]
WantedBy=default.target

完成后保存并退出文件。

现在运行下面的 systemctl 命令来重新加载 systemd 管理器并应用您的更改。

sudo systemctl 守护进程重新加载

然后启动并启用 server1 和 server2 上的 cockroachdb 服务。

sudo systemctl启用--now cockroachdb