Sys-Operator 目录结构

概述

本文档详细说明了 Sys-Operator 的目录结构，帮助你理解系统组织和文件规范。

完整的目录结构

system_name/
├── _gal/                              # 项目配置目录
│   ├── adm.gxl                       # 系统管理配置
│   ├── work.gxl                      # 工作流环境配置
│   └── project.toml                  # 项目元数据配置
├── sys/                              # 系统定义目录
│   ├── sys_model.yml                 # 系统模型定义
│   ├── mod_list.yml                  # 模块列表定义
│   ├── vars.yml                      # 系统变量定义
│   ├── mods/                         # 模块本地化副本
│   │   ├── module1_name/
│   │   │   └── arm-mac14-host/       # 特定平台配置
│   │   │       ├── spec/             # 规范文件
│   │   │       ├── local/            # 本地化配置
│   │   │       ├── values/           # 值文件
│   │   │       ├── vars.yml          # 模块变量
│   │   │       ├── setting.yml       # 本地化设置
│   │   │       └── workflows/        # 模块工作流
│   │   └── module2_name/
│   │       └── x86-ubt22-k8s/        # 不同平台配置
│   │           └── [相同结构]
│   └── workflows/                    # 系统工作流定义
│       └── operators.gxl             # 系统操作符工作流
├── sys-prj.yml                       # 系统项目配置
├── version.txt                       # 系统版本信息
├── .gitignore                        # Git 忽略文件
└── test_res/                         # 测试资源目录

目录说明

`_gal/` - 项目配置目录

存储 Galaxy 项目的配置文件，包括版本管理、工作流定义和项目元数据。

关键文件：

adm.gxl: 系统管理配置，定义版本管理和发布流程
work.gxl: 工作流环境配置，定义执行环境和参数
project.toml: 项目元数据配置，包含项目基本信息

作用：

集中管理项目级别的配置
提供版本控制和发布管理
定义多环境执行配置

`sys/` - 系统定义目录

包含系统的核心定义文件和模块的本地化副本，是 Sys-Operator 的核心目录。

关键文件：

sys_model.yml: 系统模型定义，包含系统基本信息和目标环境
mod_list.yml: 模块列表定义，包含系统包含的所有模块配置
vars.yml: 系统变量定义，定义环境变量和配置参数

作用：

定义系统的基础架构
管理模块组合和依赖
配置系统级变量和参数

`mods/` - 模块本地化副本

存储系统中包含的各个模块的本地化配置和文件，这些是从模块源地址复制或下载而来的。

子目录结构：

mods/
├── module_name/
│   └── platform_model/               # 平台特定配置
│       ├── spec/                    # 规范文件
│       ├── local/                   # 本地化配置
│       ├── values/                  # 值文件
│       ├── vars.yml                 # 模块变量
│       ├── setting.yml              # 本地化设置
│       └── workflows/               # 模块工作流

平台命名规范：