ivada-infra/DOCS
2
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
DOCS/journey/research/260307_external_nas_companyx_sync_research.md

4.5 KiB
Raw Blame History

260307 외부 NAS -> 내부 NAS 컴퍼니엑스 동기화 리서치

tags: [nas, companyx, sync, research]

상위 원칙:

목적

  • 컴퍼니엑스 외부 NAS 파일을 내부 NAS로 옮기는 운영 경로를 검증한다.
  • 자동 동기화 스크립트를 만들기 전에 필요한 사실과 실험 항목을 정리한다.

현재 기준

  • 외부 NAS 접근 경로: 시놀로지 기본 웹 관리자 API
  • 내부 저장 경로: 51123의 /mnt/nas
  • 내부 NAS 기준 주소: 192.168.0.101
  • 스크립트 저장소: infra/scripts

이미 검증된 사실

  1. 외부 NAS DSM 로그인 가능
  2. 외부 NAS 파일 1건 다운로드 가능
  3. 내부 NAS 저장 가능
  4. 저장 후 SHA256 일치 확인
  5. 외부 NAS 폴더 구조 일부를 내부 NAS에 미러링 가능

관련 근거:

2026-03-07 실측 결과

실행 스크립트:

  • infra/scripts/bin/companyx_external_nas_sync_probe.sh

실행 시각:

  • 2026-03-07 16:22 KST

테스트 저장 경로:

  • /mnt/nas/backup/current/external-nas-timing-test/20260307_162237

측정값:

  1. DSM 로그인
  • 약 0.683초
  1. 상위 폴더 목록 조회
  • 대상: /6.Company X
  • 결과: 16개 엔트리
  • 약 0.067초
  1. 사진 하위 폴더 목록 조회
  • 대상: /6.Company X/7. 사진/220308_X코스_5기 발표 사진
  • 결과: 20개 엔트리
  • 약 0.061초
  1. 샘플 파일 다운로드 및 내부 NAS 저장
  • Thumbs.db 12,288B: 약 0.094초
  • 2410_투자기업 DB_컴퍼니엑스_LP추가, 컨택포인트 추가.xlsx 151,832B: 약 0.103초
  • KakaoTalk_20220322_121550595_03.jpg 457,889B: 약 0.121초
  • 221028_회사소개서_디지털용.pdf 20,147,273B: 약 0.571초

관찰:

  • 이 시점 실측에서는 대략 20MB 파일 1개도 1초 이내에 내부 NAS까지 저장됐다.
  • 병목은 현재 테스트 범위에서는 내부 NAS 쓰기보다 외부 DSM 응답과 전송 구간으로 보인다.
  • HTTPS 인증서는 만료 상태라 현재 스크립트는 -k 옵션으로 우회하고 있다. 운영 자동화 전 인증서 정리 여부를 판단해야 한다.

보수적 해석:

  • “문서 파일 위주” 폴더는 5분~10분 간격 증분 동기화도 현실적으로 가능해 보인다.
  • 다만 사진 대량 폴더나 전체 재귀 동기화는 파일 수가 많아질수록 API 호출 수가 늘어나므로, 지금 수치만으로 전체 완료 시간을 단정할 수는 없다.
  • 따라서 다음 검증은 “샘플 폴더 1개 전체 동기화”와 “같은 작업 재실행 시 중복 건너뛰기”다.

이번 리서치에서 확인할 항목

  1. 외부 NAS에서 디렉터리 목록을 안정적으로 재귀 조회할 수 있는가
  2. 다운로드 단위를 파일별로 관리할 때 속도와 실패 복구가 충분한가
  3. 수정시각과 크기만으로 증분 동기화가 가능한가
  4. 해시 검증을 전건에 적용할지 샘플 검증으로 줄일지
  5. 실패 파일 재시도와 중단 지점을 어떻게 기록할지

실험 순서

1. 목록 조회 실험

  • 컴퍼니엑스 상위 폴더 목록 조회
  • 하위 폴더 재귀 조회 가능 여부 확인
  • 파일 수, 폴더 수, 메타데이터 제공 범위 확인

2. 샘플 동기화 실험

  • 작은 폴더 1개를 골라 내부 NAS로 동기화
  • 다운로드 시간, 저장 시간, 재실행 시 중복 처리 확인

3. 검증 실험

  • 파일 크기, 수정시각, SHA256 비교 기준 정리
  • 실패 파일 재시도 방식 기록

예상 산출물

  1. infra/scripts/bin/companyx_external_nas_sync_probe.sh 개선본
  2. 동기화 정책 초안 문서
  3. 운영 주기 제안
  4. 실패 처리 기준

보수적 결론

  • 현재 구조로 단방향 동기화는 가능성이 높다.
  • 다만 아직 자동 운영 주기와 증분 처리 기준은 검증되지 않았다.
  • 따라서 다음 단계는 “전체 동기화 구현”이 아니라 “목록 조회 + 샘플 폴더 동기화 + 재실행 검증”이다.

관련 문서