Foundry 저장소의 Node.js 버전

Foundry 코드 저장소는 nvm(Node Version Manager)으로 개발과 CI의 Node 버전을 맞출 수 있습니다. nvm을 사용하지 않으면 CI는 .jemma/settings.sh의 버전, 개발 환경은 18.20.8을 사용합니다.

.nvmrc

저장소 루트에 .nvmrc를 만들고 v로 시작하는 버전 하나를 넣습니다. 다음은 예제 버전이며 프로젝트 패키지가 지원하는 실제 버전을 선택합니다.

v24.13.0

저장소 터미널에서 제공되는 버전을 조회할 수 있습니다.

nvm ls-remote

.nvmrc에 지정한 버전을 설치하고 사용합니다.

nvm install

CI의 같은 버전 사용

.jemma/settings.sh에서 기존 NODE_INSTALLATION_VERSION export를 다음과 같이 바꿉니다. 설정 파일의 위치를 기준으로 부모의 .nvmrc를 읽고 맨 앞의 v만 제거합니다.

NODE_INSTALLATION_VERSION=$(sed 's/^v//' "$(dirname "${BASH_SOURCE[0]}")/../.nvmrc") || return
export NODE_INSTALLATION_VERSION

설정 파일을 불러올 때 .nvmrc를 읽지 못하면 중단합니다. 이후에는 .nvmrc를 바꾸면 개발 환경과 CI가 같은 버전 값을 사용할 수 있습니다. 앱 의존성의 Node 요구 조건도 함께 확인합니다. 브랜치 지원 설정의 템플릿 및 Vite 조건도 Node 버전과 별도로 충족해야 합니다.