sie

环境要求

• 一个可用的 Kubernetes 集群（README 示例提供 GKE 专用 values 文件）
• 已安装并能执行 helm 命令
• 已配置可访问 oci://ghcr.io 与 raw.githubusercontent.com 的网络
• 一个 HuggingFace Token（用于拉取模型）

安装与启动步骤

1. 1准备集群环境

   准备一台可用的 Kubernetes 集群并完成本地 kubectl/Helm 配置；README 示例的 values 文件面向 GKE。

2. 2获取 HF Token

   到 HuggingFace 生成访问令牌，安装时通过 --set hfToken.value 传入，不能留空。

3. 3安装 SIE 集群

   用 helm 从 OCI 仓库安装 sie-cluster，创建 sie 命名空间并传入 HF Token 与 GKE values 文件。

   helm upgrade --install sie-cluster oci://ghcr.io/superlinked/charts/sie-cluster \
     --namespace sie --create-namespace \
     --set hfToken.create=true \
     --set hfToken.value=hf_xxxxxxxxxxxxxxxxxxxx \
     -f https://raw.githubusercontent.com/superlinked/sie/main/deploy/helm/sie-cluster/values-gke.yaml

   复制

4. 4固定 Chart 版本

   README 建议固定 chart 版本以保证安装可复现，示例版本为 0.6.18，可按需替换。

   helm upgrade --install sie-cluster oci://ghcr.io/superlinked/charts/sie-cluster \
     --version 0.6.18 \
     --namespace sie --create-namespace \
     --set hfToken.create=true \
     --set hfToken.value=hf_xxxxxxxxxxxxxxxxxxxx \
     -f https://raw.githubusercontent.com/superlinked/sie/main/deploy/helm/sie-cluster/values-gke.yaml

   复制

关键配置

如何确认成功

helm 命令无报错返回即表示提交部署成功，可用 kubectl -n sie get pods 查看 Pod 是否进入 Running。

常见问题

注意事项

• 安装前必须准备可用的 HuggingFace Token，否则模型无法拉取。
• README 示例使用 GKE 专用 values 文件，其他集群需参考官方部署指南调整。
• SIE 默认开启匿名遥测，但不收集 IP、主机名与请求数据，可通过环境变量关闭。
• 建议用 --version 固定 chart 版本，避免后续升级带来的不可复现问题。