WAR 배포와 병행 배포로 무중단 전환

목표

WAR 배포의 실제 동작을 확인하고, 병행 배포(Parallel Deployment) 로 세션을 끊지 않고
버전을 올린 뒤, 검증까지 하는 배포 스크립트를 작성할 수 있게 됩니다.

왜 중요한가

단일 WAS 환경에서 무중단 배포를 하려면 L4 앞단에서 서버를 빼고 넣어야 한다고
생각하기 쉽습니다. 그런데 톰캣에는 원래 병행 배포 기능이 있습니다.
파일명에 ##버전 을 붙이면 같은 컨텍스트에 여러 버전이 공존하고,
기존 세션은 구버전으로, 신규 요청은 신버전으로 갑니다.
많은 SI 현장이 이 기능을 모른 채 새벽 정지 배포를 반복합니다.
또 하나 — 배포 스크립트가 전개 완료를 기다리지 않으면 실패한 배포를
성공으로 보고합니다. 그게 정지 배포보다 훨씬 나쁩니다.

단계

1. Tomcat 을 기동하고 /opt/lab/samples/labhub-1.0.0.war 를
/opt/tomcat/webapps/labhub##001.war 로 배포합니다.
http://127.0.0.1:8080/labhub/version 이 1.0.0 을 반환해야 하고,
catalina.out 에 labhub##001 배포 기록이 남아야 합니다.
(이 배포 기록이 이후 단계의 증거로 쓰입니다.)
2. 전개된 디렉터리를 확인해 /root/tc/explode.csv 를 만듭니다.
첫 줄은 path,exists. 아래 네 경로에 대해 Y/N 을 적습니다.
WEB-INF/web.xml, WEB-INF/classes, WEB-INF/lib, META-INF
3. /opt/lab/samples/labhub-2.0.0.war 를
/opt/tomcat/webapps/labhub##002.war 로 배포합니다.
이때 ##001 을 먼저 지우지 말고 두 버전이 공존하게 두세요.
http://127.0.0.1:8080/labhub/version 이 이제 2.0.0 을 반환해야 하고,
catalina.out 에 labhub##001 과 labhub##002 배포 기록이 모두 있어야 합니다.
4. /root/tc/parallel.md 를 작성합니다. 아래 세 가지가 본문에 들어가야 합니다.

• 기존 세션을 가진 요청이 어느 버전으로 가는지
• 신규 요청이 어느 버전으로 가는지
• 버전 문자열이 문자열 비교로 정렬되므로 ##1/##10 같은 표기가 위험한 이유

001 과 002 두 문자열이 모두 등장해야 합니다.
5. ##001 버전을 완전히 제거합니다(WAR 와 전개 디렉터리 모두).
제거 후에도 http://127.0.0.1:8080/labhub/version 이 2.0.0 이어야 합니다.
6. /opt/lab/samples/labhub-boot.jar 를 8082 포트로 백그라운드 기동하고
로그를 /root/tc/boot.log 로 남깁니다.
http://127.0.0.1:8082/version 이 200 이어야 합니다.
7. /root/tc/war-vs-jar.csv 를 만듭니다. 첫 줄은 항목,WAR,JAR.
배포단위, 톰캣버전관리, 포트지정, 롤백, 무중단 다섯 항목이 있어야 하고
각 칸은 비어 있으면 안 됩니다.
8. /root/tc/deploy-war.sh 를 만듭니다. 인자 두 개(WAR파일 컨텍스트명)를 받아

• WAR 파일이 없거나 크기가 0 이면 즉시 0 이 아닌 종료코드로 끝냅니다.
• 있으면 webapps 로 배치하고 최대 30초 동안 폴링하며 전개를 기다립니다.
• http://127.0.0.1:8080/<컨텍스트명>/version 이 200 이면 종료코드 0,

30초 안에 안 되면 0 이 아닌 종료코드로 끝냅니다.

참고

• curl -s -o /dev/null -w '%{http_code}' <URL> 로 상태코드만 얻습니다.
• WAR 는 zip 입니다: unzip -l 파일.war 로 내용을 볼 수 있습니다.
• 실행 가능 JAR 포트 지정: java -jar app.jar --server.port=8082
• 흔한 실수 1: 복사 직후 바로 검증해서 404 를 실패로 판정하는 것. 폴링이 필요합니다.
• 흔한 실수 2: ##002 를 배포하며 ##001 WAR 를 먼저 지우는 것.

그러면 병행 배포가 아니라 그냥 교체 배포입니다.

• 흔한 실수 3: 배포 스크립트가 검증 없이 항상 0 으로 끝나는 것.

실패한 배포를 성공으로 보고하는 스크립트가 가장 위험합니다.

단계 8개

1. 첫 버전 배포
2. 전개 결과 확인
3. 두 번째 버전 병행 배포
4. 세션 드레이닝 이해 정리
5. 구버전 내리기
6. 실행 가능 JAR 기동
7. WAR 와 JAR 비교표
8. 배포 스크립트 작성