
Codegram 코드로 관리하는 지속 가능한 데이터베이스 모델링 & Release Manager를 통한 솔루션 버전관리
설계부터 사이트 패치까지: Codegram과 Release Manager로 변경을 관리하는 방법
데이터베이스 설계와 솔루션 배포는 서로 다른 작업이지만, 변경이 쌓인 뒤에는 같은 질문을 마주합니다. 지금 어떤 상태이며, 이전 상태에서 무엇이 달라졌는가? ERD가 실제 DB와 달라지면 설계 문서를 신뢰하기 어렵고, 사이트별 패치 이력이 남지 않으면 다음 배포의 출발점을 확인하기 어렵습니다.
Codegram과 Release Manager는 이 문제를 각자의 영역에서 다룹니다. Codegram은 스키마를 코드로 정의하고 ERD와 실제 DB 구조를 비교합니다. Release Manager는 InfraEye의 제품 변경분을 버전으로 등록하고, 사이트의 현재 버전에서 목표 버전까지 필요한 패치를 구성하며 이력을 남깁니다. 두 제품이 직접 연동된다는 의미는 아닙니다. 설계와 배포의 변경을 확인 가능한 데이터로 관리한다는 공통된 접근입니다.
구분 | Codegram | Release Manager |
|---|---|---|
관리 대상 | 스키마 정의, ERD, 실제 DB와의 차이 | 제품 버전, 빌드버전, 패치, 사이트 이력 |
핵심 질문 | 모델과 현재 DB가 어디서 다른가? | 특정 사이트에 무엇이 어디까지 반영됐는가? |
작업의 출발점 | DBML 코드 또는 실제 DB 구조 | 사이트의 현재 버전( |
결과 | 공유 가능한 ERD·정의서·DDL | 목표 버전( |
데이터베이스 설계를 관리하는 Codegram
DBML 코드로 ERD 생성 · 실제 DB와 비교 · 팀 공유
데이터베이스 모델이 실제 구조에서 멀어지는 이유
마우스로 그리는 도구의 세 가지 문제 — 그리는 건 한 번, 바뀌는 건 계속입니다
⚠ 그리기도 번거롭고, 협업 및 공유도 어렵고, 실제 DB와 맞추는 일까지 사람이 직접 해야 합니다.
# | 문제 | 설명 | 예시 |
|---|---|---|---|
01 | 그리기가 번거롭다 | 테이블을 하나하나 마우스로 놓고 연결선도 직접 맞춤. 조금만 바뀌어도 손이 많이 감 | ERwin 같은 설치형 ERD 툴 |
02 | 협업이 어렵다 | 모델 파일을 보내고 상대가 열어야 확인 가능. 함께 고치거나 누가 바꿨는지 알기 어려움 | 내 PC 파일을 메신저로 전달 |
03 | 실제 DB와 달라진다 | 처음에는 같지만 DB만 바뀌고 모델은 그대로 남아, 결국 모델을 믿을 수 없게 됨 | DB에만 추가된 컬럼 |
결론 — 문제는 그리는 도구가 아니라, 바뀐 내용을 따라가지 못하는 방식입니다.
Codegram이 하는 일
코드로 정의하는 데이터 모델링 · ERD 자동 생성 툴 — 스키마를 코드로 쓰면, ERD가 그려집니다
DBML 계열 문법으로 작성한 스키마 정의를 파싱해 ERD(Entity-Relationship Diagram)를 자동 렌더링하고, DDL까지 내보낼 수 있는 웹 기반 데이터 모델링 툴입니다.
# | 항목 | 핵심 | 설명 |
|---|---|---|---|
01 | Codegram이란? | 코드가 곧 스키마의 단일 진실 공급원(SSOT) | 텍스트 기반 스키마 정의 코드를 파싱해 엔티티 · 속성 · 관계(카디널리티)를 ERD로 자동 생성하는 데이터 모델링 툴 |
02 | 왜 만들었나? | 스키마 변경을 코드 리뷰처럼 협업 | HawkEye 프로젝트의 유연하고 확장성 있는 데이터베이스를 팀이 함께 설계하기 위해 개발 |
03 | 기존 툴의 한계 | 무료는 부족하고, 충분한 건 유료 | DBML 문법으로 ERD를 생성하는 서비스는 있지만 기능이 제한적이고, 실무에서 쓸 만한 모델링 툴은 대부분 유료 |
정리 — 팀이 코드로 함께 설계하고, ERD는 도구가 그리게 만든 것이 Codegram입니다.
Codegram의 핵심 기능
DBML 코드로 ERD를 만들고, 실제 DB와 자동으로 맞춰주는 모델링 툴
# | 기능 | 설명 |
|---|---|---|
01 | DBML 코드로 ERD 생성 | 코드로 테이블과 관계를 쓰면 ERD가 자동으로 그려짐. 찾아 바꾸기로 한꺼번에 수정 가능 |
02 | 웹에서 공유하며 협업 | 설치 없이 브라우저에서 프로젝트를 만들고, 다른 계정에 공유해 같은 모델을 함께 확인 |
03 | 실제 DB를 읽어 자동 생성 | 접속 정보만 넣으면 현재 DB 구조를 읽어 ERD를 만들고, 달라진 점도 찾아 반영 |
04 | 다양한 내보내기 | ERD 그림, 테이블 정의서, SQL을 Excel · PDF · PNG로 내보내 제출 문서로 바로 사용 |
flowchart LR
A[코드로 만들고] --> B[공유하고] --> C[실제 DB와 맞추고] --> D[내보내기]네 기능은 "코드로 만들고 → 공유하고 → 실제 DB와 맞추고 → 내보내는" 하나의 흐름입니다.
DBML로 ERD 정의하기
마우스로 그리지 않고, 코드를 쓰면 ERD가 그려집니다
schema.dbml
Table users {
id bigint [pk, increment]
email varchar(255) [unique, not null]
team_id bigint [ref: > teams.id]
created_at timestamp [default: now()]
}
Table teams {
id bigint [pk]
name varchar(100) [not null]
tier varchar(20) [note: "plan tier"]
}장점 | 설명 |
|---|---|
누가 바꿨는지 이력이 남는다 | 버전 관리와 리뷰가 그대로 가능 |
한꺼번에 고치기 쉽다 | 이름 규칙 변경, 공통 컬럼 추가를 찾아 바꾸기로 처리 |
ERD는 자동으로 그려진다 | 코드를 저장하면 ERD가 그려짐 |
모델과 실제 DB 비교하기
DB 접속 정보만 넣으면 지금 DB 구조로 ERD를 만들고, 달라진 점만 반영합니다
단계 | 작업 | 내용 |
|---|---|---|
STEP 1 | 접속 정보 입력 | DB 접속정보를 입력 |
STEP 2 | DB 구조 읽기 | 테이블 · 컬럼 · 키를 읽어서 ERD 생성 |
STEP 3 | 기존 ERD와 비교 | 무엇이 추가 · 변경 · 삭제되었는지 찾아냄 |
STEP 4 | 변경 반영 | 달라진 부분만 프로젝트에 자동 반영 |
flowchart LR
A["STEP 1<br/>접속 정보 입력"] --> B["STEP 2<br/>DB 구조 읽기"] --> C["STEP 3<br/>기존 ERD와 비교"] --> D["STEP 4<br/>변경 반영"]찾아낸 변경 (예시)
+ users.last_login timestamp (컬럼 추가)
+ idx_users_team ON users(team_id) (인덱스 추가)
~ teams.name varchar(100) → varchar(200) (컬럼 변경)
- users.legacy_flag (컬럼 삭제)범례:
+추가 ·~변경 ·-삭제
이렇게 편해집니다
실제 DB와 비교해 찾아낸 변경을 반영하면 ERD를 현행 구조에 맞출 수 있습니다
배포 전에 예상하지 못한 DB 변경을 미리 발견합니다
테이블 정의서를 매번 다시 쓸 필요가 없습니다
개발 DB와 운영 DB의 차이를 바로 비교합니다
언제 바뀌었는지 기록이 남습니다
모델 공유와 산출물 내보내기
파일을 주고받을 필요 없이 같은 ERD를 보며, 필요한 문서는 내보내기로 생성합니다
웹에서 공유하며 협업
브라우저만 있으면 설치 없이 시작합니다
프로젝트를 만들어 다른 계정에 공유합니다
같은 ERD를 함께 보며 검토하고 수정합니다
누가 언제 바꿨는지 기록이 남습니다
저장 및 복원으로 안전하게 예전 상태로 돌아갈 수 있습니다.
필요한 형식으로 내보내기
산출물 | 형식 |
|---|---|
ERD 그림 | PNG · PDF |
테이블 정의서 | Excel · PDF |
생성 SQL(DDL) | SQL 스크립트 |
현행 기준의 문서를 만들 수 있습니다 — 실제 DB와 비교한 변경을 모델에 반영한 뒤 내보내면, 공유 화면과 산출물을 갱신된 모델 기준으로 제공할 수 있습니다.
Codegram에서 확인할 수 있는 것
Codegram의 작업 흐름은 코드로 만들고 → 웹에서 공유하고 → 실제 DB와 비교하고 → 필요한 형식으로 내보내는 것입니다. DBML 코드와 ERD를 기준으로 설계를 검토할 수 있으며, 실제 DB를 읽어 차이를 확인한 뒤 모델에 반영할 수 있습니다. 배포 전 구조를 점검하거나 개발 DB와 운영 DB의 차이를 살펴볼 때도 같은 흐름을 사용할 수 있습니다.
여기까지가 데이터베이스 설계와 현행 구조의 관리라면, 다음은 솔루션 변경을 버전과 사이트별 패치 이력으로 관리하는 이야기입니다.
릴리즈를 관리하는 Release Manager
변경분을 버전으로 등록하고,
from→to패치를 생성하며, 사이트별 적용 이력을 기록
InfraEye의 기존 패치 구성 방식
패치가 만들어지고 사이트에 반영되는 현재 절차입니다.
빌드 파일 — Web · Engine
Web 빌드는 공유서버, Engine 빌드는 노션에 보관
프리징 버전별 폴더에
war·webobject.tar최신 파일을 덮어쓰며 등록패치 담당자가 각 위치에서 직접 내려받아 전달
DB 변경사항 — 쿼리 파일
패치할 다수의 쿼리 파일이 존재
변경 쿼리를 적절한 파일에 이어서 작성하는 누적 형태
패치 시 전체 쿼리를 재실행
패치 구성: 최신 빌드 파일과 여러 누적 쿼리 파일을 담당자가 직접 모아 패치본을 구성
기존 방식에서 반복된 문제
관리 부재가 만들어내는 악순환 — 버전 개념이 없어 사이트의 상태를 알 수 없다
⚠ 관리가 느슨했던 사이트는 최신 버전 패치 시 이슈가 집중되고, 이를 피해 부분 패치를 택하면 사이트마다 제품 상태가 갈라진다.
# | 문제 | 설명 |
|---|---|---|
01 | 패치 생성 시 혼란 | 생성한 쿼리를 어느 경로 · 어느 파일에 추가해야 하는지 불명확 |
02 | 패치본 비대화 | 불필요한 쿼리 파일까지 포함되어 용량 증가 · 중복 수행 |
03 | 부분 패치의 부작용 | 사이트별 제품 상태가 갈라져 이후 패치 난이도 상승 |
근본 원인 — 누가 무엇을 어디까지 패치했는지 데이터로 남지 않는다
Release Manager가 하는 일
버전 · 패치를 관리하는 릴리즈 관리 서비스
솔루션의 변경내역을 버전으로 관리하고, 패치를 만들어주는 서비스입니다.
개발자가 변경한 내용을 버전으로 등록하면, Release Manager가 from(현 사이트 버전) → to(목표 최신 버전) 사이의 변경 내용을 파악해 패치본을 자동 생성하고, 어떤 사이트에 무엇이 반영됐는지 이력으로 남깁니다.
# | 기능 | 설명 |
|---|---|---|
01 | 버전 관리 | 제품 변경분(소스코드 · DB 쿼리 · config 등)을 버전 단위로 등록 · 추적 |
02 | 패치 자동 생성 |
|
03 | 사이트 이력 관리 | 사이트별 현재 버전과 패치 이력을 데이터로 조회 |
Why? 기존 InfraEye 솔루션의 패치 관리 방식의 문제를 해결하기 위해
Release Manager의 네 가지 핵심 개념
버전과 패치의 개념을 분리하고, 사이트를 데이터로 관리한다
# | 개념 | 설명 |
|---|---|---|
01 | 버전 | 제품 최신 상태에서 내가 변경한 부분(DB 쿼리, config 등)만 버전으로 생성 |
02 | 빌드버전 | Web · Engine 빌드 파일. 수시로 생성되므로 버전과 분리해 관리 |
03 | 패치 |
|
04 | 사이트 | 사이트를 데이터로 관리하며 패치 이력과 현재 버전 상태를 기록 |
버전 등록부터 사이트 반영까지
단계 | 작업 | 형식 / 내용 |
|---|---|---|
STEP 1 | 버전 생성 |
|
STEP 2 | 빌드버전 생성 |
|
STEP 3 | 패치 생성 |
|
STEP 4 | 사이트 반영 · 기록 | 패치 이력 · 현 버전 상태 저장 |
flowchart LR
A["STEP 1<br/>버전 생성<br/>x.y.z"] --> B["STEP 2<br/>빌드버전 생성<br/>x.y.z-260917-n"]
B --> C["STEP 3<br/>패치 생성<br/>from → to 자동 생성"]
C --> D["STEP 4<br/>사이트 반영·기록<br/>이력·현 버전 저장"]버전은 시맨틱 버저닝(
x.y.z), 빌드버전은 최신 버전 기준x.y.z-yymmdd-n형태로 생성 → 수시로 발생하는 빌드 버전을 버전과 분리하여 버전 폭주를 예방한다.
Release Manager 도입으로 달라지는 점
기존 패치 방식<br/>(기억과 수작업에 의존) | Release Manager<br/>(데이터로 관리되는 버전 · 패치) |
|---|---|
✗ 버전 개념 없음 — 사이트 상태 불명 | ✓ 변경분만 버전으로 생성 — 간편 |
✗ 패치본 수동 구성 — 누락 위험 | ✓ 패치 자동 생성 — 수동 구성에 따른 누락 위험 감소 |
✗ 누적 쿼리 일괄 수행 — 중복 · 내용 파악 어려움 | ✓ 필요한 변경 쿼리만 수행 — 경량 패치 · 파악 쉬움 |
✗ 이력은 담당자 기억에 의존 — 패치 오류 가능성 증가 | ✓ 패치 이력 데이터로 관리 — 사이트 상태 파악 가능 |
✗ 부분 패치로 사이트 상태 분화 | ✓ 모든 사이트가 동일 기준으로 관리 |
Release Manager에서 확인할 수 있는 것
Release Manager는 제품 변경분 등록 → 빌드버전 관리 → 패치 생성 → 사이트 반영·기록의 흐름을 제공합니다. 사이트별 현재 버전이 기록되어 있어야 from을 정확히 지정할 수 있고, 실제 적용 결과를 남겨야 다음 패치의 출발점도 확인할 수 있습니다. 패치 자동 생성은 구성 과정의 수작업을 줄이지만, 적용 성공 여부와 사이트 상태는 반영 이후 확인하고 기록해야 합니다.
스키마 변경부터 사이트 반영 이력까지
두 제품은 서로 다른 변경을 기록합니다. Codegram은 DB 스키마의 설계·현행 상태를, Release Manager는 솔루션 변경분의 배포·현장 적용 상태를 다룹니다. 예를 들어 DB 컬럼이 변경되면 Codegram에서 모델과 실제 DB의 차이를 검토할 수 있습니다. 그 변경을 InfraEye 배포에 포함해야 한다면 Release Manager에 관련 DB 쿼리와 설정 변경을 버전으로 등록하고, 사이트별 현재 버전에 맞는 패치를 생성할 수 있습니다. 이 과정은 각 도구의 역할을 연결해 설명한 예시이며, 두 제품 간 자동 연동 기능을 뜻하지는 않습니다.
변경 단계 | 확인할 질문 | 담당하는 정보 |
|---|---|---|
설계 | 어떤 테이블·컬럼·관계를 정의했는가? | Codegram의 DBML 코드와 ERD |
현행 확인 | 실제 DB와 모델은 어디서 다른가? | Codegram의 DB 구조 비교 결과 |
릴리즈 준비 | 이번 제품 버전에 어떤 변경이 들어갔는가? | Release Manager의 버전·빌드버전 |
현장 반영 | 이 사이트는 어디까지 패치됐는가? | Release Manager의 사이트 버전·패치 이력 |
실무 적용 흐름 예시
두 도구의 역할은 다음과 같은 흐름으로 구체적으로 살펴볼 수 있습니다.
Codegram에서 DBML 코드를 수정하고 ERD의 테이블·관계 변화를 확인합니다.
실제 DB 구조를 읽어 기존 모델과 추가·변경·삭제 항목을 비교합니다.
모델을 공유하고 ERD 그림·테이블 정의서·DDL 중 필요한 산출물을 내보냅니다.
Release Manager에서 제품 변경분을 버전으로 등록하고 Web·Engine 빌드버전을 구분합니다.
한 사이트의
from버전과 목표to버전을 지정해 패치본을 생성합니다.사이트 반영 후 현재 버전과 패치 이력을 조회합니다.
결론: 변경을 파일 위치나 담당자의 기억에만 맡기면 다음 작업의 출발점을 확인하는 데 시간이 듭니다. Codegram은 모델과 실제 DB의 차이를, Release Manager는 제품 버전과 사이트 적용 상태를 드러냅니다. 두 도구의 공통 가치는 변경을 다음 사람이 다시 확인할 수 있는 형태로 남기는 데 있습니다.


