Grafeo生产部署完全指南:Docker、AWS、Azure、GCP与Kubernetes实战
Grafeo生产部署完全指南:Docker、AWS、Azure、GCP与Kubernetes实战
Grafeo 图数据库生产部署到底该选哪条路?这篇文章将带你走一遍 Grafeo 图数据库的完整部署实战:从最简单的 Docker 一键启动,到 AWS App Runner、Azure Container Apps、GCP Cloud Run 三大云 Serverless 方案,再到 Kubernetes(EKS/GKE/ASK)集群化部署,帮你用最少的成本跑起一个稳定、安全、可扩展的图数据库实例。
上图是 Grafeo 官方 Docker 镜像内置的 Studio Web UI——部署完成后,浏览器打开
http://localhost:7474/studio/就能直接执行 GQL、Cypher、SPARQL 等查询并可视化图谱。
一、先搞清楚:Grafeo 的 4 个 Docker 镜像档位
Grafeo 本身是纯 Rust 编写的高性能图数据库,既可作为嵌入式库,也可通过 grafeo-server 以独立数据库服务形式运行。所有云端部署指南都基于同一套 Docker 镜像,只是档位不同(详见 grafeo-server 文档):
| 档位 | 镜像 Tag | 传输协议 | 适用场景 |
|---|---|---|---|
| gwp | grafeo-server:gwp |
gRPC :7688(约 7 MB) | Sidecar、CI/CD、边缘节点 |
| bolt | grafeo-server:bolt |
Bolt :7687(约 8 MB) | 兼容 Neo4j 驱动 |
| standard | grafeo-server:latest |
HTTP :7474(约 21 MB) | 通用场景 + Studio UI |
| full | grafeo-server:full |
全协议(约 25 MB) | 生产推荐:认证、TLS、AI/搜索 |
新手建议:开发测试用 latest,生产直接用 full,一步到位。
二、Docker 快速部署:3 分钟启动你的图数据库
Docker 是最简单的 Grafeo 部署方式,也是所有云部署的基石(完整教程见 docs/deployment/docker.md)。
方式 1:单条命令启动
# 内存模式(数据不落盘,适合体验)
docker run -p 7474:7474 grafeo/grafeo-server
# 持久化存储(生产必选)
docker run -p 7474:7474 -v grafeo-data:/data grafeo/grafeo-server
方式 2:Docker Compose(推荐生产使用)
services:
grafeo:
image: grafeo/grafeo-server:latest
ports:
- "7474:7474"
volumes:
- grafeo-data:/data
environment:
- GRAFEO_LOG_FORMAT=json
restart: unless-stopped
volumes:
grafeo-data:
docker compose up -d
✅ 验证部署成功:所有 HTTP 档位都暴露健康检查端点:
curl http://localhost:7474/health
# 返回 {"status": "ok", "features": {...}} 即部署成功
三、AWS 生产部署:App Runner 还是 Fargate?
AWS 上有两条路:App Runner(更简单,支持缩容到零)和 ECS Fargate(控制力更强)。官方推荐从 App Runner 入手(完整命令见 docs/deployment/aws.md)。
推荐路径:AWS App Runner
架构极简:Internet → App Runner(自动扩缩) → EFS / S3。核心步骤只有三步:
- (可选)推送镜像到 ECR:
docker tag+docker push; - 创建服务:
aws apprunner create-service,指定镜像grafeo/grafeo-server:full、端口7474、健康检查路径/health、实例规格 1 vCPU / 2 GB; - 获取端点:
aws apprunner describe-service拿到 HTTPS 服务地址即完成。
持久化通过 EFS 卷挂载到 /data 实现(需先创建 VPC Connector)。
💰 成本对比(按 10 GB 存储估算)
| 方案 | 月成本 |
|---|---|
| App Runner(空闲暂停) | 约 $3.00 |
| App Runner(每天运行 1 小时) | 约 $4.90 |
| Fargate(7×24 常开) | 约 $49.00 |
💡 经验法则:间歇性负载选 App Runner(idle 时暂停计费),常驻高负载选 Fargate。
四、Azure 生产部署:Container Apps 缩容到零
Azure Container Apps 是三大云中最省钱的闲置方案——空闲时计算费用为 $0,只收存储费(完整教程见 docs/deployment/azure.md)。
部署分 5 步,核心是两条命令:
# 1. 创建容器应用环境
az containerapp env create --name grafeo-env \
--resource-group grafeo-rg --location westeurope
# 2. 部署 grafeo-server(关键参数解释见下)
az containerapp create --name grafeo-server \
--resource-group grafeo-rg --environment grafeo-env \
--image grafeo/grafeo-server:full --target-port 7474 \
--ingress external --min-replicas 0 --max-replicas 3 \
--cpu 1.0 --memory 2.0Gi \
--env-vars GRAFEO_DATA_DIR=/data GRAFEO_LOG_FORMAT=json
关键参数解读:
--min-replicas 0:缩容到零,空闲零计算费用(冷启动仅 1-3 秒);--max-replicas 3:负载上来时自动扩容;--ingress external:自动创建带 TLS 的公网 HTTPS 端点。
💰 成本参考:完全空闲约 $0.18/月;每天查 1 小时约 $1.48/月——对开发测试环境几乎免费。
五、GCP 生产部署:Cloud Run 是最省心的 Serverless
GCP 的 Cloud Run 被官方称为"三大云中最直观的 Serverless 方案"(完整教程见 docs/deployment/gcp.md)。一条命令完成部署:
gcloud run deploy grafeo-server \
--image grafeo/grafeo-server:full \
--port 7474 --region europe-west4 \
--min-instances 0 --max-instances 3 \
--cpu 1 --memory 2Gi \
--set-env-vars "GRAFEO_LOG_FORMAT=json"
两个需要留意的点:
- 持久化:Cloud Run 容器默认是无状态的,需挂载 Cloud Storage 卷(
--add-volume type=cloud-storage)或更高性能的 Filestore(NFS); - 访问控制:
--no-allow-unauthenticated可关闭匿名访问,改用 IAM 授权,仅允许指定用户/服务账号查询。
💰 成本参考:空闲约 $0.20/月;每天查询 1 小时约 $2.80/月。
六、Kubernetes 部署:EKS / GKE / ASK 全通用
如果你已有 K8s 集群(AWS EKS、GCP GKE、Azure ASK 或自建集群),部署方式完全一致(完整 YAML 见 docs/deployment/kubernetes.md)。你需要 3 个资源清单:
- PVC(
grafeo-data,ReadWriteOnce,10Gi)——持久化存储; - Deployment——镜像
grafeo/grafeo-server:full,端口 7474,并务必配置:livenessProbe/readinessProbe都指向/health;- 资源请求 500m/512Mi,上限 2 CPU/2Gi;
- Service(ClusterIP,7474)——集群内暴露。
之后按需叠加:
- Ingress + cert-manager:为
grafeo.example.com自动签发 TLS 证书; - HPA 水平自动扩缩:CPU 70% 时最多扩到 5 副本;
- 全协议端口:full 档位可同时开放
7474 (HTTP)、7687 (Bolt)、7688 (GWP)。
⚠️ 注意:K8s 方案的 PVC 是
ReadWriteOnce,意味着单个写入节点;读扩展靠副本 + 外部负载均衡,这是与 Serverless 方案最大的架构差异。
七、5 种部署方案怎么选?一图对比
| 方案 | 最适合 | 缩容到零 | 上手难度 |
|---|---|---|---|
| Docker | 自建、虚拟机、本地开发 | 否 | ⭐ 低 |
| Azure Container Apps | 追求最低云成本 | ✅ | ⭐⭐ 中 |
| AWS App Runner | AWS 生态、间歇负载 | 部分 | ⭐⭐ 中 |
| GCP Cloud Run | 最省心的 Serverless | ✅ | ⭐⭐ 中 |
| Kubernetes | EKS/GKE/ASK 集群化 | Pod 级 | ⭐⭐⭐ 较高 |
(对比数据来自官方部署索引 docs/deployment/index.md)
八、生产上线前检查清单 📋
所有部署方案共享同一套环境变量(参考 完整配置文档):
| 变量 | 默认值 | 说明 |
|---|---|---|
GRAFEO_DATA_DIR |
无 | 持久化路径;不设置 = 内存模式,重启丢数据 |
GRAFEO_QUERY_TIMEOUT |
30 |
查询超时(秒) |
GRAFEO_SESSION_TTL |
300 |
事务会话超时(秒) |
GRAFEO_LOG_FORMAT |
pretty |
云端日志请用 json |
GRAFEO_AUTH_TOKEN |
无 | Bearer 令牌(仅 full 档位) |
上生产前最后确认这 5 件事:
- ✅ 使用
grafeo-server:full镜像(认证、TLS、搜索功能都在此档位); - ✅ 设置
GRAFEO_DATA_DIR=/data并挂载持久卷(EFS / Azure Files / GCS / PVC); - ✅ 设置
GRAFEO_AUTH_TOKEN开启认证,并启用 TLS(详见 安全最佳实践); - ✅ 健康检查指向
/health,日志格式设为json以便接入云日志系统; - ✅ 定期更新镜像:所有云平台(App Runner / Container Apps / Cloud Run / K8s)均支持滚动更新、零停机升级。
总结:Grafeo 图数据库的部署矩阵非常清晰——本地和自建环境用 Docker Compose,追求低成本 Serverless 选 Azure/GCP 缩容到零,已有 K8s 集群则直接用 PVC + 健康探针的标准化清单。5 分钟选对方案,就能把这套支持 GQL、Cypher、SPARQL 等多种查询语言的高性能图数据库稳稳跑进生产。🚀
