立即开始
本页面介绍如何在本地环境中从源代码运行 GreptimeDB。
先决条件
系统和架构
目前,GreptimeDB 仅支持 Linux(amd64)和 macOS(amd64 和 Apple Silicone)。
构建依赖项
- Git(可选)
- C/C++ 工具链:提供编译和链接的基本工具。在 Ubuntu 上,这可用作
build-essential
。在其他平台上,也有类似的命令。 - Rust(指南)
- 编译源代码
- Protobuf(指南)
- 编译 proto 文件
- 请注意,版本需要 >= 3.15。你可以使用
protoc --version
检查它。
编译和运行
只需几个命令即可使用以 Standalone 模式启动 GreptimeDB 实例:
git clone https://github.com/GreptimeTeam/greptimedb.git
cd greptimedb
cargo run -- standalone start
接下来,你可以选择与 GreptimeDB 交互的协议。
如果你只想构建服务器而不运行它:
cargo build # --release
根据构建的模式(是否传递了 --release
选项),构建后的文件可以在 $REPO/target/debug
或 $REPO/target/release
目录下找到。
单元测试
GreptimeDB 经过了充分的测试,整个单元测试套件都随源代码一起提供。要测试它们,请使用 nextest。
要使用 cargo 安装 nextest,请运行:
cargo install cargo-nextest --locked
或者,你可以查看他们的文档以了解其他安装方式。
安装好 nextest 后,你可以使用以下命令运行测试套件:
cargo nextest run
Docker
我们还通过 Docker 提供预构建二进制文件,可以在 Docker Hub 上获取。