diff --git a/01_Terminology/100_인프라_용어집.md b/01_Terminology/100_인프라_용어집.md index bb5d605..8d3daa2 100644 --- a/01_Terminology/100_인프라_용어집.md +++ b/01_Terminology/100_인프라_용어집.md @@ -34,8 +34,11 @@ SSH로 원격 디렉터리를 로컬 폴더처럼 붙여 쓰는 방식입니다. ### 마운트 (Mount) 원격 저장소나 다른 디스크를 현재 서버의 특정 경로에 연결해, 로컬 폴더처럼 보이게 만드는 작업입니다. -### 내부 NAS -우리 네트워크 안에 있는 NAS입니다. 현재 기준 주소는 `192.168.0.101`입니다. +### NAS 명명 원칙 +`내부 NAS`, `외부 NAS` 같은 표현은 기준 네트워크가 바뀌면 뜻이 흔들릴 수 있습니다. 그래서 운영 문서에서는 가능하면 `시공특허사무소 NAS`, `컴퍼니엑스 NAS`처럼 조직 기준 이름을 먼저 쓰고, 필요할 때만 괄호로 내부/외부 문맥을 덧붙입니다. -### 외부 NAS -우리 내부망 밖에서 접속하는 NAS입니다. 현재 문서에서는 `sigongipc.synology.me`로 접근하는 컴퍼니엑스 측 NAS를 뜻합니다. +### 컴퍼니엑스 NAS +컴퍼니엑스 측이 소유·운영하는 NAS입니다. 51123 운영 문맥에서 현재 SSH 점검 대상 사설 주소는 `192.168.0.101`입니다. + +### 시공특허사무소 NAS +시공특허사무소 측 NAS입니다. 현재 문서에서는 `sigongipc.synology.me`로 접근하는 Synology DSM 경로를 뜻합니다. diff --git a/workflow/51123_nas_remote_operations_workflow.md b/workflow/51123_nas_remote_operations_workflow.md index dd0d486..30a1dda 100644 --- a/workflow/51123_nas_remote_operations_workflow.md +++ b/workflow/51123_nas_remote_operations_workflow.md @@ -4,6 +4,12 @@ tags: [infra, workflow, nas, 51123, remote-operations] # 51123 NAS Remote Operations Workflow +## 용어 고정 + +- 이 문서의 `컴퍼니엑스 NAS`는 사설 주소 `192.168.0.101` 장비를 뜻합니다. +- 이 문서의 `시공특허사무소 NAS`는 `sigongipc.synology.me` DSM 경로를 뜻합니다. +- 과거 문서의 `내부 NAS`, `외부 NAS`는 각각 위 두 대상을 가리킨 표현으로 읽습니다. + ## 상위 원칙 - [../00_Philosophy/00_IDENTITY/Infra_Project_Identity.md](../00_Philosophy/00_IDENTITY/Infra_Project_Identity.md) - [../00_Philosophy/01_PRINCIPLES/Core_Infrastructure_Principles.md](../00_Philosophy/01_PRINCIPLES/Core_Infrastructure_Principles.md) @@ -17,17 +23,17 @@ tags: [infra, workflow, nas, 51123, remote-operations] ## 목적 -- 51123 서버에서 내부 NAS `192.168.0.101`를 원격 점검·수정·검증할 때 같은 순서로 작업합니다. +- 51123 서버에서 컴퍼니엑스 NAS `192.168.0.101`를 원격 점검·수정·검증할 때 같은 순서로 작업합니다. - 사람과 에이전트가 같은 문서를 읽고 같은 기준으로 NAS 원격 작업을 수행합니다. ## 적용 범위 -- NAS 점검 -- NAS SSH 접속 -- NAS 라우팅 확인 -- NAS 동기화 로그 확인 -- NAS cron 수정 -- NAS 실행 스크립트 확인 +- 컴퍼니엑스 NAS 점검 +- 컴퍼니엑스 NAS SSH 접속 +- 컴퍼니엑스 NAS 라우팅 확인 +- 컴퍼니엑스 NAS 동기화 로그 확인 +- 컴퍼니엑스 NAS cron 수정 +- 컴퍼니엑스 NAS 실행 스크립트 확인 ## 기본 원칙 @@ -66,7 +72,7 @@ ssh-keygen -F 192.168.0.101 - `22/tcp` 접속 성공 - known_hosts 엔트리 존재 또는 신규 확인 가능 -### 3. NAS 기본 상태 확인 +### 3. 컴퍼니엑스 NAS 기본 상태 확인 ```bash ssh -o StrictHostKeyChecking=no admin@192.168.0.101 @@ -79,7 +85,7 @@ ip route 판단 기준: - `hostname`은 `companyx` - `default via 192.168.0.1 dev eth1` -- 외부 NAS 호스트 라우트가 있으면 `112.218.113.4 via 192.168.0.1 dev eth1` +- 시공특허사무소 NAS 호스트 라우트가 있으면 `112.218.113.4 via 192.168.0.1 dev eth1` ### 4. 작업 유형별 분기 diff --git a/workflow/51123_nas_sync_verification_workflow.md b/workflow/51123_nas_sync_verification_workflow.md index 82a0fd4..9308f0b 100644 --- a/workflow/51123_nas_sync_verification_workflow.md +++ b/workflow/51123_nas_sync_verification_workflow.md @@ -2,7 +2,7 @@ tags: [infra, workflow, nas, sync, 51123, companyx] --- -# 51123 -> 내부 NAS 동기화 점검 워크플로우 +# 51123 -> 컴퍼니엑스 NAS 동기화 점검 워크플로우 ## 상위 원칙 - [Infra Project Identity](../00_Philosophy/00_IDENTITY/Infra_Project_Identity.md) @@ -17,24 +17,30 @@ tags: [infra, workflow, nas, sync, 51123, companyx] - [260313 내부 NAS -> 외부 NAS 경로 교정 및 Go 프로브 검증](../journey/troubleshooting/260313_internal_nas_external_nas_route_fix_and_go_probe_verification.md) - [260313 내부 NAS 직접 Go 동기화 가능성 리서치](../journey/research/260313_internal_nas_direct_go_sync_feasibility_research.md) +## 용어 고정 + +- 이 문서의 `컴퍼니엑스 NAS`는 사설 주소 `192.168.0.101` 장비를 뜻합니다. +- 이 문서의 `시공특허사무소 NAS`는 `sigongipc.synology.me` DSM 경로를 뜻합니다. +- 과거 문서의 `내부 NAS`, `외부 NAS`는 각각 위 두 대상을 가리킨 표현으로 읽습니다. + ## 목적 -- 51123 서버에서 내부 NAS `192.168.0.101`에 접속해 Company X 외부 NAS 동기화 상태를 같은 절차로 반복 점검한다. +- 51123 서버에서 컴퍼니엑스 NAS `192.168.0.101`에 접속해 시공특허사무소 NAS 동기화 상태를 같은 절차로 반복 점검한다. - 이 문서는 사건 기록이 아니라, 운영자가 다시 실행할 수 있는 고정 절차를 남기는 워크플로우다. ## 적용 범위 - 점검 주체: 51123 서버 -- 점검 대상: 내부 NAS `192.168.0.101` +- 점검 대상: 컴퍼니엑스 NAS `192.168.0.101` - 점검 주제: - NAS SSH 접속 가능 여부 - - NAS 라우팅이 외부 NAS 경로 기준으로 유지되는지 + - NAS 라우팅이 시공특허사무소 NAS 경로 기준으로 유지되는지 - Go 테스트 결과가 남아 있는지 - 현재 운영 중인 fullscan / hierarchical 동기화가 실패 없이 끝났는지 ## SSOT 기준값 -- 내부 NAS 호스트: `192.168.0.101` +- 컴퍼니엑스 NAS 호스트: `192.168.0.101` - NAS 공유 기준: `/mnt/nas` - 51123 런타임 기준 파일: - `/home/admin/workspace-config/runtime.env` @@ -76,7 +82,7 @@ ssh-keygen -F 192.168.0.101 - `22/tcp` 접속 성공 - known_hosts에 기존 호스트키가 있으면 재확인 없이 바로 접속 가능 -### 3. 51123에서 내부 NAS SSH 접속 +### 3. 51123에서 컴퍼니엑스 NAS SSH 접속 ```bash ssh -o StrictHostKeyChecking=no admin@192.168.0.101 @@ -97,9 +103,9 @@ ip route ``` 성공 기준: -- `hostname`은 내부 NAS 장비명으로 응답해야 한다. +- `hostname`은 컴퍼니엑스 NAS 장비명으로 응답해야 한다. - 라우팅에 `default via 192.168.0.1 dev eth1`가 있어야 한다. -- 외부 NAS 호스트 라우트가 있으면 `112.218.113.4 via 192.168.0.1 dev eth1` 형태여야 한다. +- 시공특허사무소 NAS 호스트 라우트가 있으면 `112.218.113.4 via 192.168.0.1 dev eth1` 형태여야 한다. ### 5. NAS 내부에서 동기화 관련 경로 찾기