KimSeogyu.github.io

Trunk-Based Development

트렁크 기반 개발은 개발자들이 trunk라고 부르는 단일 브랜치에서 공동 작업을 수행하는 소스 제어 브랜칭 모델이며, 수명이 긴 다른 개발 브랜치를 생성하지 않기 위한 방법입니다. 그러므로 이 방법을 사용하면 병합지옥을 피하고 빌드를 깨지 않을 수 있습니다.

트렁크 기반 개발의 Good or Bad Practice

Shared branches off mainline/main/trunk are bad at any release cadence

Trunk-Based Development For Smaller Teams

Scaled Trunk-Based Development

정리

개발자들은 피쳐브랜치에서 작업한 뒤 Trunk (or main) 브랜치로 병합하고, 릴리즈가 진행될떄 릴리즈 버전을 명시한 브랜치를 분기한다. 이때 분기된 브랜치에는 추가적인 커밋을 하지 않으며, 변경사항은 다음 릴리즈에 반영한다. 이런 작업 방식에서 서로 다른 버전에서 반영되어야할 사항이 main 브랜치에 공존하는 상황이 있을 수 있는데, 이를 통제하기 위해 기능 별 플래그처리를 사용하는 것이 좋다. 이 내용을 공식 사이트에서는 다음과 같이 소개하고 있다. 링크

NodeJS에서 플래그 처리를 어떻게 하는게 좋을까?

package.json의 버전을 적극적으로 사용하는게 어떨까 싶다. semver를 사용하고 있다면, release 버전을 부버전까지는 고정시켜 놓고 수버전을 올리면서 패치를 하게 될텐데, 한 릴리즈에서의 모든 기능을 보장한다면 플래그 처리를 부버전까지를 검사하는 것으로 할 수 있다.

아래는 v2.5.x 릴리즈를 하는 경우의 예시이다

const version = process.env.npm_package_version || '100'

if (version.startsWith('2.5')) {
   someCode();
}

if (Number(version) > 2.5) {
   runAnotherCode();
}
...

NodeJS에서 버전을 가져오는 방법

1. package.json의 version을 가져오는 것 다만 참조한 스택오버플로우 답변에도 적혀있듯이, 브라우저에서 사용할 시엔 package.json의 내용을 클라이언트에서 참조할 수 있으므로 NodeJS를 활용한 서버에서만 활용하는게 좋을 듯 하다.

   // You need to set resolveJsonModule true in tsconfig.json
   import { version } from './package.json'
   console.log(`version = ${version}`)
   console.log(`Is flag enabled? ${version.startsWith('2.5')}`)
   // version = 1.0.0
   // Is flag enabled? false
   

2. process 환경변수에서 가져오는 것 만약 NodeJS 애플리케이션이 npm 등의 패키지 매니저로 시작되었다면 아래와 같이 가져올 수 있다.

   // run npm start
   const version = process.env.npm_package_version
   console.log(`version = ${version}`)
   console.log(
   	`Is flag enabled? ${version?.startsWith('2.5') ?? 'version is undefined'}`,
   )
   // version = 1.0.0
   // Is flag enabled? false
   

물론 버전을 통한 플래그 처리를 하기 위해서는 철저한 package.json 관리가 필요하다.

Ref

• 트렁크기반개발
• semver
• is-there-a-way-to-get-version-from-package-json-in-nodejs-code