Network & Server Factory

개인 공부 기록

Project/홈랩

[홈랩] 웹 서비스 VM을 Kubernetes로 옮기고 검증하기 (3편)

1nfra 2026. 10. 28. 23:38
VM에서 돌던 서비스를 컨테이너로 옮길 때 가장 중요한 것은 옮긴 뒤에도 기존과 똑같이 동작하는지 확인하는 일입니다. 첫 대상인 웹 사이트에서는 전환 전에 문제 네 가지를 찾았습니다. 기존 VM과 응답을 비교해 HTTP 200만으로는 보이지 않던 문제 세 가지가 나왔고, 쓰기 기능 시험에서 하나가 더 나왔습니다. 이 글에서는 첫 대상을 고른 기준, 서비스가 쓰는 데이터(상태)를 나눈 방법, 기존 VM과 응답을 비교해 검증한 과정, 전환과 되돌리기 계획을 정리합니다. 홈랩 재구성 시리즈 3편이며, 이전 글은 홈랩 Kubernetes 클러스터 설계와 노드 배치입니다.

3편을 마친 시점의 구성입니다. 첫 웹 사이트로 들어오는 요청은 NAS 프록시에서 클러스터로 바로 전달되고, 기존 VM은 꺼 두었습니다

1. 첫 대상 고르기

첫 대상은 실패해도 피해가 작고 바로 되돌릴 수 있는 서비스로 골랐습니다.

 

항목 내용
구성 Rocky Linux 9 VM, Apache, 파일 123개(247MB)
동적 기능 Python CGI 3개, 표준 라이브러리만 사용
DB와 TLS DB 없음, TLS는 앞단 리버스 프록시에서 처리

 

DB가 없고 TLS를 앞단에서 처리하므로, 프록시가 요청을 보내는 주소만 바꾸면 전환과 되돌리기가 끝납니다. 하루 요청 약 6만 9천 건 중 실제 방문은 50건 정도이고 나머지는 상태 확인 요청이어서, Kubernetes의 probe 요청은 접속 로그에서 빼기로 했습니다.

2. 서비스가 쓰는 데이터 나누기

컨테이너 안에만 저장한 변경 사항은 컨테이너를 새로 만들면 사라집니다. 그래서 서비스가 쓰는 파일을 먼저 찾아 나눴습니다.

 

기능 쓰는 파일과 처리 방법
파일 업로드 1시간 뒤 지우는 임시 파일 → 임시 볼륨(emptyDir), 보조 컨테이너가 정리
리다이렉트 쓰는 파일 없음
관리 페이지 사이트 설정 파일(site.json)을 고쳐 씀 → 영구 볼륨(PVC)

 

주의할 점은 설정 파일 하나만 영구 볼륨으로 붙이면 저장이 실패한다는 것입니다. 관리 페이지는 같은 폴더에 임시 파일을 쓴 뒤 이름을 바꿔 교체하는데, 이 이름 바꾸기가 볼륨 경계를 넘기 때문입니다. 그래서 설정 폴더 전체를 영구 볼륨으로 붙이고, 초기화 컨테이너(initContainer)가 이미지 안의 원본으로 폴더를 채우되 기존 설정 파일은 덮어쓰지 않게 했습니다. 앱 코드는 고치지 않았습니다.

3. 이미지 만들기

이미지는 공식 Apache 이미지에 Python과 사이트 설정, CGI, 콘텐츠를 더해 만들었습니다. 재료는 소스 저장소가 아니라 서버에서 실제로 동작 중인 파일입니다. 저장소와 서버가 다르면 전환 뒤 생긴 차이가 옮기는 과정 때문인지 원래 있던 것인지 구분하기 어렵기 때문입니다.

4. 기존 VM과 응답 비교하기

같은 경로에 같은 헤더로 기존 VM과 새 Pod에 요청을 보내고, 상태 코드와 응답 헤더, 본문 해시(md5)를 비교했습니다. 대상은 파일 종류별 대표 경로, CGI, 접근 제한 폴더, 없는 페이지, 디렉터리 목록, 압축 응답입니다.

같은 요청을 기존 VM과 새 Pod에 보내고 상태 코드, 헤더, 본문을 비교했습니다

 

문제 원인과 해결
CGI가 실행되지 않고 소스 코드가 내려감 CGI 모듈을 켜는 줄이 탭 들여쓰기라 수정이 적용되지 않음, 이미지 빌드 때 모듈을 검사
일부 파일의 Content-Type이 다름 3D 모델 파일(.glb, .usdz)에 Content-Type이 없었음, 기존 서버의 MIME 정의 파일을 넣음
디렉터리 목록 모양이 다름 기존 서버와 같은 목록 형식을 켬

 

가장 위험한 것은 첫 번째입니다. 상태 코드는 200이고 메인 페이지도 정상으로 보였지만 CGI 소스 코드가 외부에 노출된 상태였습니다. 본문까지 비교해야 잡히는 문제입니다.

 

고친 뒤에는 36개 경로 중 33개에서 응답이 같았습니다. 나머지 3개는 Apache 버전 차이로 오류 페이지와 디렉터리 목록 모양이 달랐고, 이 차이는 그대로 두었습니다.

5. 쓰기 기능 시험하기

쓰기 기능은 운영 중인 VM이 아니라 새 Pod에서만 시험했습니다.

 

시험 결과
3D 모델 파일 업로드 업로드와 다운로드 정상
관리 페이지에서 설정 저장 처음에는 실패, 원인을 고친 뒤 성공
설정을 바꾼 뒤 Pod 삭제 새 Pod에서도 값 유지
원래 설정으로 복원 기존 VM과 설정 파일 해시 일치

 

저장 실패의 원인은 실행 계정이었습니다. Debian 기반인 공식 Apache 이미지는 www-data로 실행되는데, 볼륨 소유자가 달라 CGI가 파일을 쓰지 못했습니다. 초기화 컨테이너에서 폴더 소유자를 www-data로 바꿔 해결했습니다. 이런 문제는 응답 비교만으로는 드러나지 않습니다.

6. 전환과 되돌리기

전환은 앞단 프록시가 요청을 보내는 주소를 기존 VM에서 클러스터의 LoadBalancer IP로 바꾸는 것으로 끝났습니다. TLS 인증서는 계속 프록시가 관리합니다.

 

전환 뒤에는 User-Agent에 표시를 붙인 요청을 공개 주소로 보낸 뒤 Pod 로그에서 확인했고, 8건 모두 도착해 있었습니다. 기존 VM 2대(메인과 백업)는 정상 종료해 두었다가 며칠 지켜본 뒤 지웁니다. 문제가 생기면 VM을 켜고 프록시의 요청 대상 주소만 기존 VM으로 되돌리면 됩니다.

7. 남은 일

 

항목 내용
방문자 IP 접속 로그에 프록시 IP가 남음, X-Forwarded-For 헤더를 로그에 쓰도록 바꿀 예정
이미지 배포 노드에 직접 넣던 이미지 배포 방식을 다음 글에서 내부 이미지 저장소와 GitOps로 바꿈

 

8. 정리

  • 첫 대상은 DB가 없고 프록시의 요청 대상 주소만 바꾸면 되돌릴 수 있는 작은 웹 사이트로 골랐습니다.
  • 이름 바꾸기로 저장하는 설정 파일은 폴더째 영구 볼륨에 붙였습니다.
  • 이미지는 서버에서 실제로 동작 중인 파일로 만들었습니다.
  • 기존 VM과 본문까지 비교해 HTTP 200에 가려진 문제를 전환 전에 찾았습니다.
  • 실행 계정 같은 문제는 쓰기 기능을 직접 시험해야 드러납니다.

참고

728x90
서울
--:--:--
-전체 글
-카테고리
누적 조회수