GreptimeDB 单机模式

安装

我们先通过最简单的配置来开始。有关 GreptimeDB 中可用的所有配置选项的详细列表,请参考配置文档

二进制

你可以在下载页面通过发布的最新稳定版本尝试使用 GreptimeDB。

Linux 或 macOS

如果你使用的是 Linux 或 macOS,可以通过以下命令下载 greptime binary 的最新版本:

  1. curl -fsSL \
  2. https://raw.githubusercontent.com/greptimeteam/greptimedb/main/scripts/install.sh | sh -s v0.9.3

下载完成后,binary 文件 greptime 将存储在当前的目录中。

你可以在单机模式下运行 GreptimeDB:

  1. ./greptime standalone start

Windows

若您的 Windows 系统已开启 WSL(Windows Subsystem for Linux),您可以直接打开一个最新的 Ubuntu 接着如上所示运行 GreptimeDB !

否则请到我们的官网下载并解压最新的 GreptimeDB for Windows 安装包。

在单机模式下运行 GreptimeDB,您可以在 GreptimeDB 二进制所在的文件夹下打开一个终端(比如 Powershell ),执行:

  1. .\greptime standalone start

Docker

请确保已经安装了 Docker。如果还没有安装,可以参考 Docker 官方的文档进行安装。

  1. docker run -p 127.0.0.1:4000-4003:4000-4003 \
  2. -v "$(pwd)/greptimedb:/tmp/greptimedb" \
  3. --name greptime --rm \
  4. greptime-registry.cn-hangzhou.cr.aliyuncs.com/greptime/greptimedb:v0.9.3 standalone start \
  5. --http-addr 0.0.0.0:4000 \
  6. --rpc-addr 0.0.0.0:4001 \
  7. --mysql-addr 0.0.0.0:4002 \
  8. --postgres-addr 0.0.0.0:4003

GreptimeDB 单机模式 - 图1注意事项

为了防止不小心退出 Docker 容器,你可能想以 “detached” 模式运行它:在 docker run 命令中添加 -d 参数即可。

数据将会存储在当前目录下的 greptimedb/ 目录中。

如果你想要使用另一个版本的 GreptimeDB 镜像,可以从我们的 GreptimeDB Dockerhub 下载。

GreptimeDB 单机模式 - 图2注意事项

如果正在使用小于 v23.0 的 Docker 版本,由于旧版本的 Docker Engine 中存在 bug,所以当你尝试运行上面的命令时,可能会遇到权限不足的问题。

你可以:

  1. 设置 --security-opt seccomp=unconfined
  1. docker run --security-opt seccomp=unconfined -p 4000-4003:4000-4003 \
  2. -v "$(pwd)/greptimedb:/tmp/greptimedb" \
  3. --name greptime --rm \
  4. greptime-registry.cn-hangzhou.cr.aliyuncs.com/greptime/greptimedb:v0.9.3 standalone start \
  5. --http-addr 0.0.0.0:4000 \
  6. --rpc-addr 0.0.0.0:4001 \
  7. --mysql-addr 0.0.0.0:4002 \
  8. --postgres-addr 0.0.0.0:4003
  1. 将 Docker 版本升级到 v23.0.0 或更高;

绑定地址

GreptimeDB 默认绑定地址为 127.0.0.1。如果你需要能够接收来自所有地址的连接,可以通过以下参数启动。

GreptimeDB 单机模式 - 图3危险操作

如果运行 GreptimeDB 的计算机直接向互联网暴露服务,那么绑定 0.0.0.0 会十分危险,因为这将数据库实例暴露给互联网上的所有人。

  • 二进制
  • Docker
  1. ./greptime standalone start \
  2. --http-addr 0.0.0.0:4000 \
  3. --rpc-addr 0.0.0.0:4001 \
  4. --mysql-addr 0.0.0.0:4002 \
  5. --postgres-addr 0.0.0.0:4003
  1. docker run -p 0.0.0.0:4000-4003:4000-4003 \
  2. -v "$(pwd)/greptimedb:/tmp/greptimedb" \
  3. --name greptime --rm \
  4. greptime-registry.cn-hangzhou.cr.aliyuncs.com/greptime/greptimedb:v0.9.3 standalone start \
  5. --http-addr 0.0.0.0:4000 \
  6. --rpc-addr 0.0.0.0:4001 \
  7. --mysql-addr 0.0.0.0:4002 \
  8. --postgres-addr 0.0.0.0:4003

你也可以参考配置 GreptimeDB文档在配置文件中修改绑定的地址。

下一步

学习如何使用 GreptimeDB:快速开始