Node.js용 Yarn 패키지 매니저를 설치하고 사용하는 방법

소개

Yarn은 속도, 보안 및 일관성에 중점을 둔 Node.js용 패키지 관리자입니다. 처음에는 인기 있는 NPM 패키지 관리자의 일부 문제를 해결하기 위해 만들어졌습니다. 그러나 성능과 기능 측면에서 두 패키지 관리자가 수렴한 후에도 Yarn은 특히 React 개발 세계에서 여전히 인기가 있습니다.

Yarn의 몇 가지 독특한 기능은 다음과 같습니다:

• A per-project caching mechanism, that can greatly speed up subsequent installs and builds
• 설치된 라이브러리의 구조가 항상 동일한 일관된, 결정적인 설치
• 모든 패키지의 체크섬 테스트를 통해 그들의 무결성을 확인
• “작업 공간”은 단일 소스 코드 저장소에서 여러 프로젝트를 개발하는 모나레포(monorepo)에서 Yarn을 사용하기 쉽게 합니다.

이 자습서에서는 Yarn을 전역으로 설치하고, 특정 프로젝트에 Yarn을 추가하고, 몇 가지 기본적인 Yarn 명령어를 배우게 됩니다.

Node.js용 Yarn 패키지 관리자 설치 및 사용하기

1. Yarn 전역으로 설치하기
2. 프로젝트에 Yarn 설치하기
3. Yarn 사용하기

전제 조건

Yarn 패키지 관리자를 설치하고 사용하기 전에 Node.js가 설치되어 있어야 합니다. 이미 Node.js가 설치되어 있는지 확인하려면 다음 명령을 로컬 명령 줄 터미널에 입력하십시오:

node -v

버전 번호가 표시되면 v12.16.3과 같이, Node.js가 설치되어 있는 것입니다. command not found 오류(또는 유사한 문구)가 표시되면 계속하기 전에 Node.js를 설치하십시오.

Node.js를 설치하려면 Ubuntu, Debian, CentOS, 또는 macOS에 대한 튜토리얼을 따르십시오.

Node.js를 설치한 후에는 Yarn 패키지 매니저를 설치하기 위해 단계 1로 진행하십시오.

단계 1 — Yarn 전역 설치

Yarn은 자바스크립트 프로젝트에 고유한 방식으로 자신을 설치하고 실행합니다. 먼저 전역으로 yarn 명령어를 설치한 다음, 전역 yarn 명령어를 사용하여 프로젝트 디렉토리에 특정 로컬 버전의 Yarn을 설치합니다. 이것은 프로젝트에 참여하는 모든 사람(및 모든 프로젝트의 자동화된 테스트 및 배포 도구)이 yarn의 동일한 버전을 실행하도록 하여 일관된 동작 및 결과를 보장하기 위해 필요합니다.Yarn 유지 관리자는 모든 Node.js 설치에 기본으로 포함되어 있는 NPM 패키지 매니저를 사용하여 Yarn을 전역으로 설치하는 것을 권장합니다. 이를 위해 npm install과 함께 -g 플래그를 사용하십시오:

Yarn 관리자들은 Yarn을 전역적으로 설치하기 위해 NPM 패키지 관리자를 사용하는 것을 권장합니다. 모든 Node.js 설치에 기본적으로 포함되어 있습니다. -g 플래그와 함께 npm install을 사용하여 이 작업을 수행합니다:

sudo npm install -g yarn

패키지가 설치된 후 yarn 명령어가 자신의 버전 번호를 인쇄하게 하십시오. 이렇게 하면 제대로 설치되었는지 확인할 수 있습니다:

yarn --version

Output
1.22.11

이제 전역적으로 yarn 명령을 설치했으므로 JavaScript 프로젝트에 Yarn을 설치하는 데 사용할 수 있습니다.

2단계 – 프로젝트에 Yarn 설치

기존 Yarn 기반 프로젝트에 Yarn을 사용하고 있는 경우 이 단계를 건너뛸 수 있습니다. 프로젝트는 이미 Yarn의 로컬 버전과 사용하는 데 필요한 모든 구성 파일로 설정되어 있어야 합니다.

자신의 새 프로젝트를 설정하는 경우 프로젝트별 Yarn 버전을 구성하려고 합니다.

먼저 프로젝트 디렉토리로 이동하십시오:

cd ~/my-project

프로젝트 디렉토리가 없는 경우 mkdir을 사용하여 새 디렉토리를 만든 다음 이동할 수 있습니다:

mkdir my-project
cd my-project

이제 yarn set 명령을 사용하여 berry 버전을 설정하십시오:

yarn set version berry

이렇게 하면 프로젝트의 .yarn/releases/ 디렉토리에 현재 활발하게 개발 중인 Yarn 버전인 berry를 다운로드하고 .yarnrc.yml 구성 파일도 설정됩니다.

Output
Resolving berry to a url...
Downloading https://github.com/yarnpkg/berry/raw/master/packages/berry-cli/bin/berry.js...
Saving it into /home/sammy/my-project/.yarn/releases/yarn-berry.cjs...
Updating /home/sammy/my-project/.yarnrc.yml...
Done!

이제 다시 yarn --version 명령어를 시도해보세요:

yarn --version

Output
3.0.0

버전이 3.0.0 이상인 것을 볼 수 있을 것입니다. 이것은 Yarn의 최신 릴리스입니다.

이제 프로젝트는 프로젝트별 Yarn 버전으로 설정되었습니다. 다음으로, 시작하기 위해 몇 가지 일반적으로 사용되는 yarn 명령어를 살펴보겠습니다.

Yarn 사용하기

Yarn은 많은 서브 명령어를 가지고 있지만, 시작하기에 필요한 것은 몇 가지뿐입니다. 먼저 사용할 서브 명령어를 살펴보겠습니다.

도움말 얻기

어떤 새로운 도구를 시작할 때, 온라인 도움말에 접근하는 방법을 배우는 것은 유용합니다. Yarn에서는 --help 플래그를 어떤 명령어에도 추가하여 더 많은 정보를 얻을 수 있습니다:

yarn --help

이것은 yarn 명령어의 전반적인 도움말을 출력합니다. 서브명령에 대한 보다 구체적인 정보를 얻으려면 서브명령 뒤에 --help를 추가하세요:

yarn install --help

이것은 yarn install 명령어의 사용 방법에 대한 세부 정보를 출력합니다.

새로운 Yarn 프로젝트 시작

새로운 프로젝트를 시작할 때, init 서브명령을 사용하여 필요한 Yarn 특정 파일을 생성하세요:

yarn init

이것은 package.json 구성 파일과 yarn.lock 파일을 디렉토리에 추가합니다. package.json은 구성과 모듈 의존성 목록을 포함합니다. yarn.lock 파일은 잠금을 통해 항상 일관된 의존성 트리를 보장하는 특정 버전의 의존성을 설정합니다.

프로젝트의 모든 의존성 설치

기존의 Yarn 기반 프로젝트에서 모든 의존성을 다운로드하고 설치하려면 install 서브명령을 사용하세요:

yarn install

이것은 시작하기 위해 필요한 모듈을 다운로드하고 설치합니다.

프로젝트에 새 의존성 추가

새 의존성을 프로젝트에 추가하려면 add 하위 명령어를 사용하세요:

yarn add package-name

이렇게 하면 모듈을 다운로드하고, 설치하며, package.json 및 yarn.lock 파일을 업데이트합니다.

Yarn을 위해 .gitignore 파일 업데이트

Yarn은 프로젝트 디렉토리 내에 .yarn 폴더에 파일을 저장합니다. 이 중 일부 파일은 버전 관리에 포함되어야 하고 다른 파일은 무시되어야 합니다. Yarn에 대한 기본 .gitignore 구성은 다음과 같습니다:

.yarn/*
!.yarn/patches
!.yarn/releases
!.yarn/plugins
!.yarn/sdks
!.yarn/versions
.pnp.*

이는 전체 .yarn 디렉토리를 무시한 다음 중요한 폴더인 releases 디렉토리를 포함하여 몇 가지 예외를 추가합니다. 여기에는 프로젝트별 Yarn 버전이 포함됩니다.

Git과 Yarn을 구성하는 방법에 대한 자세한 내용은 .gitignore에 대한 공식 Yarn 문서를 참조하세요.

결론

이 튜토리얼에서는 Yarn을 설치하고 몇 가지 yarn 하위 명령어에 대해 배웠습니다. Yarn 사용에 대한 자세한 내용은 공식 Yarn CLI 문서를 참조하세요.

일반적인 Node.js 및 JavaScript 도움말에 대해서는 Node.js 및 JavaScript 태그 페이지를 방문하여 관련 튜토리얼, 기술 강연 및 커뮤니티 Q&A를 찾아보십시오.