Croupier

Appearance

配置管理 ​

Croupier 当前使用 YAML 配置文件驱动运行时行为。本文档只描述仓库中仍然生效的配置入口。

配置优先级 ​

  1. YAML 文件
  2. 环境变量
  3. 命令行参数

当前仓库不再维护 services/*/etc、includes、profiles 这套旧布局，统一以 configs/*.yaml 为准。

Server 配置 ​

configs/server.yaml 中最关键的几组配置如下：

yaml
server:
  host: 0.0.0.0
  port: 18780
  timeout: 600000
  mode: dev

database:
  driver: mysql
  dataSource: "${DATABASE_URL}"

control:
  addr: ":19090"

auth:
  jwtSecret: "${JWT_SECRET}"
  rbacConfig: "configs/rbac.json"

storage:
  driver: file
  baseDir: "data/uploads"

log:
  level: info
  format: console

常见覆盖项 ​

bash
export DATABASE_URL="postgres://user:pass@localhost:5432/croupier?sslmode=disable"
export JWT_SECRET="change-me"
./bin/croupier-server --config configs/server.yaml --port 18780

Agent 配置 ​

configs/agent.yaml 当前对应的是 Agent 启动配置：

yaml
name: croupier-agent
host: 0.0.0.0
port: 19091

server:
  addr: "server:19090"
  insecure: false

agent:
  id: ""
  gameId: ""
  env: ""
  localAddr: "agent:19091"
  httpAddr: "agent:19091"

upstream:
  heartbeatInterval: 30
  retryInterval: 5
  maxRetries: 3
  timeout: 10000

outboundTLS:
  enabled: false

政策配置 ​

configs/default-policies.yaml 定义了不同风险等级函数的默认政策：

yaml
low:
  require_approval: false
  require_audit: false
  allowed_roles:
    - user
    - operator

medium:
  require_approval: false
  require_audit: true
  allowed_roles:
    - operator

high:
  require_approval: true
  approval_workflow: single_admin
  require_audit: true
  allowed_roles:
    - admin

danger:
  require_approval: true
  approval_workflow: two_person
  require_audit: true
  allowed_roles:
    - super_admin

字段说明：

字段说明
require_approval是否需要审批
approval_workflow审批流程类型（single_admin/two_person）
require_audit是否需要审计
allowed_roles允许调用的角色列表

双层政策架构：

  1. 默认政策：来自 default-policies.yaml，根据函数风险等级自动应用
  2. 覆盖政策：存储在数据库中，可通过 API 为特定函数设置覆盖规则

重新加载配置：

bash
# API 方式
POST /api/v1/policies/reload

# 重启服务自动加载
./bin/croupier-server --config configs/server.yaml

配置验证 ​

bash
./bin/croupier-server --config configs/server.yaml validate

常见错误：

错误原因解决方法
invalid address地址格式错误检查 Control.Addr、Server.Addr
certificate not found证书文件路径错误检查证书文件是否存在
database connection failedDSN 错误检查数据库连接字符串
permission denied文件权限不足检查配置、证书和数据目录权限

最佳实践 ​

使用环境变量管理敏感信息 ​

bash
JWT_SECRET=your-jwt-secret
DATABASE_URL=postgres://...
STORAGE_AK=your-access-key
STORAGE_SK=your-secret-key

为本地调试保留副本 ​

bash
cp configs/server.yaml configs/server.local.yaml
cp configs/agent.yaml configs/agent.local.yaml

修改后做一次验证 ​

bash
./bin/croupier-server --config configs/server.local.yaml validate

下一步 ​