seon99il

← Linkchain

Git-flow 기반 협업 문화 정착 및 CI/CD 자동화 파이프라인 구축

코드 리뷰 부재와 수동 배포를 2인 크로스 리뷰, GitHub Actions CI, Ansible Dynamic Inventory CD로 해결

Git-flowGitHub ActionsAnsibleAWS

문제

  • 코드 리뷰 부재로 인한 도메인 지식 사일로(Silo):
    코드 리뷰 문화가 없어 특정 모듈이나 비즈니스 로직을 개발자 한 명만 알고 있는 지식 파편화가 발생했고, 컨텍스트 스위칭과 중복된 로직의 코드 작성으로 코드 품질이 하락했습니다.
  • 수동 배포의 휴먼 에러와 인프라 확장 병목:
    서버 인스턴스(IP 등)와 시스템이 강하게 결합된 배포 방식 때문에 인프라 확장(Scale-out)·이동 시 배포 타겟 노드를 수동으로 관리해야 했고, 서버에 직접 접속해 코드를 배포하는 수동 프로세스로 휴먼 에러가 빈번하게 발생했습니다.

요구된 기술 요건은 개발자 간 크로스 체크를 강제하는 시스템화된 지식 공유 룰, 코드 리뷰 오버헤드를 줄이는 자동화된 CI, 동적으로 변하는 서버 노드를 자동 식별해 안전하게 배포하는 인프라 비종속적 CD입니다.

해결

CI Workflow
  • Git-flow 기반 브랜치 보호 및 2인 크로스 리뷰 강제화:
    Main 브랜치를 보호(Branch Protection)하는 Git-flow 기반 개발 컨벤션을 수립하고, PR 생성 시 2명의 팀원에게 교차 검증(Approve)을 받아야만 병합되도록 정책으로 강제해 도메인 지식이 팀 전체로 자연스럽게 스며들도록 했습니다.
  • 리뷰 사이드 이펙트 방어를 위한 GitHub Actions CI 구축:
    PR 생성 시 GitHub Actions가 Linter와 Unit Test를 자동 수행하게 하고, 검증 실패 시 Merge를 원천 차단해 동료 리뷰어가 단순 오류 찾기가 아닌 ‘핵심 비즈니스 로직’ 검토에만 집중하도록 책임을 분리했습니다.
CD Workflow
  • Ansible Dynamic Inventory 기반 인프라 비종속적 CD 구축:
    고정된 IP 대신 Ansible Dynamic Inventory로 클라우드 환경의 메타데이터(Tag)를 기반으로 배포 대상 노드를 동적으로 식별하도록 설계했습니다. 인프라 스케일 아웃·시스템 이동 시에도 스크립트 수정 없이 AWS Tag 추가/삭제만으로 최신 코드가 즉시 배포됩니다.

결과

  • 도메인 지식 사일로 해소 및 중복 코드 방지를 통한 응집도 향상:
    최소 2인 교차 리뷰로 팀원 전원의 서비스 아키텍처 및 로직 이해도를 상향 평준화했고, 이미 구현된 모듈을 몰라 생기는 ‘중복 개발’을 사전에 차단해 코드 재사용을 유도, 시스템의 응집도(Cohesion)와 전반적인 코드 퀄리티를 높였습니다.
  • CI 자동화를 통한 ‘코드 리뷰 트레이드 오프’ 원천 차단:
    린터 및 유닛 테스트의 CI 자동화로 리뷰어 피로도 증가와 배포 리드 타임 지연 문제를 방어하고, ‘코드 품질(리뷰)‘과 ‘개발 딜리버리 속도(CI)‘를 모두 확보할 수 있는 개발 컨벤션을 확보했습니다.
  • Ansible Dynamic Inventory 기반 CD로 운영 안정성 및 확장성 극대화:
    배포 타겟을 동적으로 관리해 수동 배포로 인한 휴먼 에러를 0으로 수렴시켰고, 인프라 확장 및 이동 시 발생하던 정적 파이프라인 수정을 없애 배포 관리 포인트를 최소화했습니다.