ServBay에서 Yarn을 이용한 Node.js 패키지 관리

ServBay는 강력한 로컬 웹 개발 환경으로, Node.js를 기본적으로 지원합니다. Yarn은 Facebook에서 개발한 빠르고 안정적이며 신뢰할 수 있는 패키지 관리 도구로, npm과 유사하지만 더 빠른 의존성 설치 속도, 향상된 오프라인 지원, 더 신뢰도 높은 의존성 해석 기능을 제공합니다. ServBay의 Node.js 환경에서 Yarn을 사용하면 개발자들이 프로젝트 의존성을 더욱 효율적으로 관리할 수 있어 개발 생산성을 높일 수 있습니다.

사전 준비

Yarn을 사용하기 전에, ServBay에 Node.js 패키지가 설치되어 있고 활성화되어 있는지 먼저 확인해 주세요. ServBay의 패키지 관리 기능을 통해 손쉽게 다양한 Node.js 버전을 설치 및 전환할 수 있습니다.

Yarn 설치 및 활성화

ServBay로 설치된 Node.js 패키지에는 일반적으로 Corepack이 포함됩니다. Corepack은 npm, Yarn, pnpm과 같은 Node.js의 패키지 매니저를 관리 및 배포하기 위한 Node.js의 실험적 도구입니다. Corepack은 일반적으로 yarn 명령어를 사용할 수 있도록 해주며, 필요에 따라 특정 Yarn 버전을 설치하는 과정을 안내합니다.

Yarn 설치 여부 확인

Yarn을 사용하기 전에 ServBay 환경에 Yarn이 제대로 설치되어 있는지 확인하세요. 터미널을 열고 다음 명령어를 입력해 Yarn 버전을 확인합니다:

yarn -v

Yarn이 설치되어 있고 시스템 PATH에 포함돼 있다면, 아래와 비슷한 버전 번호가 출력됩니다:

1.22.19

혹은 그 이상의 버전입니다.

Corepack으로 Yarn 설치 또는 업데이트

처음으로 yarn 명령어를 실행할 때, Corepack이 특정 Yarn 버전의 설치가 필요하다고 판단하면 아래와 같은 메시지가 나타날 수 있습니다:

$ yarn -v
! Corepack is about to download https://registry.yarnpkg.com/yarn/-/yarn-1.22.22.tgz
? Do you want to continue? [Y/n]

이 메시지는 Corepack이 지정한 버전의 Yarn을 다운로드하고 설치해도 되는지 묻는 것입니다. Y를 입력하고 Enter키를 누르면 설치가 시작됩니다. 설치가 완료되면 Corepack은 자동으로 설치한 Yarn 버전을 사용하고, 해당 버전의 번호가 출력됩니다:

1.22.22

npm으로 Yarn 수동 설치 또는 업데이트

Corepack 메시지가 나타나지 않거나, npm을 이용해 글로벌 Yarn을 직접 설치 또는 업데이트하고 싶을 때는 다음 명령어를 사용하세요:

npm install -g yarn

이 명령어는 글로벌로 설치된 npm을 활용하여 Yarn 실행 파일을 설치 또는 갱신합니다.

설치(또는 업데이트)가 끝나면 버전 번호를 다시 확인하여 Yarn이 정상적으로 활성화되었는지 확인하세요:

yarn -v

이 과정을 통해 Yarn이 올바르게 설치되고 최신 상태로 업데이트돼서, ServBay 환경에서 문제없이 Node.js 프로젝트를 관리할 수 있습니다.

Yarn의 장점과 핵심 활용법

Yarn의 주요 장점은 빠른 의존성 설치, 뛰어난 오프라인 지원, 보다 신뢰할 수 있는 의존성 해석에 있습니다. 아래에 Yarn의 주요 명령어를 소개합니다:

새 프로젝트 초기화

프로젝트 루트 디렉터리에서 Yarn을 이용해 새 Node.js 프로젝트를 초기화하고 package.json 파일을 만듭니다:

yarn init

이 명령은 프로젝트 정보를 입력하도록 안내하며, 완료 후 package.json 파일이 생성됩니다.

프로젝트 의존성 설치

package.json 파일이 포함된 프로젝트 폴더에서 모든 의존성을 설치하려면 다음을 입력하세요:

yarn install

이 명령은 package.json과 yarn.lock 파일에 명시된 모든 패키지를 node_modules에 설치합니다.

새 의존성 패키지 추가

프로덕션(실제 서비스 환경) 의존성으로 새 패키지를 추가하려면(즉, dependencies에 추가됨):

yarn add lodash

개발용 의존성으로 추가하려면(즉, devDependencies에 추가됨):

yarn add --dev jest

글로벌(전역)으로 패키지를 추가할 경우(권장되지 않으며, 보통 npx나 글로벌 툴 설치를 권장):

yarn global add <package-name>

의존성 패키지 제거

프로젝트에서 특정 의존성 패키지를 제거하려면:

yarn remove lodash

이 명령은 프로젝트에서 lodash 패키지를 삭제하고, package.json 및 yarn.lock을 자동 업데이트합니다.

프로젝트 의존성 업데이트

package.json에 지정된 범위 내에서 모든 의존성 패키지를 최신 버전으로 업데이트하려면:

yarn upgrade

최신 메이저/마이너/패치 버전까지 업데이트하려면 yarn upgrade --latest 또는 yarn-upgrade-all과 같은 툴을 함께 사용할 수 있습니다.

프로젝트 스크립트 실행

Yarn은 package.json의 "scripts" 항목에서 다양한 커스텀 명령어를 정의하고, 이를 쉽게 실행할 수 있게 해줍니다. 예를 들어:

"scripts": {
  "start": "node app.js",
  "test": "jest",
  "build": "webpack --config webpack.config.js"
}

이후 아래 명령을 통해 각각의 스크립트를 실행할 수 있습니다:

yarn start
yarn test
yarn build

기타 자주 쓰는 Yarn 명령어

• 글로벌 패키지 설치:

  yarn global add <package-name>

  예시: 글로벌 create-react-app CLI 설치:

  yarn global add create-react-app

• 글로벌 패키지 목록 확인:

  yarn global list

• 캐시 정리: Yarn은 다운받은 패키지를 캐싱하여 재설치 속도를 높입니다. 캐시 오류가 발생하면 아래와 같이 캐시를 비울 수 있습니다:

  yarn cache clean

  Yarn v2 이상 버전에서는 캐시 정리 명령이 다를 수 있으므로, 해당 버전의 공식 문서를 참고하세요.

요약

ServBay의 Node.js 환경에서 Yarn을 올바르게 설치하고 활용하면, 프로젝트의 의존성 관리 효율성과 안정성이 크게 높아집니다. 새 프로젝트 초기화, 의존성 설치/업데이트, 그리고 커스텀 스크립트 실행까지—Yarn은 빠르고 신뢰할 수 있는 솔루션을 제공하여 현대 Node.js 개발에서 필수 도구로 자리 잡았습니다. ServBay의 편리한 환경에 Yarn의 강력한 기능을 더함으로써, 여러분의 로컬 개발 업무 흐름은 더욱 원활해질 것입니다.