部署指南

本文档只保留当前仓库已有产物对应的部署方式：Docker 镜像、docker compose 和二进制部署。

推荐组件

  • Server
  • Agent
  • MySQL 或 PostgreSQL
  • Redis
  • 可选：analytics-worker、ingest、ClickHouse

Docker 部署

直接使用 compose

docker compose up -d

当前镜像构建入口：

  • docker/Dockerfile.server -> ./cmd/server
  • docker/Dockerfile.agent -> ./cmd/agent
  • docker/Dockerfile.analytics-worker -> ./cmd/analytics-worker
  • docker/Dockerfile.ingest -> ./cmd/ingest

单独构建镜像

docker build -t croupier-server:latest -f docker/Dockerfile.server .
docker build -t croupier-agent:latest -f docker/Dockerfile.agent .

二进制部署

Server

make server
./bin/croupier-server --config configs/server.yaml

Agent

make agent
./bin/croupier-agent --config configs/agent.yaml

Analytics 链路

make worker
make ingest
./bin/analytics-worker
ANALYTICS_INGEST_SECRET=dev-secret ./bin/ingest --addr :8088 --secret dev-secret

服务安装脚本

仓库已提供：

  • scripts/install-systemd.sh
  • scripts/install-launchd.sh
  • scripts/install-windows-service.ps1

健康检查

curl http://localhost:18780/api/v1/monitoring/health
curl http://localhost:8088/healthz

部署建议

  1. 数据库和 Redis 使用外部托管实例，不与应用容器共存储。
  2. 生产环境不要直接使用仓库默认的 configs/*.yaml，应复制后按环境落地。
  3. 通过环境变量注入 DATABASE_URL、JWT_SECRET、对象存储密钥等敏感项。
  4. Server 对外暴露 HTTP 入口，Agent 走内网或专线接入。

下一步