배포 프로세스 작게 개선해보기

문제점

최근 여러 패키지를 묶어 데스크톱 앱까지 패키징 하는 배포 작업을 진행하면서 가장 고민되었던 부분이 버전 관리였다. 우리 프로젝트는 웹 빌드만으로 끝나는 구조가 아니라 최종적으로 Electron 기반 데스크톱 앱까지 생성해야 하는데, 데스크톱 앱의 버전, 배포 후 노션에 정리하는 여러 배포 정보까지 모두 수동으로 관리하고 있었다. 초기에는 큰 문제가 없었지만 작업량이 늘어날수록 부담도 함께 커졌고, 팀에서도 동일한 불편이 반복적으로 언급되면서 더 효율적인 방식이 필요하다는 생각이 들었다.

여기에 아직 확립된 버전 체계도 없는 상태였다. 초기 스타트업 특성상 고객사의 요청에 따라 기능을 빠르게 커스텀하거나 POC를 반복하는 일이 많아, 하나의 기능을 기준으로 여러 버전이 계속해서 생성되는 상황이었다. 더불어 어떤 배포는 dev 환경을 대상으로, 어떤 배포는 prd 환경을 바라보는 등 환경 설정도 일정하지 않아 혼란이 생기는 경우도 많았다.

이런 상황이 겹치면서 버전이 쌓일수록 “누가, 무엇을, 어떤 버전으로, 어떤 환경에, 어떤 디바이스에 배포했는지” 정확하게 추적하기가 점점 어려워졌고 이런 방식을 개선해 보고자 간단한 배포 봇을 하나 만들었다

1) 버전 자동 업데이트

yarn build <package> <command> -v 2.3.0

-v 옵션이 들어가면 자동으로 버전 업데이트 모드로 동작한다.

• 웹 패키지의 버전을 올리면
• 데스크톱 앱의 버전에도 반영되고
• 최종 설치 파일의 버전까지 함께 맞춰야 한다

기존에는 이 과정을 모두 직접 챙겨야 했지만, 스크립트가 처리하도록 만들었다.

2) CLI 입력 인터랙션

버전이 올라가는 배포는 반드시 필요한 정보들이 존재하기 때문에, 아래 항목을 CLI에서 순차적으로 입력받도록 했다.

• 배포 환경(dev / prd)
• 설치된 디바이스 번호
• 배포 대상(지점명·사업명 등)
• 배포자
• 커밋 해시(HEAD → 앞 7자리)

3) Slack Webhook 알림

수집한 정보는 Slack Webhook을 통해 자동으로 배포 로그로 남긴다. 메시지에는 아래 내용이 포함된다.

• 패키지 이름 
• 버전
• 배포 환경(dev/prd)
• 설치된 디바이스 번호
• 배포 대상
• 배포자
• 커밋 해시(7자리)

-----

다행히 팀원 모두 이 개선 방식을 긍정적으로 받아들였고 덕분에 바로 도입할 수 있었다. 아직 전체 배포 프로세스에는 다듬어야 할 부분이 많지만, 완벽한 구조를 한 번에 만들기보다 지금 당장 불편한 지점을 작은 단위로라도 개선해 나가는 것이 더 현실적이라고 느꼈다. 항상 모든 개선에 긍정적으로 반응해주는 팀원들 덕분에 나도 계속 더 나은 방식들을 고민해 볼 수 있는 것 같다. 🙂