DOCS/journey/research/260309_23서버_워크스페이스_SSOT_구조전환_리서치.md

tags

tags
infra workspace ssot structure research

260309 23서버 워크스페이스 SSOT 구조전환 리서치

상위 원칙

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

관련 문서

• Infra Journey
• 23서버 워크스페이스 인프라 구조정리 이슈
• 24서버 실서비스 운영전환 리서치
• 51123 구 IP 하드코딩 실행 경로와 런타임 SSOT 불일치 리서치

목적

• WORKSPACE_ROOT=/home/admin를 넣는 것만으로 구조 SSOT가 닫히는지 확인합니다.
• infra-config -> workspace-config 전환이 실제 실행 경로, 스크립트, 문서에서 어디까지 끝났는지 분리해서 봅니다.
• 워크스페이스 구조 문제를 이름 변경 완료가 아니라 실행 경로 정합성 완료 기준으로 다시 정의합니다.

Facts

1. 공용 운영값 SSOT 경로는 이미 workspace-config로 바뀌었다

• /home/admin/workspace-config/runtime.env가 존재하고 WORKSPACE_ROOT=/home/admin를 포함한다.
• /home/admin/workspace-config/secrets.env가 존재한다.
• /home/admin/infra-config 경로는 현재 존재하지 않는다.

2. 일부 실행 경로는 이미 새 SSOT를 사용한다

• /home/admin/robeing/robeing-monitor/docker-compose.yml은 env_file로 /home/admin/workspace-config/runtime.env, /home/admin/workspace-config/secrets.env를 사용한다.
• /home/admin/infra/scripts/bin/companyx_external_nas_sync_probe.sh도 /home/admin/workspace-config/runtime.env, /home/admin/workspace-config/secrets.env를 읽는다.
• 따라서 workspace-config는 문서 용어가 아니라 실제 실행 경로에서 이미 사용 중이다.

3. 일부 실행 경로와 설명 문서는 아직 옛 SSOT 이름을 참조한다

• /home/admin/robeing-gateway/docker-compose.yml은 아직 env_file로 /home/admin/infra-config/runtime.env, /home/admin/infra-config/secrets.env를 참조한다.
• /home/admin/infra/scripts/README.md도 비민감 운영값과 민감값 경로를 /home/admin/infra-config/*.env로 설명한다.
• 즉 workspace-config 전환은 일부 실행 자산에서 끝났지만, 전체 실행 경로 0건 상태는 아니다.

3-1. robeing-gateway의 역할과 SSOT 방향은 고정됐다

• robeing-gateway는 24 실행면으로 옮기지 않고, auth-server와 함께 23 서버 제어면에 유지한다.
• 따라서 공용 env 단일화의 기준은 gateway를 옮길지가 아니라, 23 제어면 서비스도 /home/admin/workspace-config/*.env만 읽게 맞출지다.
• 이 결정으로 robeing-gateway는 워크스페이스 구조 SSOT의 예외가 아니라, 같은 SSOT를 따르는 23 제어면 서비스로 정리된다.

4. 상위 문서가 가정한 워크스페이스 구조와 현재 파일시스템은 아직 완전히 맞지 않는다

• /home/admin/DOCS 경로는 현재 존재하지 않는다.
• 그런데 일부 기존 문서와 기억된 구조 설명은 /home/admin/DOCS를 전제한다.
• 따라서 워크스페이스 구조 SSOT는 실제 디렉터리 기준으로 다시 정리돼야 한다.

5. 워크스페이스 루트의 중복/테스트 디렉터리 정리는 진행됐다

• 현재 /home/admin 최상위에는 TheGooseCouncil만 남아 있다.
• thegoosecouncil는 공통 하위 저장소 기준 원격에서 더 멀어진 복제본으로 판단돼 제거됐다.
• external_nas_test, tmp_lfs_branch_test는 각각 Thumbs.db 1건만 있던 테스트 잔존물과 빈 디렉터리로 확인돼 제거됐다.

Interpretation

1. WORKSPACE_ROOT 고정은 구조 SSOT의 시작이지 완료가 아니다

• WORKSPACE_ROOT=/home/admin가 들어간 것은 해석 기준을 고정한 1단계다.
• 그러나 실행 경로가 아직 workspace-config와 infra-config를 함께 참조하면, 구조 SSOT는 닫히지 않는다.

2. 이 문제의 본질은 이름이 아니라 실행 경로의 단일화다

• infra-config라는 이름을 문서에서 workspace-config로 바꾸는 것만으로는 충분하지 않다.
• 실제 compose, 스크립트, 운영 README가 같은 경로를 보게 정리돼야 구조 SSOT가 완성된다.

3. 워크스페이스 구조 SSOT는 루트 디렉터리 정합성까지 포함해야 한다

• /home/admin/DOCS처럼 실제 없는 경로를 전제한 문서가 남아 있으면, 운영자가 구조를 잘못 해석할 수 있다.
• 중복 프로젝트 루트와 테스트 잔존 디렉터리는 정리됐지만, 이를 참조하는 하위 문서 경로까지 함께 교정돼야 구조 SSOT가 닫힌다.

Unresolved

• robeing-gateway/docker-compose.yml와 /home/admin/infra/scripts/README.md를 언제 같은 작업 단위로 workspace-config 기준으로 교정할지 실행 시점만 남아 있다.
• 삭제된 thegoosecouncil, external_nas_test, tmp_lfs_branch_test를 참조하는 하위 문서를 어디까지 현재 경로로 교정할지 범위 결정이 아직 없다.

한 줄 결론

• 워크스페이스 구조 SSOT는 WORKSPACE_ROOT 고정, 루트 중복 제거, gateway는 23 제어면 유지 결정까지는 끝났고, 남은 일은 workspace-config 실행 반영과 하위 문서 경로 교정이다.