5 分钟快速开始¶
目标：快速了解当前平台能力和核心概念。
平台能提供什么？¶
🚀 应用部署 - Dokploy¶
- Docker Compose：用 Compose 描述服务
- Web UI：可视化部署、日志、环境变量
- 访问地址：
https://cloud.${INTERNAL_DOMAIN}
🗄️ 数据库服务¶
- PostgreSQL - 平台共享数据库
- Redis - 平台共享缓存
🔐 密钥管理 - Vault¶
- 统一存储：数据库密码、API Key 统一管理
- 访问地址：
https://vault.${INTERNAL_DOMAIN}
🔑 SSO 登录 - Authentik¶
- 统一身份：OIDC 认证
- 访问地址：
https://sso${ENV_DOMAIN_SUFFIX}.${INTERNAL_DOMAIN}
🔄 工作流编排 - Perfect (Prefect)¶
- 任务调度：定时任务、数据流水线
- 可视化监控：流程执行状态、日志查看（需 SSO 登录）
- Web UI：
https://perfect.${INTERNAL_DOMAIN} - API 接入：
http://platform-prefect-server:4200/api(内网, 无需认证)
核心概念速查¶
部署模型¶
- 部署入口：Dokploy +
compose.yaml - 自动化入口：
invoke <service>.setup - 密钥真理：Vault KV
域名规则¶
- 平台服务统一使用子域名：
<service>.<internal_domain>
前置准备¶
✅ 必需¶
- [ ] Git 仓库
- [ ] Dockerfile 或 Docker Compose
- [ ] Dokploy 访问权限
🔧 可选¶
- [ ] Vault 访问权限
- [ ] Authentik 管理权限（用于新应用接入）
获取访问凭证¶
- INTERNAL_DOMAIN：由运维提供（或在有权限时用
invoke local.bootstrap读取）。 - Dokploy 账号：由运维分配，用于创建应用。
- Vault / Authentik：如未开通或无权限，可先跳过相关步骤。
快速验证环境¶
- 访问 Dokploy UI
-
打开
https://cloud.${INTERNAL_DOMAIN} -
访问 Authentik UI（如已部署）
-
打开
https://sso${ENV_DOMAIN_SUFFIX}.${INTERNAL_DOMAIN} -
访问 Vault UI（如已部署）
- 打开
https://vault.${INTERNAL_DOMAIN}
下一步¶
| 场景 | 推荐阅读 | 预计时间 |
|---|---|---|
| 部署一个简单应用 | 部署第一个应用 | 15 分钟 |
| 应用需要 PostgreSQL/Redis | 使用数据库 | 20 分钟 |
| 应用需要 SSO 登录 | 接入 SSO | 20 分钟 |