얼마 전 클라우드웨이즈(Cloudways)에서 기존 Vultr 서버의 운영체제를 데비안 11에서 데비안 12로 업그레이드하기 위해 새 서버로 복제하는 작업을 진행했습니다. 서버 복제를 통해 서버 설정은 그대로 두고 최신 OS의 서버로 업그레이드했습니다.😄 복제 후 모든 기능이 정상 작동했지만 신규 워드프레스 애플리케이션을 추가하니 서버 내에 있는 다른 사이트로 리디렉션되는 라우팅 오류가 발생하는 것을 발견했습니다.
임시방편으로 Nginx 서비스를 재시작하면 문제가 해결되었지만, 근본적인 문제 해결을 위해 이 버그를 클라우드웨이즈에 보고했습니다. 클라우드웨이즈 엔지니어링 팀 담당자가 문제의 원인을 파악하여 오류를 수정해주었습니다.
기술적인 문제라서 저 같은 일반 사용자는 알 필요가 없지만, 기록 목적으로 문제의 원인과 해결 방법에 대해 간략히 정리해 보았습니다. 클라우드웨이즈에서 문제가 발생할 경우 라이브 채팅으로 연락하면 대부분 빠르게 문제를 해결해주고, 일선 담당자가 해결을 못하면 엔지니어링 팀으로 회부하여 문제를 해결해줄 것입니다.
클라우드웨이즈 서버 복제 후 라우팅 오류 버그 해결
1. 증상
- 비정상적인 라우팅: 서버에서 신규 애플리케이션(워드프레스)을 생성한 후 해당 URL에 접속하면, 새 사이트가 열리지 않고 서버 내에 있는 다른 기존 사이트로 연결(리디렉션)되는 문제가 발생했습니다.
- 임시적인 방법으로 Nginx 서비스 재시작으로 문제 해결: 서버(Nginx/Apache) 서비스를 수동으로 재시작하면 설정이 적용되어 새 애플리케이션의 본래 URL로 정상 접속되었습니다.
2. 원인
- 핸들러 이름 충돌 버그: 새 애플리케이션을 생성(프로비저닝)할 때 서버의 설정을 자동화하는 스크립트(Ansible) 내에 버그가 있었습니다.
- Apache 재시작 누락: Multi-PHP 환경과 Single-PHP 환경의 설정 업데이트를 담당하는 '핸들러(명령어)'의 이름이 동일하게 지정되어 있었습니다. 이 충돌로 인해 새 가상 호스트(Virtual Host) 파일은 서버에 정상적으로 만들어졌음에도 불구하고, Apache 서버를 새로고침(Reload)하는 단계가 '건너뜀(Skipped)' 처리되었습니다.
- 오래된 설정 유지: Apache가 새 설정을 읽어오지 못하고 과거의 설정(Stale vhosts)을 그대로 유지했기 때문에, 새로 생성된 주소를 인식하지 못하고 엉뚱한 기존 사이트로 연결한 것입니다.
- 참고사항: 이는 단순히 Debian 12 OS 자체의 문제가 아니라, 새로 복제된 서버에 적용된 특정 프로비저닝 스크립트 경로에만 존재했던 시스템적 버그였습니다.
3. 해결
- 스크립트 수정: 클라우드웨이즈 엔지니어링 팀에서 충돌을 일으키던 핸들러들의 이름을 각각 고유한 이름으로 변경하여 충돌을 제거했습니다.
- 서버 정상화: 문제가 발생했던 서버들의 Apache를 다시 로드하여 밀려있던 가상 호스트 설정들을 모두 정상적으로 적용시켰습니다.
👉 사실 이 증상은 Apache 웹 서버와 관련된 설정 충돌 때문에 일어났습니다. 결과론적인 이야기지만, 웹 스택을 하이브리드 스택 대신 라이트닝 스택(Lightning Stack)으로 구성했다면 이런 라우팅 문제 자체를 피할 수 있었을 것 같습니다.
클라우드웨이즈에서 라이트닝 스택을 선택하면 아파치(Apache)를 거치지 않기 때문에 사이트 속도 면에서는 확실히 더 빠릅니다. 하지만 아파치 환경의 핵심인 .htaccess 파일을 지원하지 않아, 이를 기반으로 작동하는 일부 워드프레스 플러그인(보안, 캐시 등)에서 호환성 문제가 발생할 수 있습니다. 그래서 저는 안정성을 위해 주로 하이브리드 스택(Hybrid Stack)을 사용하는 편입니다. 다만, 복잡한 기능이 필요 없는 심플한 웹사이트라면 라이트닝 스택을 선택하는 것도 좋은 선택이 될 것입니다.
웹스택은 애플리케이션 설정 » WebStack에서 변경할 수 있습니다.
근본적인 해결 여부
이 문제는 클라우드웨이즈 시스템(백엔드 자동화 스크립트) 단에서 근본적으로 해결되었습니다.
엔지니어링 팀이 애플리케이션을 생성할 때 구동되는 스크립트 자체의 논리적 오류(이름 충돌)를 수정했기 때문에, 앞으로 동일한 문제가 재발하지 않을 것입니다.
따라서 추후 복제한 서버에서 새 애플리케이션을 추가할 때 클라우드웨이즈 개발팀이 서버 구성 파일을 직접 수정하거나, 사용자가 매번 서버를 수동으로 재시작할 필요가 없습니다. 새 애플리케이션을 생성하면 정상적인 URL로 자동 연결될 것입니다.
댓글 남기기