DOCS/journey/plans/260309_23서버_워크스페이스_SSOT_구조전환_계획.md

tags

tags
infra workspace ssot structure plans

260309 23서버 워크스페이스 SSOT 구조전환 계획

상태: 완료 (2026-03-10 기준)

상위 원칙

• Infra Project Identity
• Core Infrastructure Principles
• Operational Guardrails
• 공통 작성 원칙: 0_VALUE Writing Principles

관련 문서

• Infra Journey
• 23서버 워크스페이스 SSOT 구조전환 리서치
• 23서버 워크스페이스 인프라 구조정리 이슈
• 51123 구 IP 하드코딩 실행 경로 제거 계획
• 24서버 실서비스 운영전환 계획
• 23제어면 gateway workspace-config 단일화

문제 정의

• 현재 워크스페이스 해석 기준은 WORKSPACE_ROOT=/home/admin로 고정됐지만, 일부 실행 경로와 문서는 아직 infra-config 또는 삭제된 경로를 참조한다.
• 목표는 23 제어면, 24 실행면, workspace-config 공용 env 구조를 실제 실행 경로까지 일치시키는 것이다.
• 이번 작업의 닫힘 기준은 workspace-config 단일화, 루트 중복 디렉터리 정리 유지, 삭제된 경로 참조 정리까지 포함한다.

구조 결정 고정

• robeing-gateway는 auth-server와 함께 23 서버 제어면에 유지한다.
• 제어면과 실행면을 가리지 않고 공용 운영값은 /home/admin/workspace-config/runtime.env, /home/admin/workspace-config/secrets.env만 SSOT로 사용한다.
• 워크스페이스 정본 루트는 TheGooseCouncil만 남기고, 제거된 thegoosecouncil, external_nas_test, tmp_lfs_branch_test는 재도입하지 않는다.

실행 순서

1. 공용 env 참조를 workspace-config로 단일화한다

• /home/admin/robeing-gateway/docker-compose.yml의 env_file을 /home/admin/workspace-config/runtime.env, /home/admin/workspace-config/secrets.env로 교체한다.
• /home/admin/infra/scripts/README.md의 공용 env 경로 설명도 같은 기준으로 교체한다.
• 실행 경로에서 /home/admin/infra-config/*.env 참조는 0건이 되게 만든다.

2. 23 제어면 서비스 기준을 명시적으로 고정한다

• robeing-gateway, auth-server가 모두 23 제어면 서비스라는 점을 관련 계획 문서와 리서치에서 같은 표현으로 유지한다.
• 24 전환 계획에서도 gateway를 이전 대상이 아니라 연결 대상 제어면으로만 다루게 맞춘다.

3. 삭제된 루트 경로 참조를 현재 정본 경로로 교정한다

• thegoosecouncil를 직접 참조하는 하위 문서를 TheGooseCouncil 기준으로 교정한다.
• external_nas_test, tmp_lfs_branch_test를 전제하는 설명이 있으면 제거하거나 종료된 테스트 흔적으로 정리한다.
• /home/admin/DOCS처럼 현재 없는 루트 경로를 전제한 문서는 실제 경로 기준으로 수정 범위를 확정한다.

4. 실행 경로와 문서 경로를 함께 검증한다

• rg 기준 실행 경로에서 infra-config/runtime.env, infra-config/secrets.env가 0건인지 확인한다.
• /home/admin 최상위에 TheGooseCouncil만 남아 있는지 확인한다.
• 삭제된 경로를 참조하던 문서가 현재 정본 경로를 보도록 교정됐는지 확인한다.

체크리스트

• robeing-gateway/docker-compose.yml가 workspace-config만 참조한다.
• infra/scripts/README.md가 workspace-config 기준 설명만 남긴다.
• 실행 경로에서 /home/admin/infra-config/*.env가 0건이다.
• /home/admin 최상위에 thegoosecouncil, external_nas_test, tmp_lfs_branch_test가 없다.
• 삭제된 경로를 참조하는 문서는 현재 정본 경로 기준으로 정리된다.

검증 기준

• docker compose config 기준 robeing-gateway가 workspace-config 경로를 읽는다.
• rg 기준 비문서 실행 경로에서 infra-config 참조가 남지 않는다.
• find /home/admin -maxdepth 1 -type d 기준 중복/테스트 잔존 디렉터리가 재등장하지 않는다.
• 관련 문서에서 TheGooseCouncil 정본 경로와 workspace-config 용어가 일관되게 사용된다.

완료 조건

• 23 제어면 서비스의 공용 env 참조가 workspace-config로 단일화된다.
• 워크스페이스 루트 중복/테스트 디렉터리 정리가 문서와 실제 파일시스템 모두에서 일치한다.
• 삭제된 경로와 옛 SSOT 이름을 기준으로 하는 실행 경로가 0건이다.