解决方案Solutions / 部署指南Deployment guide
八步,从一台机器
到全员上手Eight steps from one machine to the whole team
这是上线的全貌。每一步的具体操作见管理员手册。1.0 的部署由 ECode 团队和你一起完成。
This is the whole path to go-live. The admin guide has the exact steps for each one. In 1.0, the ECode team deploys alongside you.
准备Before you start
-
一台机器One machine
本地 + 云:企业现场的一台 GPU 主机。纯云:企业自己的一台云服务器。
Local plus cloud: a GPU box at your site. Cloud only: a cloud VM in your own account.
-
一个 https 地址An https address
员工通过它连接控制台。客户端只接受 https 的控制台地址。
Employees reach the Console at this address. The client accepts only https Console URLs.
-
一个企业身份源An identity provider
支持通用 OIDC 或 Microsoft Entra ID。
Generic OIDC or Microsoft Entra ID.
上线步骤Steps to go live
- 部署控制台和模型网关Deploy the Console and the model gateway两者部署在同一台机器上。本地 + 云的机器同时运行本地模型。Both run on the same machine. In local plus cloud, that machine also runs the local models.
- 设置企业名称和企业码Set the enterprise name and code企业名称显示在员工的确认页面和登录卡片上。企业码是 2 到 32 位小写字母、数字或连字符,首位不能是连字符,创建后不能修改。联系 ECode 团队把企业码登记到企业目录。The name appears on the employee's confirm page and sign-in card. The code is 2 to 32 lowercase letters, digits or hyphens, cannot start with a hyphen, and cannot change once created. Contact the ECode team to register it in the enterprise directory.
- 接入企业身份源Connect your identity provider在 SSO 连接页配置通用 OIDC 或 Microsoft Entra ID,把员工的邮箱域名加入白名单。On the SSO connection page, set up generic OIDC or Microsoft Entra ID, and add your employees' email domain to the allowlist.
- 接入模型Add models在本地算力页启动本地模型,在模型与供应商页添加云端模型,并确认它们在员工看到的模型目录里。Start local models on the Local compute page, add cloud models on the Models and providers page, and make sure they appear in the catalog employees see.
- 设置新员工默认配额Set default quotas预算、周期、每分钟请求数、每分钟 token 数和可用模型。新员工第一次登录时按它开通。Budget, period, requests and tokens per minute, and allowed models. New employees get these at their first sign-in.
- 发布客户端Publish the client在版本发布页上传 macOS 和 Windows 安装包,在下载密钥页签发密钥。Upload the macOS and Windows installers on the Releases page, and issue a key on the Download keys page.
- 通知员工Invite employees把下载页地址、下载密钥和企业码发给员工。员工安装客户端、连接企业、用企业账号登录。Send employees the download page address, the download key and the enterprise code. They install the client, connect, and sign in with their enterprise account.
上线之后After go-live
-
看用量Watch usage
在用量统计和请求日志里按人、按模型查看。在员工配额页调整额度。
Check usage per person and per model in Usage and the request log. Adjust quotas on the quota page.
-
看审计Review the audit log
登录、额度修改、模型启停、密钥签发都会记入审计日志。
Sign-ins, quota changes, model starts and stops, and key issuance all land in the audit log.
-
做备份Back up
备份密钥文件、控制台数据库、网关数据库和本地模型数据。上线前先演练一次恢复。
Back up the secrets file, the Console database, the gateway database and the local model data. Rehearse a restore once before go-live.