Skip to content

feat(startup): Stage-4+6 配置单源 + docker-compose 适配 + AppHost 冻结标记 #480

Description

@AlianBlank

背景

C143 umbrella 的 Stage-4+6 落地。配置单源 + compose 适配 + AppHost 冻结标记。当前 Configs/app_config.json 单段 AppSetting 无法支撑多 Role 形态;docker-compose.multi.yml 静态形态不支持拓扑环境变量生成;Aspire/AppHost 退役节奏未明示。

设计源:gfx-doc/dev/online-platform/process-topology-isomorphism-design-2026-09-21.md § D4 / D11-D14 / D18。
Change 文件:gfx-doc/dev/startup/changes/C143f-process-topology-stage4-stage6-config-compose-apphost/change.md

范围

  • 示例 Configs/app_config.json 进仓(Game / Social 双段 + 多 Role 端口)。
  • 启动期校验器(ServerType 段存在 / 同进程端口冲突 / CLI-文件合并完整性,fail fast)。
  • docker-compose.development.yml(Mongo 单服务)。
  • docker-compose.multi.yml 适配:拓扑环境变量生成器。
  • docker-compose.multi.legacy.yml:保留现有静态形态(过渡)。
  • README 新增 process-topology-isomorphism 章节:AppHost 冻结 + 退役计划。

任务

  • Configs/app_config.json 示例进仓
  • ConfigStartupValidator 实现 + ConfigConflictException
  • AppBootstrapper 启动期调用校验器,冲突 fail fast
  • docker-compose.development.yml
  • docker-compose.multi.yml 拓扑环境变量生成器
  • docker-compose.multi.legacy.yml 保留现有静态形态
  • README 新增 process-topology-isomorphism 章节
  • 启动期校验器单元测试
  • compose 适配冒烟测试
  • dotnet test 全绿

验收

  • AC-1 All-in-One:配合 app_config.json 多段配置可正常启动。
  • AC-3 现状兼容:现有单 Role 启动命令、docker-compose.multi.yml 静态形态(保留为 legacy)、AspireEndpointResolver 环境变量解析行为不变。
  • D4 配置单源收口:三层载体合并完整;启动期校验 fail fast 列冲突字段与来源段。

依赖

  • 依赖:C143a(AppSetting 字段分区标注)
  • 阻塞:无(与 C143b-e 并行可执行)

标签约定

P2 project:gameframex.server.source blocked-by-dependency

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions