Files
ssw-mpc/examples/12_k8s_two_party
admin 49b421c23a feat(examples): 新增 mpc-examples,12 个场景对齐 nax/examples
- 新 workspace 成员 examples/(crate mpc-examples,publish = false):一场景一 bin,
  跑法 cargo run -p mpc-examples --bin 03_vertical_lr;src/lib.rs 只提供参与方启动、
  定点编解码、输出与断言,算法全在正文,调的是 mpc-* 真接口
- 12 个场景:01 密文四则/矩阵/sigmoid、02 PSI、03 纵向 LR、04 FedAvg、05 出域策略、
  06 DP-FedAvg、07 密文推理、08 PIR、09 SCQL、10 分箱 WOE/IV、11 试跑、12 两方部署
- 12 的部署物在 examples/12_k8s_two_party/:多阶段 Dockerfile + namespace /
  alice(Headless Service + Job,--listen)/ bob(Job,--connect)+ README;
  单二进制一条 TCP,不经 Ray,调度交给 k8s
- tools/ci.sh 加第 4 关「示例冒烟」,调新增的 tools/examples.sh:逐 bin 跑,
  判据为退出码 0 且输出无 [!!](check() 只打印不中断,只看退出码会漏断言)
- 正文记录三条实测契约:matmul_trunc 两入参都须是分片,否则结果翻倍;
  sigmoid_poly 只在 ±6 内有效,越界发散到 1e6;多项式输出须先 reveal 再解码
- 实测:07 密文与明文偏差 1.97e-5 且 AUC 一致;09 密态与明文逐组一致;
  11 同为 4 组 GROUP BY,逐组比较 156 轮 vs 整数码 23 轮
2026-11-05 20:55:07 +08:00
..

示例 12:在 Kubernetes 上起两个参与方

本例是 mpc 的真实分布式形态:两个参与方各跑在一个 Pod 里,密文分片只留在 自己的 Pod,明文不出域。业务代码与单机演示完全一致,变的只有 transport (Pipe → TcpTransport)。

与 Python 版 nax 的 12_k8s_two_party 最大的不同:mpc 不需要 Ray。单二进制 + 一条 TCP 就够了,Ray 那套 --resources={"alice_node":1} 的资源打标在这里是多余的。

架构

┌──────────────────────── mpc-demo namespace ────────────────────────┐
│                                                                    │
│  Job mpc-alice                         Job mpc-bob                 │
│  ┌──────────────────────┐              ┌──────────────────────┐    │
│  │ mpc node             │              │ mpc node             │    │
│  │  --site=alice        │◀── TCP ──────│  --site=bob          │    │
│  │  --listen 0.0.0.0:9449              │  --connect ...:9449  │    │
│  │  --data=1,2,3,4      │              │  --data=5,6,7,8      │    │
│  └──────────────────────┘              └──────────────────────┘    │
│            ▲                                                       │
│            │ Headless Service mpc-alice:9449                       │
│            └── bob 通过 DNS 直连 Pod IP,不经 kube-proxy 转发       │
└────────────────────────────────────────────────────────────────────┘

两边挂同一个 Secret 做 PSK 认证;没配 PSK 也能跑,但既不认证身份也不加密链路。

文件

文件 作用
Dockerfile 多阶段构建,产出只含 mpc 二进制的 debian-slim 镜像
k8s/00-namespace.yaml 命名空间 mpc-demo
k8s/10-alice.yaml 被动方:Headless Service + Job(--listen)
k8s/20-bob.yaml 主动方:Job(--connect)
../src/bin/12_k8s_two_party.rs 本地等价演练 + 清单自检(cargo run -p mpc-examples --bin 12_k8s_two_party)

跑起来

# 0) 先本地确认应该看到什么(秒级,不需要集群)
cargo run -p mpc-examples --bin 12_k8s_two_party
#   → 期望值 74 / 密态结果 74,清单自检全绿

# 1) 构建镜像(上下文必须是仓库根目录)
docker build -f examples/12_k8s_two_party/Dockerfile -t mpc:demo .

# 2) 建 PSK
kubectl create namespace mpc-demo
kubectl -n mpc-demo create secret generic mpc-psk \
  --from-literal=psk=$(openssl rand -hex 32)

# 3) 部署
kubectl apply -f examples/12_k8s_two_party/k8s/

# 4) 看结果 —— 两个 Job 的日志里都应该是 74
kubectl -n mpc-demo logs job/mpc-alice
kubectl -n mpc-demo logs job/mpc-bob

# 5) 清理
kubectl delete ns mpc-demo

backoffLimit 让 bob 在 alice 还没起来时自动重试,不需要 initContainer 轮询。

部署注意要点

  • --sites 顺序决定 party 下标。两边必须逐字一致(alice,bob 不能写成 bob,alice), 否则两边对「谁是 0 号」的理解不同,第一个 open 就会拿到长度对不上的帧。
  • --fxp 必须一致。18 和 16 混用会在第一个算子报尺度不符,而不是在握手时报错。
  • 域分隔标签变更 = 换钥。从 nax/* 切到 mpc/*(v0.2.0)后,旧的 TEE blob、 PSI 缓存、离线物料全部作废;两方必须同步升级,没有双读兼容。
  • 内存与 CPU 很小。这一课只跑 4 个元素的会话,512Mi 绰绰有余;真实任务要按 矩阵规模 × 列数估算,MPC 的中间态是数据量的数倍。
  • 只绑内网。--listen 0.0.0.0 在 Pod 里没问题(Pod 网络本身就是隔离的), 但把 Service 暴露成 NodePort/LoadBalancer 就等于把 MPC 端口放到公网。
  • 镜像可以先不推仓库。单节点集群(kind / k3s / OrbStack)与 docker 共享镜像库, imagePullPolicy: IfNotPresent 直接吃本地 mpc:demo。

为什么不用 Ray

deploy/ray/ 里有一套 Ray 适配,但那条路的收益在调度(把 N 个参与方分到 N 台机器), 代价是引入一个 Python 运行时和一套 GCS。k8s 已经把调度做完了,剩下的只是「两个进程 互相连一条 TCP」——mpc node 原生就会,不需要中间层。