콘텐츠로 이동

Big Ball of Mud란 무엇인가

“Big Ball of Mud”는 운영위원회 앞에서 아키텍처 평가를 시작할 때 선뜻 꺼낼 만한 표현은 아닙니다. 개발자들끼리 쓰는 은어처럼 들리고, 어쩌면 비난처럼 들리기도 합니다. 자기 시스템을 이렇게 부른다면 적어도 몇 가지 질문은 받을 각오를 해야 합니다.

그렇다고 근거 없이 생겨난 말은 아닙니다. 빅 볼 오브 머드(Big Ball of Mud)는 소프트웨어 아키텍처와 패턴 문헌에서 나온 용어입니다. Brian Foote와 Joseph Yoder는 1997년 Pattern Languages of Programs Conference에서 같은 제목의 논문을 발표했고, 이후 이 글은 _Pattern Languages of Program Design 4_에 실렸습니다. 그 뒤로도 아키텍처 침식(Architecture Erosion)과 설계 침식(Design Erosion)을 다루는 연구를 비롯한 소프트웨어 엔지니어링 문헌에서 이 개념을 사용해 왔습니다.

하지만 그렇다고 공식적으로 표준화된 진단이 되는 것은 아닙니다. ISO 정의도, 보편적으로 합의된 측정값도, 어느 지점부터 애플리케이션이 ‘일반적인’ 레거시 시스템을 넘어 객관적으로 Big Ball of Mud가 된다고 판정할 임계값도 없습니다.

이 용어는 오히려 특정한 구조적 상태를 놀랄 만큼 정확하게 설명해 줍니다.

무엇보다 ‘모놀리스’와는 다른 것을 설명합니다.

Foote와 Yoder는 자신의 설명을 다음 한 문장으로 요약합니다.

“A BIG BALL OF MUD is a casually, even haphazardly, structured system.”

구조가 체계적인 설계보다는 그때그때의 필요에 따라, 때로는 별다른 계획 없이 만들어진 시스템을 뜻합니다. 시스템의 구성은 일관된 설계보다 당장의 편의에 더 크게 좌우됩니다.

두 저자는 통제되지 않는 성장과 반복되는 실용적인 수선으로 만들어진 시스템을 설명합니다. 정보는 시스템의 멀리 떨어진 여러 부분에서 공유되거나 중복으로 저장됩니다. 전체 구조가 애초에 명확하게 정의되지 않았거나, 시간이 흐르며 너무 많이 침식되어 더는 알아보기 어려워진 것입니다.

여기서는 저자들이 하지 않은 말도 중요합니다.

Big Ball of Mud를 그저 형편없는 소프트웨어 개발의 증거나 개별 개발자의 도덕적 실패로 설명하지 않습니다. 오히려 왜 이런 시스템이 그토록 자주 생기는지를 묻는 데 논문의 상당 부분을 할애합니다.

그 시스템을 만들어 내는 결정들은 단기적으로는 아주 합리적으로 보일 수 있기 때문입니다.

실용적인 수정이 구조를 제대로 갖춘 해결책보다 빠른 경우가 많습니다. 기존 경계를 먼저 바꾸기보다 우회하는 편이 더 저렴해 보일 수 있습니다. 프로토타입은 제 역할을 마친 뒤에도 계속 사용될 수 있습니다. 매번 포괄적인 아키텍처 의사결정을 내리는 것이 필요하거나 경제적으로 타당하지 않아도, 애플리케이션은 여러 해에 걸쳐 성장할 수 있습니다.

그러므로 개별 결정이 모두 명백한 오판이었다는 것이 문제는 아닙니다.

문제는 그 결정들이 쌓인 결과 시스템의 내부 구조가 어떻게 되느냐입니다.

지금도 제가 이 개념에 관심을 갖는 이유는 바로 이 양면성에 있습니다.

아키텍처가 시스템을 설명하지 못하게 될 때

섹션 제목: “아키텍처가 시스템을 설명하지 못하게 될 때”

이후의 연구는 이와 관련된 과정을 아키텍처 침식 또는 설계 침식이라는 개념으로 설명합니다.

Li, Liang, Soliman, Avgeriou는 실무자들이 아키텍처 침식을 어떻게 인식하는지 연구했습니다. 간단히 말하면, 실제로 구현된 시스템 구조가 의도한 아키텍처에서 점점 멀어지는 과정입니다.

저자들은 그 과정이 극단에 이른 한 가지 가능한 형태를 Big Ball of Mud와 명시적으로 연결합니다. 마침내 알아볼 수 있는 아키텍처, 즉 _perceivable architecture_가 사라진 시스템입니다.

이 표현은 중요한 지점을 짚습니다.

아키텍처가 리포지터리에서 물리적으로 사라지는 것은 아닙니다.

디렉터리는 여전히 있습니다. 모듈, 컴포넌트, 클래스, 서비스도 있습니다. 최신 아키텍처 다이어그램까지 있을 수 있습니다. 각 영역에는 도메인을 나타내는 이름이 붙고, 파일 시스템에서는 레이어도 보입니다.

겉으로는 구조를 갖춘 시스템처럼 보입니다.

하지만 그렇게 보이는 구조만으로 시스템의 실제 동작을 설명하기는 점점 어려워집니다.

Baum, Dietrich, Anslow, Müller도 설계 침식이라는 관점에서 이 과정을 살펴봅니다. 시스템이 진화하는 동안 설계 원칙 위반이 어떻게 생겨나고 퍼질 수 있는지 연구합니다. 여기서 Big Ball of Mud는 어느 화요일 아침 갑자기 나타나는 상태가 아닙니다. 구조가 계속 나빠진 끝에 이를 수 있는 한 가지 결과입니다.

이 과정이 구체적으로 어떻게 시작되는지는 별도의 질문입니다. 다음 글에서 다루겠습니다.

지금 개념을 정의하는 데에는 다른 관찰이면 충분합니다.

Big Ball of Mud는 시스템의 외형이 아니라 내부 구조의 상태를 설명합니다.

좀 더 정확하게 표현하면 다음과 같습니다.

Big Ball of Mud는 시스템에 보이는 구조나 의도한 구조가 실제 구성을 점점 더 제대로 설명하지 못하는 상태입니다.

이는 Foote와 Yoder의 정의가 아닙니다. 두 저자의 원래 설명과 이후 아키텍처·설계 침식 연구를 바탕으로 이 시리즈에서 사용할 작업 정의입니다.

의도한 아키텍처와 실제 아키텍처. 왼쪽에서는 명확한 영역과 레이어가 의존성을 제한합니다. 오른쪽에도 같은 경계는 보이지만 실제 의존성은 여러 곳에서 경계를 넘습니다.

원본 크기로 보기

구현에서 경계가 점점 더 힘을 잃더라도, 문서 위의 아키텍처는 그대로 남아 있을 수 있습니다.

프론트엔드에서 사용할 작업 정의

섹션 제목: “프론트엔드에서 사용할 작업 정의”

이 개념을 프론트엔드에 적용할 때 특정 기술이나 정해진 규모부터 찾을 필요는 없습니다.

코드베이스가 크거나 오래되었거나, 한꺼번에 배포되거나 많은 개발자가 함께 작업한다는 이유로 Big Ball of Mud가 되는 것은 아닙니다.

그런 특징은 훌륭하게 구조화된 시스템에도, 구조가 완전히 침식된 시스템에도 나타날 수 있습니다.

중요한 것은 아키텍처가 실제로 어느 정도까지 구조를 잡아 주느냐입니다.

도메인 경계는 서로 다른 책임을 나누어야 합니다. 슬라이스는 시스템의 어느 부분이 서로를 알아야 하는지 제한해야 합니다. 레이어는 책임과 의존성의 방향을 정해야 합니다. 인터페이스는 어떤 정보가 그 경계를 넘을지 통제해야 합니다.

Big Ball of Mud에서는 이런 경계가 점점 제 역할을 잃습니다.

도메인 책임이 뒤섞입니다. 디렉터리 트리에는 슬라이스 경계가 남아 있어도 실제 의존성을 제한하는 힘은 약해집니다. 레이어에는 이름이 있지만 의존성의 방향은 더는 일관되게 지켜지지 않습니다. 책임은 영역 사이를 떠돌고, 새로운 변경은 설계상 적절한 곳보다 당장 기술적으로 손댈 수 있는 곳에 들어가기 시작합니다.

그렇게 아키텍처는 자신의 가장 중요한 기능 중 하나를 잃습니다.

시스템의 구조를 보고 책임과 변경의 영향을 추론하는 데 점점 도움이 되지 않습니다.

따라서 이 시리즈에서는 프론트엔드에 다음과 같은 작업 정의를 사용합니다.

프론트엔드의 내부 구조가 변경, 책임, 의존성을 더는 신뢰할 만하게 제한하거나 이해할 수 있게 해 주지 못하는 지점에서, 그 프론트엔드는 Big Ball of Mud가 됩니다.

디렉터리 이름은 여전히 orders입니다. 컴포넌트는 여전히 presentation 아래에 있습니다. 어떤 영역은 여전히 독립된 도메인 슬라이스라고 불립니다.

다만 흥미로운 질문은 이것입니다.

그 이름이 아직 무언가를 뜻하고 있습니까?

이 때문에 프론트엔드에 어떤 구체적인 증상이 나타나는지는 별도로 살펴봐야 합니다. 순환 의존성, God Service, 전역 상태, 슬라이스를 가로지르는 의존성, 멀리까지 부작용을 일으키는 변경은 훨씬 자세한 검토가 필요합니다.

뒤에 나올 **「내 프론트엔드도 Big Ball of Mud일까?」**에서 다루겠습니다.

여기서는 먼저 상태를 정의하는 데 집중하겠습니다.

보기 싫은 코드가 모두 Big Ball of Mud는 아닙니다

섹션 제목: “보기 싫은 코드가 모두 Big Ball of Mud는 아닙니다”

이미지가 강렬한 표현인 만큼, 이 개념은 쉽게 너무 넓게 쓰일 수 있습니다.

2천 줄짜리 클래스는 문제가 될 수 있습니다. 경계가 잘못 나뉜 컴포넌트는 큰 비용을 만들 수 있습니다. God Service 하나도 심각한 아키텍처 문제가 될 수 있습니다. 기술 부채는 여러 해 동안 개발을 어렵게 만들 수 있습니다.

하지만 그 어느 하나만으로 시스템 전체를 Big Ball of Mud라고 부르기에 충분하지는 않습니다.

오래되었다는 사실도 충분한 기준이 아닙니다.

오래된 시스템에 이미 시대에 뒤처진 기술 선택이 남아 있어도, 도메인 구조는 훌륭할 수 있습니다. 오랜 시간이 지나도 경계는 여전히 이해할 수 있습니다. 반대로 신생 코드베이스도 짧은 시간 안에 책임과 의존성을 거의 알아볼 수 없는 구조를 만들어 낼 수 있습니다.

규모도 마찬가지입니다.

큰 도메인 모델은 복잡할 수 있습니다. 문제 영역 자체에서 비롯된 복잡성이 곧 아키텍처 오류는 아닙니다. 파일이 수천 개 있는 코드베이스도 명확하게 구성할 수 있고, 훨씬 작은 애플리케이션도 내부 경계를 이미 대부분 잃었을 수 있습니다.

레거시 소프트웨어도 자동으로 Big Ball of Mud가 되는 것은 아닙니다.

레거시 시스템은 낡은 기술과 상당한 기술 부채를 안고 있으면서도, 도메인이 깔끔하게 분리되고 의존성이 안정된 구조를 유지할 수 있습니다.

Big Ball of Mud는 구조적 진단으로 남아야 합니다. 우리가 작업하기 싫은 소프트웨어를 부르는 욕설이 되어서는 안 됩니다.

아키텍처를 이야기할 때 이 개념 대신 놀랄 만큼 자주 등장하는 또 다른 용어에 대해서도 마찬가지입니다.

모놀리스는 Big Ball of Mud가 아닙니다

섹션 제목: “모놀리스는 Big Ball of Mud가 아닙니다”

“안타깝게도 저희는 모놀리스입니다.”

여러 아키텍처 평가에서 조금씩 다른 형태로 들었던 말입니다. 대개는 이 말로 이미 진단이 끝났다는 듯한 어조가 따라옵니다.

하지만 기술적으로 이 문장만으로 내부 아키텍처의 품질에 대해 알 수 있는 것은 놀랄 만큼 적습니다.

시스템 수준에서 모놀리스는 우선 하나의 단위로 개발하고 배포하는 애플리케이션을 뜻합니다. 그 단위의 내부가 어떻게 구성되는지는 대부분 별개의 문제입니다.

모듈형 모놀리스는 명확한 도메인 슬라이스를 두고, 책임을 깔끔하게 나누고, 의존성이 정해진 방향을 따르도록 강제하며, 일관된 레이어와 안정된 내부 인터페이스를 갖출 수 있습니다.

시스템의 외부 경계는 큽니다.

내부 아키텍처 경계까지 클 필요는 없습니다.

배포가 하나라고 구조까지 하나라는 뜻은 아닙니다.

반대로 시스템을 분산한다고 자동으로 더 나은 아키텍처가 되는 것도 아닙니다. 독립적으로 배포하는 부분이 많아도 도메인에서는 촘촘하게 얽혀 있을 수 있습니다. 의존성이 프로세스 안에 있든 기술적 시스템 경계를 넘든, 여전히 순환적이고 암묵적이며 범위를 가늠하기 어려울 수 있습니다.

분산 여부는 아키텍처 품질이 아닙니다. 중앙화 여부도 마찬가지입니다.

더 짧게 말하면 이렇습니다.

‘모놀리스’는 시스템의 형태를 설명합니다. ‘Big Ball of Mud’는 구조적 상태를 설명합니다.

두 특성이 함께 나타날 수는 있습니다. 반드시 그런 것은 아닙니다.

훌륭하게 구조화된 모놀리스도 가능합니다.

하나의 모놀리스로 배포하는 Big Ball of Mud도 가능합니다.

분산 시스템 역시 구조적으로 Big Ball of Mud일 수 있습니다.

배포 토폴로지와 내부 아키텍처의 품질은 서로 다른 축에 놓여 있습니다.

모놀리스와 Big Ball of Mud는 서로 다른 축입니다. 모놀리스와 분산 시스템 모두 명확한 모듈 구조를 갖출 수도, 구조가 침식될 수도 있습니다.

원본 크기로 보기

모놀리스인가 분산 시스템인가, 그리고 내부 구조가 얼마나 잘 작동하는가는 서로 다른 질문입니다.

‘모놀리스’라는 말로 실제로 뜻하는 것

섹션 제목: “‘모놀리스’라는 말로 실제로 뜻하는 것”

이렇게 보면 평가 과정에서 나오는 “안타깝게도 저희는 모놀리스입니다”라는 말이 더 흥미로워집니다.

그 말을 한 사람은 시스템의 외형을 주로 이야기하는 것이 아닐 때가 많기 때문입니다.

몇 가지 질문을 더 하면 ‘모놀리스’라는 말로 다른 것을 뜻했다는 사실이 드러날 수 있습니다. 변경의 부작용을 예측하기 어렵습니다. 도메인 경계는 거의 제 역할을 못 합니다. 어떤 영역까지 영향을 받을지 누구도 확실하게 말하지 못합니다. 특정 인물이 가진 지식 없이는 시스템의 넓은 부분을 안전하게 변경하기 어렵습니다. 도메인 관점에서는 작은 변경도 애플리케이션 곳곳으로 뜻밖에 퍼질 수 있습니다.

이때 ‘모놀리스’는 여러 의미를 압축한 표현이 됩니다.

속이려는 것은 아닙니다. 오히려 그 프로젝트 안에서는 여러 해 동안 겪은 구조적 경험을 대신하는 진단 용어로 자리 잡았을 수 있습니다.

담당자는 이렇게 말합니다.

“저희 시스템은 모놀리스입니다.”

하지만 실제로 뜻하는 바는 이럴 수 있습니다.

이 시스템은 서로 경계가 나뉜 영역으로 더는 분해하기 어렵습니다.

외부 아키텍트는 같은 말을 듣고, 기술적으로 정확하게 이렇게 이해합니다.

이 애플리케이션은 하나의 단위로 개발하고 배포합니다.

두 사람은 같은 단어를 씁니다.

머릿속에 그리는 시스템이 전혀 다를 뿐입니다.

여러 해 동안 그 애플리케이션에서 일한 사람에게 ‘모놀리스’라는 말에는 까다로운 변경, 부작용, 암묵적 의존성에 대한 경험이 모두 담겨 있을 수 있습니다.

외부 평가자에게는 그렇지 않습니다.

복잡한 구조적 상태가 기술적으로는 대체로 중립적인 아키텍처 용어 하나로 바뀝니다.

그 과정에서 놀랄 만큼 많은 정보가 사라질 수 있습니다.

올바른 용어가 잘못된 진단으로 이어질 때

섹션 제목: “올바른 용어가 잘못된 진단으로 이어질 때”

이런 용어의 모호함이 실제 결과를 바꾸지 않는다면, 그저 언어에 관한 짧은 메모로 끝났을 것입니다.

하지만 평가는 거의 언제나 제약 속에서 이루어집니다.

시간도 예산도 한정되어 있습니다. 문서는 불완전합니다. 필요한 사람을 모두 만날 수 있는 것도 아닙니다. 어떤 코드베이스든 며칠 만에 깊이 분석할 수 있는 것은 아닙니다. 때로는 상세한 코드 구조 분석보다 인터뷰, 아키텍처 문서, 조직의 업무 절차에 의도적으로 더 무게를 두기도 합니다.

그런 조건에서 ‘모놀리스’라는 말이 반복되면, 충분히 이해할 수 있는 판단이 나올 수 있습니다.

경험 있는 아키텍트는 모놀리스 자체가 아키텍처 문제는 아니라는 것을 압니다.

그 판단은 전적으로 옳습니다.

다만 정작 중요한 질문에 답하지 못하고 있을 수 있습니다.

저도 평가 과정에서 이런 상황을 겪었습니다.

시스템에 대한 나름의 판단은 이미 있었지만, 의도적으로 다른 관점을 얻고 싶었습니다. 그래서 제 평가를 미리 알리지 않고 Principal Architect에게 검토를 부탁했습니다. 제 편향 없이 시스템을 살펴보기를 바랐습니다.

그 평가의 상당 부분은 참여한 여러 직군과의 인터뷰로 이루어졌습니다. 코드베이스, 특히 실제 의존성 구조에 대한 분석은 훨씬 덜 깊었습니다.

대화에서는 같은 말이 반복해서 나왔습니다.

“모놀리스.”

최종 평가는 대략 이런 취지였습니다.

사실 그렇게 심각하지는 않습니다.

들은 설명만 놓고 보면 이해할 수 있는 평가이기도 했습니다.

모놀리스라는 사실 자체가 구조적 비상사태를 뜻하지는 않으니까요.

하지만 실제 의존성을 더 깊이 살펴보면 전혀 다른 모습이 나타났습니다. 겉으로 보이는 모듈 뒤에는 거대한 순환 영역과 수많은 의존성이 촘촘하게 얽힌 구조가 있었습니다. 대화에서 이야기한 아키텍처는 실제 시스템에서 작용하는 구조를 제한적으로만 설명하고 있었습니다.

이것은 제 개인적인 경험입니다. 인터뷰 중심의 평가가 일반적으로 잘못된 결론을 낸다는 과학적 근거는 아닙니다.

다만 제게는 방법론상의 위험을 매우 선명하게 보여 준 경험이었습니다.

‘모놀리스’가 뜻하지 않게 잘못된 진단이 될 수 있습니다.

그 단어 자체가 틀려서가 아닙니다.

다른 질문에 답하기 때문입니다.

그래서 인터뷰에서 여러 사람이 ‘모놀리스’라고 말하면, 저는 먼저 배포 단위를 더 잘게 나눠야 하는지부터 묻지 않습니다.

더 궁금한 것은 다른 질문들입니다.

  • 시스템 내부의 도메인 경계가 실제로 여전히 제 역할을 합니까?
  • 문서에 적힌 아키텍처와 구현된 아키텍처가 일치합니까?
  • 의존성은 이해할 수 있는 방향을 따릅니까?
  • 책임이 어디에 있는지 명확하게 짚을 수 있습니까?
  • 변경은 예상할 수 있는 경계 안에 머무릅니까?
  • 서로 의존하는 거대한 영역이 있습니까?
  • 겉으로 보이는 구조가 실제로 어떤 부분들이 서로 의존하는지 설명해 줍니까?

이 질문에 답해야 정작 중요한 구분을 할 수 있습니다.

지금 보고 있는 것은 규모가 큰 모듈형 모놀리스입니까?

아니면 마침 하나의 모놀리스로 배포하고 있을 뿐인 Big Ball of Mud입니까?

둘을 같은 것으로 취급하면 하나의 문제는 과소평가하고 다른 하나는 부당하게 평가할 수 있습니다.

Big Ball of Mud는 강한 표현입니다. 그렇기 때문에 신중하게 쓸 가치가 있습니다.

그저 오래된 소프트웨어, 많은 코드, 모놀리스, 기술 부채가 있는 애플리케이션을 뜻하지 않습니다.

구조적 상태를 뜻합니다.

Foote와 Yoder는 이미 1990년대 말에 일관된 설계보다 실용적인 성장을 거치며 구성된 시스템을 설명했습니다. 아키텍처 침식과 설계 침식 연구는 실제 구현된 구조가 원래 의도한 아키텍처에서 점점 멀어질 수 있다는 관찰을 더합니다.

프론트엔드에서 레이어 규칙 하나를 위반했다고 곧 Big Ball of Mud가 된다는 뜻은 아닙니다. 크거나 오랫동안 성장한 애플리케이션이 모두 필연적으로 그 상태에 이른다는 뜻도 아닙니다.

중요한 것은 아키텍처가 아직 구조를 잡아 주는 기능을 수행하느냐입니다.

슬라이스가 여전히 도메인 책임을 제한합니까?

레이어에는 여전히 신뢰할 만한 의미가 있습니까?

의존성을 여전히 이해할 수 있습니까?

시스템에 보이는 구조를 바탕으로 어디를 변경해야 하고 어떤 부분이 영향을 받을 수 있는지 추론할 수 있습니까?

이 질문에 그렇다고 답할 수 있는 확신이 줄어들수록, 아키텍처는 실질적인 의미를 잃습니다.

어느 순간 아키텍처에는 이름표만 남습니다.

그렇다면 Big Ball of Mud가 단순한 모놀리스도 아니고, 처음에는 구조가 명확했던 시스템도 그런 상태에 이를 수 있다면, 당연히 다음 질문이 생깁니다.

누가 만들었습니까?

답은 기대만큼 시원하지 않은 경우가 많습니다.

누군가 아침에 출근해서 오늘은 Big Ball of Mud를 만들겠다고 결정한 것이 아닙니다.

다음 글은 바로 그 이야기입니다.

「누구도 만들려고 하지는 않았다」


Foote, Brian; Yoder, Joseph W.: Big Ball of Mud. 1997년 Fourth Conference on Pattern Languages of Programs(PLoP ’97)에서 최초 발표. 이후 Harrison, Neil; Foote, Brian; Rohnert, Hans(편): Pattern Languages of Program Design 4. Addison-Wesley, 2000에 수록. 원문: https://www.laputan.org/mud/

Li, Ruiyin; Liang, Peng; Soliman, Mohamed; Avgeriou, Paris: Understanding Architecture Erosion: The Practitioners’ Perceptive. IEEE/ACM International Conference on Program Comprehension (ICPC), 2021. DOI: 10.1109/ICPC52881.2021.00037. Preprint: https://arxiv.org/abs/2103.11392

Baum, David; Dietrich, Jens; Anslow, Craig; Müller, Richard: Visualizing Design Erosion: How Big Balls of Mud are Made. IEEE Working Conference on Software Visualization (VISSOFT), 2018, S. 122–126. DOI: 10.1109/VISSOFT.2018.00022. Preprint: https://arxiv.org/abs/1807.06136