#DevOps

되도록 최신 버전을 사용하는게 왜 이렇게 어려울까?

Summary

“어느 버전 쓰나요?” 질문을 완전히 지워버린 flex의 빌드 플랫폼 엔지니어링

단순해 보이는 규칙 아래 감춰진 빌드 시스템 동형성과 의존성 단방향화의 기술적 비밀

본 아티클은 라이브러리를 언제나 최신 상태로 유지하기 위해 flex가 개발한 'version family plugin'과 그 기반 인프라를 소개합니다. 기술 통일을 뜻하는 '동형성'의 중요성, 순환 없는 단방향 의존성 아키텍처의 설계, 그리고 전사 레포지토리에 버전을 안전하게 전파하는 Evergreen 파이프라인의 실체를 심도 있게 보여줍니다. 단순한 툴 개발을 넘어 동료 엔지니어들이 가볍고 빠르게 일할 수 있는 평평한 기반을 닦는 플랫폼 조직의 본질적 가치를 전달합니다.

01그룹 이름(group name)을 기반으로 여러 아티팩트의 버전을 단일 패밀리로 동기화하여 버전 불일치 원천 차단
02의존 구조를 단방향 순환이 없는 구조(DAG)로 강제해 자동화 도구가 배포 순서를 안정적으로 계산하도록 설계
03레포 : 도메인 : 모듈 구조를 1 : N : M 물리적 모듈로 쪼개어 헥사고날 아키텍처 의존 방향 제어
04버전 정책을 레포 외부로 분리해 문서나 예외 규율 대신 구조적 장치로 전사 통일성 강제
05공통 라이브러리 수정 사항을 제품 레포지토리로 안전하게 흘려보내는 Evergreen 자동화 파이프라인 적용

RECOMMENDATION

마이크로서비스나 폴리레포 아키텍처 환경에서 공통 모듈 버전 불일치로 마찰을 겪고 있거나, 효율적인 플랫폼 인프라 및 자동화 파이프라인을 구축하려는 데브옵스 및 시니어 백엔드 엔지니어에게 적극 권장합니다.

The Problem

폴리레포 환경에서 각 프로젝트가 개별적으로 라이브러리 버전을 고정하여 사용함에 따라, 어떤 버전이 안전하게 검증된 버전인지 공유되는 단일 출처가 없어 버전 불일치로 인한 슬랙 소통 및 디버깅 비용이 반복적으로 누적되는 문제가 있었습니다.

The Solution

사내 Gradle 플러그인(version family plugin)을 개발하여 그룹명 기준으로 버전을 묶어 관리하고, 의존 관계를 순환이 없는 단방향 그래프(DAG) 구조로 정렬한 뒤 버전 전파 자동화 파이프라인(Evergreen)을 구축했습니다.

The Result

어떤 라이브러리 버전을 써야 하는지에 대한 개발자들의 고민과 슬랙 소통 비용이 완전히 제거되었으며, 버전 비호환으로 밤새 디버깅하던 마찰을 구조적으로 없애 개발 편의성을 대폭 향상했습니다.

Trade-off

강력한 버전 및 의존성 응집의 대가로 시스템의 비가역성이 증가하여, 공통 빌드 정책에 오류가 생길 경우 전사 레포지토리가 동시에 장애 영향을 받을 수 있는 잠재적 리스크가 존재하며 모든 레포지토리가 Gradle 빌드 시스템을 공유해야만 작동한다는 전제 조건이 따릅니다.