Fullmoon System

rsync 서버 이전: 1차 복사·쓰기 중단·최종 동기화 검증

AI Editter

rsync가 정상 종료됐는데 새 서버에서 파일을 읽지 못하거나, 전환 뒤 일부 업로드가 사라진다면 복사 완료와 서비스 이전 완료를 같은 기준으로 본 것일 수 있습니다. 파일 내용, 소유권, 쓰기 시점, 접속 경로를 따로 확인해야 합니다.

이 글은 Linux 서버의 일반 파일 디렉터리를 새 서버로 옮기는 절차입니다. 실행 중인 데이터베이스의 데이터 디렉터리는 같은 방식으로 복사하지 않습니다. DB는 엔진이 지원하는 백업·복제·복원 절차로 일관성을 확보해야 합니다.

복사 명령이 성공해도 서비스 자료는 일관되지 않을 수 있다

실행 중인 DB 파일이나 업로드 중인 파일은 복사하는 순간 계속 바뀔 수 있습니다. rsync 종료 코드가 성공이라고 해서 DB 복원이 가능하거나 첨부파일과 DB 행이 같은 시점이라는 뜻은 아닙니다. 파일 복사와 애플리케이션의 쓰기 중단 시점을 나누고, DB는 해당 엔진이 지원하는 백업 방식으로 이관합니다. 목적지 삭제 옵션은 dry-run 결과를 검토한 뒤 필요한 경우에만 적용합니다.

복사 전에 원본과 대상 경계를 적는다

항목기록 예시
원본old-host의 /srv/app/uploads/
대상새 서버의 /srv/migration/uploads/
쓰기 주체웹 앱·워커·예약 작업·외부 업로드
데이터 기준파일 수·바이트·핵심 파일 해시
권한앱 UID/GID·ACL·확장 속성
전환 기준신규 쓰기를 여는 시각과 담당자

대상은 기존 운영 데이터를 포함하지 않은 이전 전용 경로로 준비합니다. 절대 경로를 확인하고 별도 마운트가 대상 아래에 있는지도 조사합니다. 경로 끝의 슬래시 차이가 디렉터리 구조를 바꿀 수 있으므로 먼저 dry-run으로 확인합니다.

1차 복사 전 변경 목록 보기

새 서버에서 실행하는 예시입니다. 계정·호스트·경로를 실제 값으로 바꾸고 SSH 호스트 키를 정상적으로 확인합니다. 아래 명령은 –dry-run이 있어 파일 내용을 쓰지 않습니다.

rsync -aHAXn --numeric-ids --itemize-changes \
  -e ssh \
  migration@OLD_HOST:/srv/app/uploads/ \
  /srv/migration/uploads/

rsync 매뉴얼의 archive 옵션은 모든 메타데이터를 뜻하지 않습니다. H·A·X는 hard link·ACL·확장 속성을 별도로 보존하는 선택이며 양쪽 파일시스템과 권한이 지원해야 합니다. 보존에 필요한 읽기·설정 권한이 없으면 오류가 날 수 있습니다.

numeric-ids는 숫자 UID/GID를 기준으로 삼습니다. 새 서버의 같은 숫자 ID가 다른 계정을 가리키면 오히려 잘못된 권한이 됩니다. 계정 매핑을 먼저 맞추거나 의도한 소유권 변환 절차를 정해야 합니다.

1차 복사와 최종 동기화를 분리

dry-run의 경로와 변경 목록을 확인한 뒤 승인된 이전 대상에 한해 n 옵션을 제거해 복사할 수 있습니다. 운영 중 1차 복사는 중단 시간을 줄이는 준비 작업입니다. 그 사이 변경된 파일은 최종본으로 보장되지 않습니다.

전환 시점에는 웹 서버만 멈추지 말고 워커·cron·외부 파일 전송의 쓰기도 멈춥니다. 원본이 더 이상 바뀌지 않는지 확인하고 최종 동기화합니다. 종료 코드가 0인지 확인하며, vanished file 같은 경고를 “대충 성공”으로 넘기지 않습니다.

이 예시는 삭제 옵션을 포함하지 않습니다. 원본에서 삭제된 파일이 대상에 남을 수 있으므로 삭제분을 별도 비교합니다. 삭제 동기화가 필요하면 이전 전용 대상의 범위를 다시 확인한 뒤 dry-run 변경 목록으로 제거 대상을 검토합니다.

바이트가 같아도 앱 검사는 남는다

검사실패 사례
파일 수·크기누락된 하위 경로
핵심 파일 해시복사 중 변경·손상
앱 계정으로 읽기·쓰기UID/GID·ACL 불일치
심볼릭 링크이전 서버 절대 경로 참조
SELinux 등 보안 설정파일 권한은 맞지만 접근 거부
업로드·다운로드앱 설정의 옛 경로
백업·로그·모니터링신규 위치 미반영

전체 checksum 비교는 비용이 큽니다. 중요한 데이터라면 쓰기 중단 후 범위를 정해 수행하고, 표본 검사만 했다면 전체 동일성이 검증된 것처럼 기록하지 않습니다.

새 서버에서 비공개 시험 접속 경로를 사용해 앱을 확인합니다. 메일·결제·웹훅과 예약 작업이 중복 실행되지 않도록 시험 상태를 제어합니다.

DNS 전환보다 쓰기 소유권이 중요

DNS를 바꿔도 모든 클라이언트가 동시에 새 서버로 이동하지 않습니다. 이전 연결이나 캐시가 남을 수 있으므로 두 서버가 서로 다른 데이터에 동시에 쓰는 상황을 막아야 합니다.

전환 구간에 옛 서버를 읽기 전용 또는 유지보수 상태로 두거나, 설계된 프록시 경로로 새 서버에 연결하는 등 쓰기 목적지를 하나로 정합니다. 단순히 TTL을 줄였다는 사실만으로 이중 쓰기가 해결되지는 않습니다.

되돌릴 수 있는 시점을 명확하게 정하기

새 서버가 아직 신규 쓰기를 받지 않았다면 옛 서버로 돌아갈 판단이 비교적 단순합니다. 신규 주문·업로드를 받은 뒤에는 옛 서버가 과거 데이터이므로 DNS만 되돌리면 그 변경분이 사라집니다.

전환 후 롤백은 새 변경분을 옮기거나 새 서버 문제를 수정하는 선택까지 포함합니다. 옛 서버의 삭제 시점은 정상 업무 시험, 신규 백업의 복원 시험, 관찰 기간이 끝난 뒤 정합니다. 원본을 남겨 두는 것과 실제로 복구할 수 있는 것은 다른 조건입니다.

관련 절차: CentOS 7에서 Rocky Linux 8 이관: 재구축 우선 가이드