在 AWS 上部署 ParadeDB

本节将指导您如何在 AWS 实例上部署 ParadeDB。您需要拥有 AWS 账户，并可选地安装 AWS CLI。

选择 AWS EC2 实例

实例类型

第一步是启动一个 EC2 实例。如果您正在寻找一个生产就绪的设置，我们建议使用存储优化型实例，如 i3 或 d3 系列。如果您只是进行测试或需要开发环境，您可以使用通用型实例，如 t3 或 m5 系列。

存储

我们建议您使用 EBS 卷为您的实例添加存储。通常，对于索引和搜索，建议使用快速的 SSD 存储。对于开始使用，通用目的存储就足够了。然而，如果您正在寻找更高性能的设置，您可以使用 io1 和 io2 这样的预配置 IOPS 卷。实例至少需要 16GB 的存储空间来安装 ParadeDB，此外还需要存储您预计会在 PostgreSQL 数据库中存储的任何数量的数据。

AMI

您可以使用任何 AMI，只要您可以在其中安装 Docker 和 Docker-compose。我们建议使用最新的 Ubuntu LTS AMI。

在您选择了适合您需求的实例后，您可以通过控制台使用“启动实例”按钮启动实例，或者您可以使用 AWS CLI 来执行此操作。

网络

创建一个 EC2 安全组，并在 ParadeDB 将被暴露的端口上设置入站规则，默认为 5432。

安装 ParadeDB

步骤 1：连接到实例

打开终端或命令提示符，导航到您保存与 EC2 实例关联的 *.pem 文件的目录。使用 SSH 连接到实例：

  1. ssh -i "your-key-file.pem" ubuntu@your-instance-public-ip

步骤 2：在实例上安装 Docker 引擎

下面的说明假设您使用的是基于 Debian 的镜像。如果您选择了不同的 AMI，您将需要使用适当的包管理器（即 yum 等）。更新已安装的包并添加 Docker 仓库：

  1. # 添加 Docker 的官方 GPG 密钥：
  2. sudo apt-get update
  3. sudo apt-get install ca-certificates curl gnupg
  4. sudo install -m 0755 -d /etc/apt/keyrings
  5. curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg
  6. sudo chmod a+r /etc/apt/keyrings/docker.gpg
  8. # 将仓库添加到 Apt 源：
  9. echo \
  10.   "deb [arch="$(dpkg --print-architecture)" signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu \
  11.   "$(. /etc/os-release && echo "$VERSION_CODENAME")" stable" | \
  12.   sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
  13. sudo apt-get update

安装 Docker：

  1. sudo apt-get install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

允许非 root 用户使用：

  1. sudo groupadd docker
  2. sudo usermod -aG docker $USER
  4. # 激活组的更改
  5. newgrp docker

将用户添加到 Docker 组后，建议注销并重新登录以使更改生效。

步骤 3：运行 ParadeDB 镜像

拉取并运行 ParadeDB Docker 镜像：

  1. docker run \
  2.   --name paradedb \
  3.   -e POSTGRESQL_USERNAME=<user> \
  4.   -e POSTGRESQL_PASSWORD=<password> \
  5.   -e POSTGRESQL_DATABASE=<dbname> \
  6.   -e POSTGRESQL_POSTGRES_PASSWORD=<superuser_password> \
  7.   -v paradedb_data:/bitnami/postgresql \
  8.   -p 5432:5432 \
  9.   -d \
  10.   paradedb/paradedb:latest

验证 PostgreSQL 服务器是否正在运行：

  1. psql postgresql://your-user:your-password@your-instance-ip:5432/your-db

确保您的实例可以在 PostgreSQL 运行的 TCP 端口上接受连接。

就是这样！您现在可以连接到您的 ParadeDB 实例并开始编写查询。