오프라인 환경(폐쇄망)에서 Yarn으로 npm 패키지 설치

오프라인 환경(폐쇄망)에서 프로젝트 진행 시 npm은 온라인에서 패키지를 받아오는데, 인터넷이 안되는 환경에서는 패키지를 설치할 수 없다. node_modules 폴더를 가져올 수는 있지만 크기가 매우 크다. 이러한 문제를 해결하기 위한 방법들 중 하나인 yarn offline mirror를 소개한다.

 

1.  요약

1. yarn을 이용하여 패키지를 설치한다.
2. 설치된 패키지들을 tar.gz으로 묶는다.
3. tar.gz들을 오프라인 PC로 옮기고 yarn install 한다.

 

---

 

2.  외부망 작업

1) yarn 설치 및 기존 패키지 삭제

yarn을 설치하고, npm으로 설치해서 사용했던 패키지들을 삭제한다.

 

// yarn 설치
$ npm install yarn

// node_modules 삭제
$ rm -rf node_modules

// yarn.lock 삭제
$ rm -rf yarn.lock

// yarn 캐시 삭제
$ yarn cache clean

 

2) 프로젝트 홈 경로에 .yarnrc 파일 생성

프로젝트 홈 경로(node_modules와 같은 위치)에 .yarnrc 파일을 생성하고 파일에 아래 코드를 넣는다.

 

yarn-offline-mirror "./npm_packages"
yarn-offline-mirror-pruning true

 

• yarn-offline-mirror: 압축된 .tgz 파일들이 들어갈 폴더
• yarn-offline-mirror-pruning: 업데이트된 패키지 추가 시 yarn cache를 먼저 확인 후, 없는 dependency를 가져온다.

3) yarn으로 패키지 설치

$ yarn install

 

아래와 같이 npm_packages 폴더가 생성되고, 해당 폴더 아래에 *.tgz 파일들이 저장된다.

그리고 yarn.lock 파일도 새로 생성된다.

 

4) 내부망 PC로 이관

오프라인 환경으로 가져갈 파일들을 usb에 담는다.

node_modules를 제외한

• npm_packages
• .yarnrc
• yarn.lock
• package.json
• 작성한 코드 파일

파일들을 가져가면 된다.

 

 

---

 

3. 내부망 작업

1) node, yarn 설치

내부망에 node와 yarn이 설치되어있지 않다면 node와 yarn 설치 파일도 옮겨서 설치해야 한다.

내부망에서 node와 yarn 설치 방법은 아래 게시글을 참조한다.

 

오프라인 환경(폐쇄망) node, yarn 설치

 

2) yarn으로 패키지 설치

프로젝트 홈 경로로 이동한 뒤에 아래 명령어를 터미널에 입력하여 패키지들을 설치한다.

$ yarn install --offline

 

---

 

4. 패키지가 추가된 경우

1) 외부망 작업

(1) node_modules, npm_packages, yarn.lock 파일 삭제

(2) yarn으로 패키지 설치

$ yarn install

  

(3) 위에서 작업한 것처럼 새로 만든 파일들을 usb에 담아서 옮긴다.

 

2) 내부망 작업

(1) 프로젝트의 node_modules를 삭제한다.

(2) 아래 명령어를 통해 yarn으로 패키지를 다시 설치한다.

$ yarn install --offline