GitLab CI × Slack Webhook | 1. Freeze-Free MR Pipeline 설계

📌 이 글은 GitLab CI × Slack Webhook 중 1편입니다.
2편: Freeze-Window 차단·MR 알림·외부 Include 자동화
3편: 사용자별 프로필 이모지 맞춤 적용
4편: 가이드- MR 알림·Draft 토글·충돌 감지

---

1. 문제 상황 또는 동기 (Motivation)

• 프로젝트 프리징 기간에 MR이 실수로 머지되어 소스가 반영되는 일이 발생
• 배포 안정성 확보와 휴먼에러 방지를 위해 자동화된 차단 장치 필요성 인식
• CI/CD, .gitlab-ci.yml, bash 등 익숙하지 않은 환경에서의 자동화 도입에 대한 도전

---

2. 목표 및 요구사항 (Goal & Requirements)

• 프리징 기간에 MR이 머지되는 것을 사전에 차단 (자동화)
• Slack Webhook을 통한 실시간 알림 연동
• 차단 시점(MR 전/후) 명확화 및 유연한 조건 분기
• GitLab CI/CD 변수, bash 스크립트, GitLab Predefined Variables 적극 활용

---

3. 구현 과정 (Implementation)

3.1 주요 코드/로직 설명

• Slack Webhook 신청 및 테스트, 실제로 Slack 채널에 메시지가 오는지 curl로 사전 검증
• .gitlab-ci.yml 작성 및 GitLab Settings > CI/CD > Variables에서 SLACK_URL, F_S_DATE, F_E_DATE 등 변수 세팅
• MR 이벤트 감지 및 조건 분기, Slack 알림 전송, 파이프라인 차단 등 구현

3.2 시행착오/트러블슈팅

• GitLab Workflow와 CI/CD 개념 혼동, .gitlab-ci.yml 문법 미숙으로 인한 반복적인 에러
• GitLab Predefined Variables 사용법, MR 이벤트 감지 조건(rules, only 등) 시행착오
• bash 문법, Slack Webhook 메시지 특수문자 처리 등에서 반복적인 에러 경험
• 특히, curl 명령어에서 변수와 특수문자, 이모지, 줄바꿈 처리 등으로 인해 예상치 못한 에러가 자주 발생
• MR 생성이 트리거가 되어야 하므로, 배치형식이 아닌 상시성 파이프라인 설계의 어려움

해당 작업도 다른 작업들처럼 배치형식으로 일정한 주기를 가지고 할 수 있는 것이었으면 작업이 편했을 것 같으나, 이 작업은 사람이 MR을 생성 했을시, 수행되어야하기에 MR이 생성된 시점에서 수행되어야 했습니다. 그래서 상시성을 갖고 있어야한다는 점이 서러웠습니다. 그 외에도 bash 작성 때 만난 Nested Mapping Error, collapse multi line command 등등 많은 트러블이 있었습니다.

GitLab CI/CD Workflow

---

4. 결과 & 배운 점 (Result & Learning)

• 프리징 기간 중 실수로 인한 소스 반영을 사전에 차단하고, Slack을 통한 실시간 알림으로 개발 환경의 안정성을 크게 높일 수 있었습니다.
• 실제로 MR이 차단되는 상황을 경험하며, 휴먼에러로 인한 리소스 낭비를 줄이고, 개발 효율을 개선할 수 있었습니다.
• GitLab CI/CD 자동화 파이프라인을 직접 설계·구현하면서 bash 스크립트 작성과 GitLab 변수 활용 능력이 크게 향상되었습니다.
• 상시성 파이프라인 구조와 다양한 예외 상황을 처리하는 로직을 고민하며, 실무에서의 자동화 설계와 운영 경험을 쌓을 수 있었습니다.

---

5. 기술 스택 (Tech Stack)

GitLab GitLab CI Bash Script Slack Webhook

---

6. 참고 자료 (References)

• GitLab CI/CD 공식 문서
• Slack Webhook 공식 문서
• 깃랩 워크플로우 이미지 출처
• 깃허브 PR eslint 예제

---