삐걱거리는 오래된 Legacy 시스템 업그레이드

해당 포스트는..

오랫동안 사용했던 Laravel, php, vue.js, node.js, centos7, Apache, Mysql 등의 기술들을 최신의 버전으로 업그레이드 하는 과정을 담았습니다. 다양한 시행착오 끝에 마무리된 레거시 시스템 업그레이드 프로젝트를 기록합니다.

버전업의 필요성을 느끼다.

운영 시스템의 복잡성이 점차 증가하면서, 다양한 기술을 도입해야 하는 상황이 잦아졌습니다. 그에 따라 새로운 라이브러리 설치 또한 빈번해졌으나, 오래된 시스템과 프레임워크의 제약으로 호환되지 않는 문제들이 발생하기 시작했습니다.

현재 사용중인 웹프레임워크인 Laravel의 버전이 낮음에 따라 Composer로 설치할 수 있는 패키지의 선택의 폭이 좁았습니다. 가장 최근의 Laravel의 버전은 11.x 버전인 데 비해 사용하고 있는 버전은 너무 낮은 버전이었습니다. 부끄럽게도 기존 사용하는 버전은 2019년 8월에 종료된 5.6 버전이었습니다. 가장 먼저 시도한 것이 Laravel 8 버전으로 높여보자 였습니다. 5.6에서 6버전까지 올리는데는 composer.json에 버전 명시만 잘해주니 문제없이 진행되었습니다. 그러나 6버전에서 7버전으로 올릴때는 PHP 버전을 높여야하는 이슈가 생겼습니다.

사용중인 PHP 버전은 7.2 버전이었습니다. 7.2버전을 설치할 때는 소스컴파일로 설치를 하였기때문에 7.4버전도 경험에 의한 방법으로 소스컴파일 설치를 진행하였습니다.

error 1. configure: error: Package requirements (gdlib >= 2.1.0) were not met:
error 2. configure: error: Package requirements (sqlite3 > 3.7.4) were not met:
error 3. configure: error: Package requirements (icu-uc >= 50.1 icu-io icu-i18n) were not met:
error 4. configure: error: Package requirements (oniguruma) were not met:
error 5. configure: error: GD build test failed. Please check the config.log for details.

configure 과정에서 다양한 에러를 만났지만 하나하나 의존성 패키지를 업그레이드 해가며 설치진행하였습니다. 다행이 의존성 문제를 해결하니 7.4버전이 정상 설치되었습니다. PHP 하나 업그레이드 하는데 2~3일 걸리다보니 벌써 마음이 지치긴했지만 성공했다는 기쁨에 팀원들에게 같이 설치과정을 다시 해보자며 회의실에서 이러쿵 저러쿵 무용담을 늘어뜨리기도 했습니다. openssl 이 업그레이드 되어있는 특정 서버에서는 configure 에러가 또 다시 등장하여 애먹긴 하였지만 모든 사용 서버에 PHP7.4 버전업을 성공시켰습니다.

다음은 다시 Laravel을 6버전에서 8버전으로 업그레이드를 시도하였습니다. 다행이 PHP 버전에 따라 Laravel도 8 버전으로 문제없이 업그레이드 되었습니다. 물론 PHP 문법 변경에 따른 소스 수정은 진행하여야 했지만 무사히 프레임워크의 업그레이드를 성공하였습니다. 노션에 주요 변경사항을 기록하여 팀원들과 공유하였습니다.

Vue3를 사용하고 싶어요.

Laravel과 PHP 버전업의 성공으로 레거시 시스템 업그레이드 프로젝트에 자신감이 생겼습니다. 자신감이 생기고 자아도취를 하며 오래전부터 Vue3를 사용하고 싶어하는 유진님께 “Vue3도 업그레이드 해드릴게요~” 라고 선전포고를 하였습니다. 이참에 Vue3로 업그레이드 해서 Vue3와 호환되는 다양한 라이브러리들을 사용해보면 더 좋겠다는 생각도 예전부터 하고 있엇던 터라 Vue.js 업그레이드를 시작하였습니다.

자신감이 문제였을까요. 계속 알수 없는 에러를 내뿜으며 Vue2는 그리 쉽게 Vue3로 업그레이드 되지 않았습니다. 원인을 찾는데만 며칠 걸렸던 것 같습니다. 이유는 node.js 버전때문이었습니다. node.js 도 16버전을 사용하고 있었는데 vue3를 정상 설치하려면 18버전 이상의 버전이 필요했습니다. node.js는 nvm(node version management)으로 버전관리를 하고 있었기에 쉽게 버전업이 될거라고 생각했습니다. 그러나 Centos7는 뭔가 업그레이드 하면 곤란해보이는 에러를 내뿜었습니다.

내용은 Node가 지원할 수 있는 것보다 낮은 버전의 GLIBC가 운영 체제에 설치되어 있다는 것이었습니다. 여기서 이것을 업그레이드 할 것이냐, OS를 바꿔야 할것이냐에 큰 기로에 섰습니다. “Vue3를 사용하려고 OS를 바꿔야해?” 라는 약한 생각도 들었지만 앞으로 이런상황을 계속 회피할 순 없다는 생각에 OS를 바꿔보는 걸로 결정하였습니다.

Centos7가 “지원종료” 되다.

OS 를 변경하기 전에 기존에 사용하는 Centos7에 대해 조금 더 조사하던 중 놀라운 사실을 알게되었습니다. 바로 Centos7이 서비스 종료가 되었다는 것입니다. 불과 이 프로젝트를 시작한 1달 전에 종료되었습니다. 운명인것 같다는 생각도 들면서 더더욱 CentOS7 를 Ubuntu로 바꿔야겠다는 생각에 확신이 들었습니다.

Ubuntu로 변경하고 PHP도 8이상 버전으로 업그레이드 하고 다른 Regacy 기술들도 모두 버전업하여 당분간 몇년간은 기술 스택에 대해 문제없게끔 해야겠다는 생각을 하였습니다. Ubuntu 버전은 지원종료일이 최대한 멀리있는 22.04 또는 24.04 버전으로 결정하였습니다. 다시 Ubuntu 서버에 Apache / Mysql / PHP / Node.js / Python 등을 완벽 설치하는 것을 목표가 되었습니다.

Ubuntu 서버 세팅

지난 과정으로 설치과정에 나오는 무수한 에러에 대한 내성도 생겼고 설치에 대한 자신감도 생겼으니 Ubuntu 서버는 레퍼런스도 많고 아무런 문제 없이 잘 될 것이라 생각하고 호기롭게 Ubuntu 이미지를 EC2로 올렸습니다. 먼저 문제가 되었던 node.js 18 이상 버전이 잘 설치되는지를 테스트하였습니다.

nvm 을 설치하고 nvm install –lts 하니 기존 서버와는 다르게 속시원하게 아무런 에러를 내지 않고 무려 v20 버전이 설치되었습니다. “역시 ubuntu는 문제없네”라고 생각하며 APM을 설치해보기 시작했습니다.

정말 오랜만에 Centos7서버를 세팅했던 오래된 docx 문서를 열고 구글링과 제5의 멤버 GPT 와 함께 Apache / Mysql / PHP8 순서대로 설치하기 시작했습니다. /home/source 디렉토리를 만들어 wget으로 관련 소스파일을 다운받아 configure / make && make install 과정으로 설치하였습니다. Apache와 Mysql은 시간은 오래걸렸지만 메뉴얼을 따라가니 문제없이 설치되었습니다. 그러나 PHP8 버전을 설치하려니 기존 추가모듈이 기본모듈이 되기도 하고 기본모듈이 빠지기도 하는 등의 configure 차이가 있어 여러번의 시도 끝에 PHP8 버전을 설치하였습니다.

단순 설치만으로 3일 정도를 소요한것 같습니다. 그러나 소스설치보다 apt-get으로 설치하는것이 더 올바른 방향인것 같다는 생각이 들었습니다. 그 이유는 추후 Docker file을 만들기 위해서는 설치과정의 단순화가 필요했습니다. 소스설치를 하고보니 이 과정의 명령줄을 적어야 한다는 것은 너무 어려운 일처럼 느껴졌습니다.

그래서 설치방법을 바꾸고 apt-get 으로 APM 을 설치하였습니다. 정말 그동안 왜 소스설치를 고집했을까 싶을 정도로 너무 쉽고 빠르게 설치되었고 연동도 잘되었습니다. 기존 사용하던 경로와 달라진 점을 체크하긴하였지만 러닝커브가 그리 크진 않았습니다. conf와 ini 파일을 체크하고 기쁘게 소스 테스트를 진행했습니다.

그런데 소스 테스트 중 두가지 이슈가 발생했습니다.

첫 번째는 PHP-PDO의 SSL Connect 에러였습니다.

PHP Fatal error:  Uncaught PDOException: SQLSTATE[HY000] [2026] SSL connection error: error:00000001:lib(0)::reason(1)

사용하는 DB는 SSL 을 사용하지 않는데 해당 오류가 나와 당황했습니다. 해당이슈는 ssl-mode=disabled 를 주어 해결하였고 ERP DB인 Mssql Connect는 TrustServerCertificate=true 옵션을 주어 해결하였습니다.

두 번째는 Curl SSL Error 였습니다. 특정 서버에 대한 요청에 다음 에러가 발생하였고 관련 레퍼런스를 찾는데 꽤나 애먹었습니다.

error:0A000152:SSL routines::unsafe legacy renegotiation disabled

문제의 원인은 openSSL 이었습니다. Ubuntu에 설치된 기본 openSSL 은 3.0.3 버전이고 해당 버전은 SSL 안전하지 보안 레거시 재협상을 기본적으로 제공하지 않는 것이었습니다. openssl.conf 파일에 UnsafeLegacyRenegotiation 옵션을 주어 해결하였습니다.

오랜기간동안 다양한 에러를 해결해나가고 좌절하기도 하며 서버 이관을 하는 동안 굉장히 많은 우울감이 찾아왔지만, 팀원들이 알려준 우웅법으로 우울감을 조금이나마 덜었습니다. ☆٩(｡•ω<｡)و

Vue 업그레이드에 성공하다.

소스에서 가장 중요한 기능인 PDO 와 Curl 테스트가 성공하니 나머지 소스는 오류가 나더라도 맞춰서 수정하면 될것 같았습니다. 이후 서버 이전의 트리거였던 Vue3를 설치해보기로 하였습니다. 새로운 기술을 써보기 위해 먼길을 돌아왔지만 무언가 하나를 해결하면 하나가 안되는 경험을 수차례 하여서 Vue3도 쉽지 않을 것이라 예상하며 마음을 비우고 시작하였습니다.

그런데 그동안의 노력을 보상해주는 것인지 Vue3는 Node.js 20 버전과 함께 부드럽게 업그레이드 되었습니다. vue3 업그레이드와 laravel-mix 업그레이드도 진행하였고 업그레이드에 따라 문법들을 하나하나 수정하였습니다.

하나하나 수정을하며 npm run dev를 실행하였는데 드디어 정상 컴파일되었습니다. 이 맛에 개발자하는 것 같습니다. 오랜만에 Comport Zone이 아닌 Learning Zone에 있던 개발 건을 해결한 기분이었습니다. mix 과정도 UI가 예뻐졌습니다.

마무리…

현재는 거의 모든 소스 테스트를 마치고 기존 운영서버를 하나씩 옮겨가고 있으며 Jenkins 서버도 변경하여 기존 CentOS서버를 서서히 떠나고있습니다. 오래된 집에서 새집으로 이사가는 느낌이 들지만 오랫동안 사용했던 익숙함에 대해서도 아쉬움이 남는 작업이었습니다. 그러나 이번 계기로 확실히 배운것 중에 하나는 당장에 편함을 선택하여 기술부채를 늘리지 말자입니다. 한동안 익숙한 시스템에서 Comport 하게 지냈던 자신을 반성하였습니다.

마지막으로 오랜기간 숙성되었던 레거시 시스템 이관으로 앞으로는 더 좋은 기술들을 사용해보며 스킬업할 수 있는 계기가 되었으면 좋겠습니다.🥳