Galaxy 应用配置基线

基本结论

Galaxy 应用的入口工程通常会同时维护三组资源:

  • @conf:开发调试阶段使用的配置资源
  • @install:发布安装包使用的配置和静态资源
  • @profiles:功能菜单和应用设置相关资源

其中,@conf@install 不属于同一个映射层级,不能简单地理解为“开发版”和“正式版的同目录镜像”。

目录映射规则

@conf

@conf 对应 Galaxy 应用主目录下 conf/ 的根目录。

也就是说,在开发调试阶段,@conf/server.conf@conf/mongo.db.conf@conf/organizations.conf 等文件,会以 conf/*.conf 的形式进入运行时主目录。

@install

@install 对应的是 Galaxy 应用主目录根。

它内部再按发布目录结构继续分层:

  • @install/conf 对应应用主目录下的 conf/
  • @install/web 对应应用主目录下的 web/

因此,@install 不是简单替代 @conf,而是用于描述“最终安装包长什么样”。

推荐理解方式

可以把 Galaxy 应用配置理解为两套不同目标的配置资产:

  • 开发态配置:让应用在 IDE、本地调试、联调环境里尽快跑起来
  • 安装态配置:让最终发布到运行环境的应用目录具有可部署的目录结构

这两套资产的关注点并不相同:

  • 开发态更偏向本机端口、调试域名、联调数据库、调试开关
  • 安装态更偏向部署目录、多域名资源、对外访问域名、稳定的安装布局

配置覆盖原则

@conf@install 目录中的配置覆盖原则是一致的:

  1. 不做文件夹整体覆盖
  2. 按同名文件覆盖
  3. 平台保留一组不可覆盖的受保护配置文件,具体清单应在后续治理中继续补齐

这意味着:

  • 不要假设拷贝一个目录就可以整体替换运行时内容
  • 真正稳定的覆盖单位是文件
  • 配置治理时应优先管理“关键文件列表”,而不是只管理目录名

配置能力域

Galaxy 应用配置至少可以划分为以下能力域:

  • 目录与发布布局
  • 服务器网络接入
  • 账号与登录注册
  • 安全与认证
  • 组织机构
  • 角色与权限
  • Web 与静态资源
  • 多域名应用
  • MongoDB 与 RocksDB 存储
  • 文件服务
  • 区块链接入

使用要点

  • @conf 当作“开发联调入口”,而不是长期运维配置的唯一来源
  • @install 当作“安装包目录声明”,确保 conf/web/ 结构完整
最近更新:
发布者: huanghaiquan
扫码咨询