在 Google Cloud Platform (GCP) 上部署 ParadeDB

本节提供了在 Google Cloud Platform (GCP) Compute Engine 实例上部署 ParadeDB 的指南。在开始之前，请确保您拥有 Google Cloud 账户，并且可选地安装了 gcloud SDK。

启动 GCP Compute Engine 实例

实例类型

最佳设置可能因您的应用用例而异，但我们推荐使用平衡型机器，如 n2 系列。对于测试，e2-standard 或类似配置就足够了。

存储

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

镜像

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

在您选择了适合您需求的实例后，可以通过 GCP 控制台的“创建实例”按钮启动实例，或者使用 gcloud SDK。

网络

在 GCP 控制台或 CLI 上配置防火墙规则，以允许 TCP 流量通过 ParadeDB 将被暴露的端口，默认为 5432。

安装 ParadeDB

步骤 1：连接到实例

从您的终端或命令提示符，使用 gcloud SDK 通过 SSH 连接到实例：

  1. gcloud compute ssh --project=YOUR_PROJECT_ID --zone=YOUR_ZONE YOUR_INSTANCE_NAME

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

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

  1. sudo apt-get update
  2. sudo apt-get install apt-transport-https ca-certificates curl software-properties-common gnupg
  4. # 添加 Docker 的官方 GPG 密钥：
  5. curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo apt-key add -
  7. # 设置 Docker 仓库：
  8. sudo add-apt-repository "deb [arch=amd64] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable"
  9. sudo apt-get update

安装 Docker：

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

允许非 root 用户使用 Docker：

  1. sudo groupadd docker
  2. sudo usermod -aG docker $USER
  4. # 激活组的更改
  5. newgrp 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 运行的端口上接受连接。

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