Debian 13 강좌 / 새 서버로 서비스 이전과 전환·롤백
새 Debian 서버로 서비스를 이전할 때는 실행 환경과 계정을 먼저 준비하고, 쓰기가 멈춘 상태의 최종 백업을 복원한 뒤 기능과 데이터를 비교해야 합니다. 접속 전환만으로 이전이 끝나는 것은 아니며, 새 서버에서 발생한 데이터를 어떻게 보존할지 정해야 안전하게 원래 서버로 돌아갈 수 있습니다.
이전 실습의 범위와 서버 구분
이 실습은 두 Debian 13 VM 사이에서 Python으로 만든 작은 읽기 전용 HTTP 서비스를 이전합니다. 프로그램·데이터·systemd 단위를 모두 제공하며 127.0.0.1:8085에서만 응답합니다. Python http.server 문서가 설명하듯 인터넷 공개용 운영 서버로 사용하는 예제는 아닙니다. 데이터베이스 스키마 전환·실제 DNS 변경·외부 TLS 전환은 이 실습에 포함하지 않습니다.
| 역할 | 실습 연결 | 확인할 내용 |
|---|---|---|
| 원본 old-server | 호스트 127.0.0.1:22212 → 원본 VM SSH | 기준 응답, 최종 백업, 중단·재시작 |
| 대상 new-server | 호스트 127.0.0.1:22213 → 대상 VM SSH | 전용 계정·복원·서비스 응답·재시작 |
| 작업용 컴퓨터 | 두 서버의 호스트 키를 각각 확인한 SSH/SCP | 백업 전달, 해시 비교, 접속 대상 선택 |
두 NAT VM 안에서 같은 10.0.2.15 주소가 보여도 같은 서버가 아닙니다. 이 예에서는 VirtualBox의 네트워크 → NAT → 고급 → 포트 포워딩에서 서로 다른 호스트 루프백 포트를 연결했습니다. 자신의 실제 서버 주소·포트로 바꾸고, 두 서버의 신원과 호스트 키를 별도로 확인하세요. 실습 중 대상 VM의 부팅이 정체되어 ACPI 정상 종료 후 다시 시작했으며, 대상이 정상 접속되는 것을 확인한 뒤에만 복원을 진행했습니다.
작업용 Linux 컴퓨터의 ~/.ssh/config에 다음처럼 별칭을 정할 수 있습니다. 개인 키 경로는 자신의 것으로 바꾸고, 비밀번호나 개인 키 내용을 글·로그에 복사하지 않습니다.
Host old-server
HostName 127.0.0.1
Port 22212
User lfstudent
IdentityFile ~/.ssh/id_ed25519
Host new-server
HostName 127.0.0.1
Port 22213
User lfstudent
IdentityFile ~/.ssh/id_ed25519
각 서버에 Python 3, curl, tar가 필요합니다. 설치되지 않았다면 sudo apt install python3 curl tar로 준비하고, 작업용 컴퓨터에는 SSH·SCP 클라이언트를 설치합니다. 아래 원본 예제는 강좌의 기존 lfstudent 계정 UID·GID 1000을 전제로 합니다. 다른 계정을 사용하면 User·Group과 소유권 지정도 함께 바꾸세요. 기존 같은 이름의 디렉터리·서비스를 덮어쓰지 않는 새 실습 환경을 사용합니다.
원본에 전체 예제를 만들고 정지 백업 생성
원본 서버에서 실행합니다. 이 블록은 프로그램·데이터·단위를 생성하고 응답을 비교한 뒤 서비스를 정지합니다. 마지막 tar가 생성될 때는 이 예제의 데이터 읽기 프로세스도 멈춘 상태입니다. 다른 서비스나 기존 업그레이드 실습 파일은 대상으로 삼지 않습니다.
sudo bash <<'ROOT'
set -euo pipefail
for p in /opt/lf-migrate35 /var/lib/lf-migrate35 /var/backups/lf-migrate35 /etc/systemd/system/lf-migrate35.service; do test ! -e "$p"; done
test "$(id -u lfstudent)" = 1000
test -z "$(ss -H -ltn 'sport = :8085')"
install -d -m 755 /opt/lf-migrate35
install -d -m 750 -o lfstudent -g lfstudent /var/lib/lf-migrate35
install -d -m 700 /var/backups/lf-migrate35
cat > /opt/lf-migrate35/app.py <<'PY'
from http.server import BaseHTTPRequestHandler, HTTPServer
from pathlib import Path
class Handler(BaseHTTPRequestHandler):
def do_GET(self):
if self.path != '/':
self.send_error(404)
return
try:
body = Path('/var/lib/lf-migrate35/message.txt').read_bytes()
status = 200
except OSError:
body = b'data unavailable\n'
status = 503
self.send_response(status)
self.send_header('Content-Type', 'text/plain; charset=utf-8')
self.send_header('Content-Length', str(len(body)))
self.end_headers()
self.wfile.write(body)
HTTPServer(('127.0.0.1', 8085), Handler).serve_forever()
PY
cat > /etc/systemd/system/lf-migrate35.service <<'UNIT'
[Unit]
Description=LF migration lab 35
After=network.target
[Service]
Type=exec
User=lfstudent
Group=lfstudent
ExecStart=/usr/bin/python3 /opt/lf-migrate35/app.py
NoNewPrivileges=true
ProtectSystem=strict
ProtectHome=true
PrivateTmp=true
[Install]
WantedBy=multi-user.target
UNIT
printf 'migration payload 35\n' > /var/lib/lf-migrate35/message.txt
chown lfstudent:lfstudent /var/lib/lf-migrate35/message.txt
chmod 640 /var/lib/lf-migrate35/message.txt
systemctl daemon-reload
systemctl enable --now lf-migrate35.service
sleep .4
curl -fsS http://127.0.0.1:8085/ > /var/backups/lf-migrate35/before.txt
cmp /var/lib/lf-migrate35/message.txt /var/backups/lf-migrate35/before.txt
systemctl stop lf-migrate35.service
tar --numeric-owner -cpf /var/backups/lf-migrate35/service.tar -C / opt/lf-migrate35 var/lib/lf-migrate35 etc/systemd/system/lf-migrate35.service
cd /var/backups/lf-migrate35
sha256sum service.tar > service.sha256
sha256sum -c service.sha256
echo SOURCE_STOPPED_FINAL_SAMPLE_BACKUP_READY
ROOT
예상 결과는 service.tar: OK와 백업 준비 메시지입니다. 정상 응답은 migration payload 35 한 줄입니다. 데이터가 없거나 읽히지 않으면 이 서비스는 503을 반환하며, 파일 목록을 공개하거나 다른 경로를 읽지 않습니다.
실제 데이터베이스·파일 업로드 서비스에서는 프로세스 하나를 멈추는 것만으로 충분한지 판단해야 합니다. 배치 작업·큐 소비자·다른 서버의 쓰기까지 중단하거나 제품의 일관된 덤프·온라인 백업 방법을 사용합니다. 초기 대량 복사 후 최종 변경분을 다시 동기화한다면 두 시점과 쓰기 정지 구간을 기록하세요.
작업용 컴퓨터를 거쳐 백업 전달
원본의 root 전용 백업을 그대로 공개하지 않고, 방금 만든 비밀 없는 예제 아카이브 두 파일만 실습 계정의 전용 디렉터리로 복사합니다. 실제 서비스 백업은 비밀 정보 포함 여부와 별도 암호화·보관 정책을 적용하세요.
test ! -e "$HOME/lf-migrate35-export"
install -d -m 700 "$HOME/lf-migrate35-export"
sudo install -m 600 -o "$(id -un)" -g "$(id -gn)" /var/backups/lf-migrate35/service.tar /var/backups/lf-migrate35/service.sha256 "$HOME/lf-migrate35-export/"
작업용 Linux 컴퓨터에서 실행합니다. SSH 별칭의 접속 대상을 다시 확인하고 전용 로컬 디렉터리에서 파일을 받습니다.
ssh old-server hostname
ssh new-server hostname
mkdir -m 700 migration35
scp old-server:lf-migrate35-export/service.tar old-server:lf-migrate35-export/service.sha256 migration35/
cd migration35
sha256sum -c service.sha256
tar -tvf service.tar
ssh new-server 'test ! -e "$HOME/lf-migrate35-import" && install -d -m 700 "$HOME/lf-migrate35-import"'
scp service.tar service.sha256 new-server:lf-migrate35-import/
해시가 일치해야 하며 목록에는 opt/lf-migrate35, var/lib/lf-migrate35와 해당 서비스 단위만 있어야 합니다. 자신이 만든 신뢰 가능한 아카이브에만 복원 권한을 부여하고, 절대 경로·상위 경로 이동·예상하지 않은 링크가 있으면 중단합니다. 체크섬은 전달 중 손상 확인이며 출처 신뢰를 대신하지 않습니다. SCP의 옵션과 전송 방식은 OpenSSH scp 매뉴얼에서 확인할 수 있습니다.
대상에 전용 계정으로 복원하기
대상 서버에서 실행합니다. 먼저 /opt/lf-migrate35, /var/lib/lf-migrate35, /var/backups/lf-migrate35, /etc/systemd/system/lf-migrate35.service가 없고 getent passwd lf-migrate35에 기존 계정이 없는지 확인합니다. sudo ss -ltn에서 8085 포트가 사용 중이면 원인을 확인하고 진행하지 마세요.
스테이징 디렉터리에 풀고 필요한 파일을 설치하므로 원본의 서비스 단위를 대상 /etc에 통째로 덮어쓰지 않습니다. 원본 숫자 UID를 복사하는 대신 대상의 전용 계정 이름으로 데이터 소유권을 다시 설정합니다.
sudo bash <<'ROOT'
set -euo pipefail
install -d -m 700 /var/backups/lf-migrate35
mv -- /home/lfstudent/lf-migrate35-import/service.tar /home/lfstudent/lf-migrate35-import/service.sha256 /var/backups/lf-migrate35/
rmdir /home/lfstudent/lf-migrate35-import
chown root:root /var/backups/lf-migrate35/service.tar /var/backups/lf-migrate35/service.sha256
chmod 600 /var/backups/lf-migrate35/service.tar /var/backups/lf-migrate35/service.sha256
cd /var/backups/lf-migrate35
sha256sum -c service.sha256
mkdir -m 700 staging
tar -xpf service.tar -C staging
useradd --system --user-group --home-dir /var/lib/lf-migrate35 --no-create-home --shell /usr/sbin/nologin lf-migrate35
install -d -m 755 /opt/lf-migrate35
install -m 644 staging/opt/lf-migrate35/app.py /opt/lf-migrate35/app.py
install -d -m 750 -o lf-migrate35 -g lf-migrate35 /var/lib/lf-migrate35
install -m 640 -o lf-migrate35 -g lf-migrate35 staging/var/lib/lf-migrate35/message.txt /var/lib/lf-migrate35/message.txt
cat > /etc/systemd/system/lf-migrate35.service <<'UNIT'
[Unit]
Description=LF migration lab 35
After=network.target
[Service]
Type=exec
User=lf-migrate35
Group=lf-migrate35
ExecStart=/usr/bin/python3 /opt/lf-migrate35/app.py
NoNewPrivileges=true
ProtectSystem=strict
ProtectHome=true
PrivateTmp=true
[Install]
WantedBy=multi-user.target
UNIT
systemctl daemon-reload
systemctl enable --now lf-migrate35.service
sleep .4
curl -fsS http://127.0.0.1:8085/ > after.txt
cmp after.txt staging/var/lib/lf-migrate35/message.txt
cmp /opt/lf-migrate35/app.py staging/opt/lf-migrate35/app.py
test "$(stat -c %U /var/lib/lf-migrate35/message.txt)" = lf-migrate35
test "$(id -u lf-migrate35)" != 1000
id lf-migrate35
stat -c '%U:%G:%a' /var/lib/lf-migrate35/message.txt
systemctl show lf-migrate35.service -p User -p Group -p NoNewPrivileges -p ProtectSystem -p MainPID
systemctl restart lf-migrate35.service
sleep .3
curl -fsS http://127.0.0.1:8085/ | cmp - after.txt
echo TARGET_RESTORED_BY_ACCOUNT_NAME_BYTES_AND_RESTART_PASSED
ROOT
검증 VM의 원본 데이터 소유자는 UID 1000이었고 대상 전용 계정은 UID·GID 988이었습니다. 데이터 권한은 lf-migrate35:lf-migrate35:640으로 설치됐으며, 코드 바이트·HTTP 응답과 서비스 재시작 후 응답이 동일했습니다. NoNewPrivileges와 읽기 전용 시스템 보호는 systemd 실행 환경 설정에 따른 이 예제의 제한입니다. 쓰기 서비스에 같은 단위를 그대로 적용하면 필요한 데이터 쓰기도 막을 수 있으므로 경로별 권한을 별도로 설계해야 합니다.
실제 애플리케이션에서는 런타임 버전·확장 모듈·DB 클라이언트·환경 변수·인증서·업로드 경로도 비교합니다. OS 버전이 같다는 이유만으로 파일 형식과 동작까지 같다고 가정하지 말고, 대상에서 제품이 지원하는 검증 도구와 기능 요청을 실행하세요.
접속 전환과 원래 서버로 복귀 시험
지금은 원본 서비스가 멈추고 대상 서비스가 응답하는 상태입니다. 작업용 컴퓨터에서 접속 대상을 선택하는 변수를 사용해 읽기를 확인합니다. 이는 SSH 목적지 선택이며 DNS·로드밸런서·공개 웹 주소를 바꾸는 작업은 아닙니다.
active=new-server
ssh "$active" 'curl --noproxy "*" -fsS http://127.0.0.1:8085/'
- 대상에서
sudo systemctl stop lf-migrate35.service를 실행합니다. - 원본에서
sudo systemctl start lf-migrate35.service를 실행합니다. - 작업용 컴퓨터에서 아래처럼 원본으로 읽기를 돌리고 같은 응답인지 확인합니다.
active=old-server
ssh "$active" 'curl --noproxy "*" -fsS http://127.0.0.1:8085/'
다시 대상으로 전환하려면 원본을 먼저 멈춘 뒤 대상 서비스를 시작하고 active=new-server로 확인합니다. 실제 두 VM에서 대상 복원·재시작, 원본 복귀, 대상 재전환의 응답을 모두 기준 파일과 비교했습니다. 이 작은 서비스는 읽기 전용이므로 전환 뒤 새 쓰기 충돌이 발생하는 시나리오를 시험한 결과는 아닙니다.
실제 운영 전환에서 추가로 결정할 사항
| 항목 | 판단 기준 |
|---|---|
| DNS와 로드밸런서 | 현재 캐시·기존 연결·헬스 체크와 전파 지연을 고려합니다. TTL만 낮췄다고 즉시 모든 요청이 이동하지 않습니다. |
| 쓰기 재개와 복귀 | 최종 동기화 전 원본 쓰기를 막고, 대상에서 발생한 데이터를 원본에 재적용할 수 있는지 정합니다. 역호환되지 않는 스키마라면 단순 원복을 피합니다. |
| 예약 작업·메일·큐 | 두 서버가 동시에 실행하면 중복 처리되는 작업은 한쪽만 활성화합니다. 웹 요청 전환과 별도로 확인합니다. |
| 성공 판정 | 프로세스·포트·응답·데이터·대표 기능과 오류율을 각각 비교합니다. 읽기만 성공했다고 쓰기 정상으로 간주하지 않습니다. |
복귀 시점과 보관 기간을 정하고 원본·백업을 성급히 삭제하지 않습니다. 아카이브의 숫자 소유권과 추출 동작은 GNU tar의 Debian 매뉴얼을 확인하고, DB나 제품별 메이저 버전 데이터는 해당 제품의 공식 이전 절차를 우선합니다.
실습 자원 정리
검증을 마친 뒤 양쪽 서버에서 자신이 만든 예제만 정리할 수 있습니다. 서비스 중지·비활성화 후 정확한 세 파일을 지우고 빈 디렉터리만 제거합니다. 백업은 보관하며 원본의 기존 lfstudent 계정은 삭제하지 않습니다.
sudo systemctl disable --now lf-migrate35.service
sudo rm -- /etc/systemd/system/lf-migrate35.service /opt/lf-migrate35/app.py /var/lib/lf-migrate35/message.txt
sudo rmdir /opt/lf-migrate35 /var/lib/lf-migrate35
sudo systemctl daemon-reload
대상에서 새로 만든 전용 계정은 프로세스가 종료되고 이 실습 데이터가 정리된 것을 확인한 뒤 sudo userdel lf-migrate35로 제거합니다. 원본의 전용 전달 사본과 작업용 컴퓨터의 사본도 보관 정책에 따라 정확한 두 파일을 선택해 정리하세요. 운영 서비스 이전에서는 복구 기간이 끝나기 전까지 검증한 최종 백업과 전환 기록을 유지합니다.




