두 번째 이관 대상은 VM 한 대에서 포트로 나눠 운영하던 PHP 사이트 6개와 MySQL이었습니다. 사이트마다 이미지를 따로 만들고 DB는 StatefulSet으로 옮겼으며, 입구는 Gateway 하나로 합쳐 호스트 이름으로 사이트를 나눴습니다. VM처럼 포트 리스너로 나누는 방식도 시도했지만, Cilium Gateway에서는 사이트가 서로 섞여서 호스트 이름 방식으로 정했습니다. 이 글에서는 이미지 설계, MySQL 이관, Gateway 통합과 호스트 이름 라우팅을 정리합니다. 홈랩 재구성 시리즈 5편이며, 이전 글은 Jenkins와 Argo CD로 홈랩 CI/CD 구성하기입니다.

5편을 마친 시점의 구성입니다. 입구를 Gateway 하나로 합치고 호스트 이름으로 사이트를 나눴습니다
1. 이관 대상
| 항목 | 내용 |
| 구성 | Ubuntu VM 1대(백업 VM 1대 별도), Apache와 PHP 7.4, MySQL 8.0 |
| 사이트 | 포트 80의 WordPress 1개, 포트 1111~1115의 정적 사이트와 PHP 사이트 5개 |
| DB | WordPress용 DB 1개, 732KB |
| 트래픽 | 상태 확인을 뺀 요청이 거의 없음 |
앞단 로드밸런서가 도메인마다 이 VM의 다른 포트로 요청을 보내는 구조였습니다. PHP 7.4는 지원이 끝났지만 버전은 VM과 같게 맞췄습니다. 이관과 업그레이드를 한 번에 하면 문제가 생겼을 때 원인을 구분하기 어렵기 때문입니다.
2. 이미지 설계
| 이미지 | 내용 |
| 공통 베이스 | 공식 php:7.4-apache 이미지에 VM과 같은 PHP 확장, 같은 php.ini, rewrite 모듈 |
| 사이트 이미지 6개 | 하나의 Dockerfile에서 빌드 인자로 문서 경로만 바꿔 사이트 내용을 넣음 |
사이트마다 이미지를 따로 만들어, 한 사이트를 다시 배포해도 다른 사이트에 영향이 없게 했습니다. 오래 걸리는 PHP 확장 설치는 공통 베이스로 빼서 한 번만 빌드합니다.
WordPress의 DB 접속 정보는 이미지에 넣지 않았습니다. wp-config.php가 환경 변수에서 접속 정보를 읽도록 바꾸고, 값은 Kubernetes Secret에서 넘깁니다. 이미지에 비밀번호가 들어가면 이미지 저장소에 접근할 수 있는 누구나 볼 수 있기 때문입니다.
| 문제 | 해결 |
| php:7.4 이미지의 기반인 Debian 11이 아카이브로 옮겨져 패키지 설치 실패 | 패키지 저장소를 archive.debian.org로 바꿈 |
| 한 사이트의 한글 파일 이름이 EUC-KR로 인코딩되어 있어 macOS에서 압축을 풀 수 없음 | PC에서 풀지 않고 압축 파일째 이미지에 넣어 Linux 안에서 풂, 파일 이름의 원래 바이트가 그대로 보존됨 |
3. MySQL 옮기기
MySQL은 VM과 같은 8.0 버전을 StatefulSet으로 띄우고, 데이터는 영구 볼륨에 두었습니다. 볼륨에는 4편에서 정리한 Argo CD 삭제 방지 어노테이션을 붙였고, 클러스터에 Secret을 직접 만들어 DB 비밀번호를 저장했습니다.
덤프를 가져온 뒤 테이블 수와 게시물 수가 VM과 같은 것을 확인했습니다. 주의할 점은 인증 방식입니다. MySQL 8은 새 계정의 기본 인증 방식이 caching_sha2_password인데, VM의 계정은 mysql_native_password였습니다. 이 환경에서 WordPress가 TLS 없이 접속할 수 있도록 인증 방식을 VM과 같은 mysql_native_password로 맞췄습니다.
각 사이트의 응답을 3편과 같은 방법으로 VM의 응답과 비교했습니다. 230개 경로 중 219개가 같았고, 남은 11개는 오류 페이지의 서버 서명, phpinfo 페이지, VM에서도 오류가 나던 페이지였습니다.
4. Gateway 하나로 합치기
서비스마다 LoadBalancer IP를 따로 쓰면 서비스가 늘수록 IP와 앞단 프록시 설정도 늘어납니다. 그래서 웹 서비스의 입구를 Gateway 하나로 합치고 각 서비스는 라우트(HTTPRoute)만 붙이기로 했습니다.
처음에는 VM처럼 Gateway에 사이트별 포트 리스너를 추가해 보았습니다. 그러자 포트 80으로 들어간 요청에 다른 사이트의 내용이 나와서 바로 되돌렸습니다. 상태 코드는 200 그대로였습니다.

Cilium Gateway는 호스트 이름 없는 HTTP 리스너를 포트와 상관없이 하나로 합쳐, 포트로 나눈 사이트들이 서로 섞였습니다
Cilium은 호스트 이름이 없는 HTTP 리스너들을 포트와 상관없이 하나의 라우팅 표로 합칩니다. 그래서 포트가 달라도 경로만 보고 라우트를 골라, 요청이 다른 사이트로 연결되었습니다. 이 동작을 확인하고 사이트는 호스트 이름으로 나누기로 정했습니다.
Gateway에는 포트 80 HTTP 리스너 하나만 두고, 사이트마다 하위 도메인을 정해 라우트에 호스트 이름을 적었습니다. 첫 번째 웹 사이트는 호스트 이름 없는 기본 라우트로 두었습니다. Gateway는 호스트 이름이 정확히 맞는 라우트를 먼저 적용하므로, 하위 도메인 요청은 각 사이트로 가고 나머지는 첫 번째 사이트로 갑니다.
| 라우트 | 호스트 이름 |
| 첫 번째 웹 사이트 | 없음 (기본 라우트) |
| PHP 사이트 5개 | 사이트별 하위 도메인 |
적용하는 동안 운영 중인 첫 번째 사이트의 본문 해시가 바뀌지 않는 것을 확인했습니다. 그 뒤 앞단 프록시가 하위 도메인을 Gateway로 보내도록 바꾸고, 각 사이트의 본문 해시가 VM 원본과 같은 것을 확인한 뒤 기존 VM을 삭제했습니다.
교훈은 다음과 같습니다.
- 전환을 확인할 때는 상태 코드가 아니라 내용(제목, 본문 해시)을 본다
- Cilium Gateway에서는 포트로 서비스를 나누지 않고 호스트 이름으로 나눈다
- 운영 중인 입구와 새 라우트를 한 번에 바꾸지 않는다
5. 지금 상태
전환한 뒤 노드 장애에 대비해 사이트별 배치를 다시 정했습니다.
| 사이트 | 지금 상태 |
| 정적 사이트 3개 | 복제본 2개, 두 호스트에 하나씩 분산 |
| PHP 사이트 2개 | PHP 세션을 Pod 안의 /tmp에 저장하므로 복제본 1개, 노드가 멈추면 30초 뒤 다른 노드에서 다시 실행 |
| WordPress와 MySQL | 호스트 이름 라우팅으로 바꾼 뒤 연결된 주소가 없어 사용하지 않음, 덤프를 보관하고 정리 |
WordPress는 Git에서 매니페스트를 지워 Argo CD가 정리하게 했고, 데이터가 든 볼륨은 4편의 보호 설정으로 남아 있습니다.
6. 정리
- 이관과 업그레이드를 나누려고 PHP와 MySQL 버전은 VM과 같게 맞췄습니다.
- 사이트별 이미지는 공통 베이스 위에 만들고, DB 접속 정보는 이미지 대신 Secret과 환경 변수로 넘겼습니다.
- 파일 이름의 인코딩이 다른 압축 파일은 macOS에서 풀지 않고 이미지 안에서 풀었습니다.
- MySQL 8의 기본 인증 방식이 VM 계정과 달라서 VM과 같은 방식으로 맞췄습니다.
- Cilium Gateway는 호스트 이름 없는 HTTP 리스너를 포트와 상관없이 합치므로, 서비스는 호스트 이름으로 나눠야 합니다.
- 전환을 확인할 때는 상태 코드가 아니라 본문 내용을 비교합니다.
참고
'Project > 홈랩' 카테고리의 다른 글
| [홈랩] Docker 컨테이너와 LMS를 Kubernetes로 옮기기 (7편) (0) | 2026.10.29 |
|---|---|
| [홈랩] Zabbix 5.4를 7.0 LTS로 옮기고 Kubernetes까지 모니터링하기 (6편) (1) | 2026.10.29 |
| [홈랩] Jenkins와 Argo CD로 홈랩 CI/CD 구성하기 (4편) (0) | 2026.10.29 |
| [홈랩] 웹 서비스 VM을 Kubernetes로 옮기고 검증하기 (3편) (0) | 2026.10.28 |
| [홈랩] 홈랩 Kubernetes 클러스터 설계와 노드 배치 (2편) (0) | 2026.10.28 |