立即开始

本页面介绍如何在本地环境中从源代码运行 GreptimeDB。

先决条件

系统和架构

目前，GreptimeDB 支持 Linux（amd64 和 arm64）、macOS（amd64 和 Apple Silicone）和 Windows。

构建依赖项

  • Git（可选）
  • C/C++ 工具链：提供编译和链接的基本工具。在 Ubuntu 上，这可用作 build-essential。在其他平台上，也有类似的命令。
  • Rust（指南）
    • 编译源代码
  • Protobuf（指南）
    • 编译 proto 文件
    • 请注意，版本需要 >= 3.15。你可以使用 protoc --version 检查它。
  • 机器：建议内存在16GB以上 或者 使用mold工具以降低链接时的内存使用。

编译和运行

只需几个命令即可使用以 Standalone 模式启动 GreptimeDB 实例:

  1. git clone https://github.com/GreptimeTeam/greptimedb.git
  2. cd greptimedb
  3. cargo run -- standalone start

接下来，你可以选择与 GreptimeDB 交互的协议。

如果你只想构建服务器而不运行它：

  1. cargo build # --release

根据构建的模式（是否传递了 --release 选项），构建后的文件可以在 $REPO/target/debug 或 $REPO/target/release 目录下找到。

单元测试

GreptimeDB 经过了充分的测试，整个单元测试套件都随源代码一起提供。要测试它们，请使用 nextest。

要使用 cargo 安装 nextest，请运行：

  1. cargo install cargo-nextest --locked

或者，你可以查看他们的文档以了解其他安装方式。

安装好 nextest 后，你可以使用以下命令运行测试套件：

  1. cargo nextest run

Docker

我们还通过 Docker 提供预构建二进制文件，可以在 Docker Hub 上获取。