데브옵스
[DevOps] GitLab 버전 업그레이드는 계속 된다.
두줄요약
GitLab 15.1.6을 16.9.4로 올리는 업그레이드 과정을 정리했습니다. 백업, PAT 정책, PostgreSQL, Runner 이슈 대응까지 함께 다뤘습니다.
문제 상황
- GitLab 15.1.6에서 16.9.4로의 정기 업그레이드 필요성
- 오래된 버전 사용에 따른 최신 기능 활용 제한과 보안 업데이트 필요
- 업그레이드 과정에서 PAT 만료 정책 변경, PostgreSQL 버전 요구사항, Runner 연동 이슈 발생
원인 분석
- GitLab 16.0 이후 Never 만료 PAT의 강제 만료 정책 적용
- GitLab 16부터 PostgreSQL 13 이상 필요
- 신규 Runner 인스턴스의 캐시 부재와 Docker Hub 동시 Pull 증가
해결 방법
- 공식 Upgrade Path 확인 후 중간 버전을 거치는 순차 업그레이드
- 업그레이드 전 AMI 생성과 DB 백업으로 복구 대비
- PAT 만료일 재설정, PostgreSQL 업그레이드, Runner SSH 포트 오픈, Docker 인증 설정 적용
성능/운영 포인트
- 업그레이드 후 GitLab 서비스 재시작과 reconfigure로 상태 정리
- CI/CD, 접속, 백업 복원 절차까지 함께 검증
- 예상치 못한 장애는 공식 문서와 커뮤니티 참고로 대응
