Galaxy-Ops 文档

想先了解 gops 的定位与独特价值，见 定位与价值。

gops <COMMAND>

一级命令：

• gops mod：模块管理
• gops sys：系统管理
• gops prj：运维项目管理

对象模型

galaxy-ops 围绕三层对象工作：

Module -> System -> Project

• Module：最小可复用运维单元
• System：由多个模块组合形成的系统定义
• Project：面向具体客户环境的交付项目

这三层分别对应当前 CLI 的三组命令：

• gops mod ...
• gops sys ...
• gops prj ...

当前命令面

部署项目命令

gops prj new --name <name>
gops prj import --path <system-path>
gops prj update
gops prj reimport

gops prj reimport 按 ops-prj.yml 记录的 sys_models 重新导入系统，保留 values/ 客户值。

系统命令

# gops sys —— 定义 / 交付 / 工件
gops sys new --name <name> [--kind gxl|docker-compose]
gops sys update
gops sys package [--full]
gops sys localize [--mod <module>] [--only]
gops sys setting --init
gops sys check

# gops run —— 运行时运维（在环境里落地/运行）
gops run download [--mod <module>] [--env <env>]
gops run install [--mod <module>] [--env <env>]
gops run uninstall [--mod <module>] [--env <env>]
gops run start [--mod <module>] [--env <env>]
gops run stop [--mod <module>] [--env <env>]
gops run status [--mod <module>] [--env <env>]
gops run diagnose [--mod <module>] [--env <env>]

sys/sys_model.yml 的 kind 决定部署行为：gxl（默认）委托 gx 执行；docker-compose 直接映射到本机 docker compose。

模块命令

gops mod example
gops mod new --name <name>
gops mod update
gops mod localize [--value <file> | --default]

文档索引

• overview.md：gops 定位与独特价值（含对象模型 / 双后端分派图）
• roadmap.md：按性价比排序的改进方向
• mod/README.md：模块对象说明与 gops mod 使用方式
• mod/CONFIGURATION.md：模块配置与文件结构
• mod/DEVELOPMENT.md：模块开发与本地调试流程
• mod/REFERENCE.md：当前 CLI / 目录 / 概念参考
• mod/TROUBLESHOOTING.md：常见问题排查
• sys/README.md：系统对象说明与 gops sys 使用方式
• sys/configuration/sys-model.md：sys_model.yml 字段与 kind
• sys/structure/directory.md：GXL / docker-compose 两种目录结构
• sys/examples/microservices.md：GXL 多模块系统示例
• sys/examples/docker-compose.md：纯 docker-compose 系统示例（含密钥与 .env）
• sys/troubleshooting/common-issues.md：常见问题排查

对齐说明

本目录文档已经按当前 galaxy-ops 代码实现收敛为以下原则：

• 只使用 gops 作为 CLI 入口
• 只描述当前代码里存在的命令和对象
• 文件树以真实生成结果为准
• 不再保留推断型 Rust API、旧命令名和过时的架构图