开始使用
从零到跑通、到发出第一个请求、到进入本地开发——本节给出最短路径。
学习路线
text
初学者 快速开始 → 概念总览 → 架构总览 → 请求的一生
应用开发者 快速开始 → 第一次调用 → REST API → 错误模型 → FAQ
平台开发者 本地开发 → 源码地图 → 参与开发 → 测试体系
运维 部署总览 → Kubernetes → Istio 接入面 → 排障中心本节内容
| 页面 | 内容 | 适合谁 |
|---|---|---|
| 快速开始 | Docker Compose 与源码双路径，15 分钟跑通全平台并自举管理员 | 所有人 |
| 环境与安装 | 工具链版本要求、Docker、PostgreSQL/PostGIS、可选工具 | 准备接入的开发者 |
| 本地开发工作流 | 日常 cargo 命令、scratch PG、live 测试门控、调试 | 平台开发者 |
| 第一次调用 | 登录 → 建模 → 授权 → 写入 → 查询 → 计量的完整旅程 | 应用开发者 |
两条运行路径怎么选
| Docker Compose 单机套件 | 源码运行（svc-all-in-one） | |
|---|---|---|
| 前置依赖 | Docker + docker compose 插件 | Rust 1.96 + 本地 PostgreSQL（带 PostGIS） |
| 首次耗时 | 镜像构建约 10-20 分钟（含全量 cargo release 编译） | 约 5-10 分钟（debug 构建） |
| 适合场景 | 体验、演示、集成验证 | 开发、调试、改代码 |
| 数据持久 | named volume pgdata / rustsvc-data | 自定义 AIO__DATA_DIR |
两者最终形态一致：单进程 svc-all-in-one 内装配全部服务，外部只依赖一个 PostgreSQL。