跳转到主要内容

Documentation Index

Fetch the complete documentation index at: https://docs.skrmir.com/llms.txt

Use this file to discover all available pages before exploring further.

​
单二进制安装

​
适用对象

本页面适用于希望快速体验 AiOS 安装入口、开发者本地验证流程或 bootstrap 调试的人。

​
目标与范围

本页说明如何通过单二进制入口启动 AiOS，但必须注意：
  • 这是 bootstrap / 开发验证入口
  • 不是最终生产运行方式

​
核心概念

  • 单二进制入口负责启动最小控制面与安装流程
  • 正式运行目标仍是 K3s 中的镜像化服务

​
当前运行模式说明

cmd/aios 当前支持两类运行模式理解：
  • bootstrap：允许在没有 PostgreSQL 的情况下启动，用于安装、bring-up、本地验证和结构调试
  • persistent：要求 PostgreSQL，当前需要持久化任务读取的控制面能力在这个模式下才算完整接线
这意味着“服务能启动”不等于“所有控制面读写能力都已完整可用”。 如果你只是做 bootstrap 演练，bootstrap 是有效路径；如果你要验证依赖任务持久化状态的控制面行为，就应先准备 PostgreSQL 并按 persistent 方式启动。

​
标准流程

  1. 准备依赖环境
  2. 启动 cmd/aios
  3. 通过健康检查确认服务启动
  4. 用它继续进入 bootstrap/安装流程

​
CLI 示例

go run ./cmd/aios
curl http://localhost:8080/healthz
curl http://localhost:8080/readyz

​
Web UI 路径

服务启动后，可通过 Web UI 进入安装/bootstrap 入口页（后续完善）。

​
常见问题 / 风险提示

  • 当前单二进制启动只适合开发和 bootstrap，不应被理解为最终生产部署形态。
  • 后续正式运行应把控制面服务部署到 K3s 中。
  • 某些当前控制台读接口依赖持久化任务状态；在 bootstrap 下，它们不应被理解为“只是没有数据”，而应理解为未进入完整持久化能力集。

​
相关页面