geodedb/geode

Geode Docker 镜像文档

镜像概述和主要用途

Geode 是一款企业级图数据库，完全实现了ISO/IEC 39075:2024 Graph Query Language (GQL)标准。本镜像提供了便捷的容器化部署方式，支持多种环境配置，包括生产环境、资源受限环境以及需要GPU加速的场景。

核心功能和特性

• GQL标准兼容：100%符合ISO/IEC 39075:2024 GQL标准
• 多镜像变体：提供标准版、轻量级Alpine版和GPU加速版
• 高性能：基于QUIC协议的UDP通信，支持分布式查询和自动负载均衡
• 安全特性：支持透明数据加密(TDE)、字段级加密(FLE)和KMS集成
• 可扩展性：支持多节点集群部署，自动分片和结果合并
• 监控集成：内置Prometheus指标端点，支持健康检查

使用场景和适用范围

• 生产部署：使用标准镜像处理企业级图数据工作负载
• 资源受限环境：Alpine镜像适用于边缘设备或低资源环境
• GPU加速场景：GPU镜像用于图形算法、向量操作和机器学习嵌入加速
• 分布式系统：多节点集群配置支持大规模图数据存储和查询

快速开始

bash
# 拉取最新镜像
docker pull geodedb/geode:latest

# 使用默认设置运行
docker run -d \
  --name geode \
  -p 3141:3141/udp \
  -p 9091:9091/tcp \
  -v geode-data:/data \
  geodedb/geode:latest

# 使用自定义配置运行
docker run -d \
  --name geode \
  -p 3141:3141/udp \
  -p 9091:9091/tcp \
  -v geode-data:/data \
  -v ./certs:/certs:ro \
  -e LOG_LEVEL=info \
  geodedb/geode:latest \
  --data-dir /data \
  --listen 0.0.0.0:3141 \
  --cert /certs/server.crt \
  --key /certs/server.key

镜像变体

标准镜像 (geodedb/geode:latest)

• 基础镜像：Debian Bookworm Slim
• 大小：约150MB
• 适用场景：生产部署、通用工作负载
• 标签：latest、0.18.0、0.18

Alpine镜像 (geodedb/geode:alpine)

• 基础镜像：Alpine Linux 3.20
• 大小：约50MB
• 适用场景：最小化部署、资源受限环境
• 标签：alpine、0.18.0-alpine

GPU加速镜像 (geodedb/geode:gpu)

• 基础镜像：NVIDIA CUDA 12.3.2 Runtime (Ubuntu 22.04)
• 大小：约2GB
• 适用场景：GPU加速图形算法、向量操作、机器学习嵌入
• 标签：gpu、0.18.0-gpu
• 要求：NVIDIA Container Toolkit、支持CUDA的GPU

GPU与非GPU版本对比

运行GPU加速容器

bash
# 需要安装NVIDIA Container Toolkit
docker run -d \
  --name geode-gpu \
  --gpus all \
  -p 3141:3141/udp \
  -p 9091:9091/tcp \
  -v geode-data:/data \
  -e GPU_ENABLED=true \
  -e CUDA_VISIBLE_DEVICES=0 \
  geodedb/geode:gpu \
  --gpu-acceleration

暴露端口

注意：Geode仅使用QUIC（UDP）进行数据库连接，不支持TCP回退。

卷

环境变量

核心配置

查询引擎

存储与WAL

集群与分布式

加密 - 透明数据加密(TDE)

加密 - KMS集成

安全与访问控制

监控与遥测

备份与恢复

GPU配置（仅GPU镜像）

QUIC性能

命令行参数

容器入口点为geode serve，可传递以下参数：

bash
docker run geodedb/geode:latest \
  --data-dir /data \
  --listen 0.0.0.0:3141 \
  --cert /certs/server.crt \
  --key /certs/server.key \
  --log-level info

加密配置

透明数据加密(TDE)

TDE使用AES-256-GCM加密所有静态数据。通过提供256位密钥启用：

bash
# 生成安全的256位密钥（64个十六进制字符）
openssl rand -hex 32

# 启用TDE运行
docker run -d \
  --name geode-encrypted \
  -p 3141:3141/udp \
  -v geode-data:/data \
  -e GEODE_ENABLE_TDE=true \
  -e GEODE_TDE_KEY=0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef \
  geodedb/geode:latest

KMS提供商集成

企业部署可与HashiCorp Vault或其他KMS提供商集成：

yaml
services:
  geode:
    image: geodedb/geode:latest
    environment:
      - GEODE_ENABLE_TDE=true
      - GEODE_KMS_PROVIDER=vault
      - VAULT_ADDR=http://vault:8200
      - VAULT_TOKEN=${VAULT_TOKEN}
      - GEODE_VAULT_KEY_PATH=geode/encryption
    depends_on:
      - vault

  vault:
    image: hashicorp/vault:latest
    cap_add:
      - IPC_LOCK
    environment:
      - VAULT_DEV_ROOT_TOKEN_ID=${VAULT_TOKEN}
    ports:
      - "8200:8200"

TDE的Vault设置

bash
# 启用KV密钥引擎
vault secrets enable -path=geode kv-v2

# 存储主加密密钥
vault kv put geode/encryption \
  key="$(openssl rand -hex 32)"

# 配置访问策略
vault policy write geode-tde - <<EOF
path "geode/*" {
  capabilities = ["create", "read", "update", "delete", "list"]
}
EOF

字段级加密(FLE)

Geode支持敏感属性的字段级加密：

bash
docker run -d \
  --name geode \
  -e GEODE_ENABLE_TDE=true \
  -e GEODE_TDE_KEY=${TDE_KEY} \
  geodedb/geode:latest

使用GQL定义加密字段：

gql
CREATE NODE TYPE Person (
  name STRING,
  ssn STRING ENCRYPTED,
  email STRING ENCRYPTED
)

集群配置

分布式查询协调

Geode支持跨多个分片的分布式查询执行，具有自动负载平衡和结果合并功能。

3节点集群Docker Compose配置

yaml
version: '3.8'

services:
  geode-node1:
    image: geodedb/geode:latest
    container_name: geode-node1
    hostname: geode-node1
    ports:
      - "3141:3141/udp"
      - "9091:9091/tcp"
    environment:
      - LOG_LEVEL=info
      - GEODE_CLUSTER_NAME=production
      - GEODE_NODE_ID=1
      - GEODE_MAX_SHARDS=16
      - GEODE_DATA_DIR=/data
      - GEODE_HEARTBEAT_INTERVAL_MS=***
      - GEODE_CONNECTION_POOL_SIZE=20
    volumes:
      - geode-node1-data:/data
      - ./certs:/certs:ro
    networks:
      - geode-cluster
    sysctls:
      - net.core.rmem_max=7340032
      - net.core.wmem_max=7340032

  geode-node2:
    image: geodedb/geode:latest
    container_name: geode-node2
    hostname: geode-node2
    ports:
      - "3142:3141/udp"
      - "9092:9091/tcp"
    environment:
      - LOG_LEVEL=info
      - GEODE_CLUSTER_NAME=production
      - GEODE_NODE_ID=2
      - GEODE_MAX_SHARDS=16
      - GEODE_DATA_DIR=/data
      - GEODE_HEARTBEAT_INTERVAL_MS=***
      - GEODE_CONNECTION_POOL_SIZE=20
    volumes:
      - geode-node2-data:/data
      - ./certs:/certs:ro
    networks:
      - geode-cluster
    sysctls:
      - net.core.rmem_max=7340032
      - net.core.wmem_max=7340032

  geode