创建应用需要 Operator 或 Admin,并且目标分组已经存在。先准备镜像、容器端口和必需配置;需要持久化数据时,还应由管理员准备目标服务器的数据卷。
从空白配置开始
- 在侧栏找到目标分组,点击创建应用。
- 填写唯一的应用名称和可选描述。名称在整个平台中唯一,不能只依赖分组区分重名应用。
- 填写镜像;私有镜像在镜像设置中填写用户名和密码或令牌。
- 按镜像要求配置启动命令、环境变量、端口和文件。
- 设置副本、资源和调度条件;简单无状态应用可先使用默认值。
- 检查全部配置后创建,等待应用概览显示运行结果。
名称为 1–16 个小写字母、数字或连字符,首尾不能是连字符;平台保留名称不能使用。描述最多 500 个字符。控制台不提供创建后的应用改名操作。
创建时应明确的设置
| 设置 | 说明 |
|---|---|
| 镜像 | 使用仓库实际存在的镜像与标签 |
| 启动命令 | 留空使用镜像默认值;自定义命令需要包含可执行程序 |
| 环境变量 | 按镜像文档填写,值不自动进行 shell 展开 |
| 发布端口 | 容器内端口与客户端访问端口分别填写 |
| 文件与存储 | 选择配置文件或本地数据方式,提前确认有状态限制 |
| 资源与副本 | 按单个副本计算资源,确认服务器有足够容量 |
首次练习可使用完整 Nginx 示例。
使用数据库模板
创建页面提供 PostgreSQL 18 和 MariaDB 12 模板。镜像从远程发布目录读取,模板预填端口、环境变量和生成的密码,仍需你选择目标服务器与数据卷。目录不可用且没有成功加载的缓存时,仍可手动创建应用。目录更新只影响之后打开的表单,不修改已有应用。
- 选择数据库模板,确认镜像版本和生成的环境变量。
- 保存生成的密码到你自己的凭据管理工具。
- 选择已准备的数据卷及模板对应的数据目录。
- 如果数据库只供同分组应用访问,移除不必要的对外发布端口。
- 创建后检查数据库初始化日志,再使用客户端验证连接。
模板是部署配置的起点。已有数据的格式兼容、数据库升级和备份仍需遵循数据库自身的规则,详见有状态应用。
默认行为与验证
从空白表单创建时,应用默认固定一个副本,使用镜像默认命令和宿主机日志设置;没有额外资源预留或调度标签。默认更新策略为全部副本并行、先停止旧副本、观察 60 秒、失败比例阈值 0,失败动作是回滚。业务有连续服务要求时,创建后应检查更新策略。
保存成功后先看实际副本,再看应用日志,最后验证客户端请求。配置无变化时,重复保存不会强制重新部署;需要替换运行容器时使用重启操作。
配置页面中的环境变量和文件内容不应被视作个人私密存储。平台只对明确识别的秘密字段脱敏,其他共享配置可能被具备读取权限的账户看到。
需要业务级检查时配置 XHealth;需要在推广新配置前验证候选实例时,再了解 Guardian。
验证与失败处理
副本进入运行状态后,检查业务响应或数据库连接。镜像下载失败时先核对仓库与凭据;等待调度时检查资源、标签及目标服务器;进程反复退出时检查日志、命令、环境变量和挂载路径。
创建请求超时或返回错误后,先回到应用列表确认资源是否已经出现,再决定是否重试。不要通过连续创建相同名称来判断操作是否成功。