Bitbucket Pipelines에서 Yarn v4 (PnP 모드)를 돌리는 설정

Yarn v4의 PnP(Plug’n’Play) 모드는 node_modules 를 사용하지 않는 새로운 패키지 관리 방식이다.

Bitbucket Pipelines에서 Yarn v4 프로젝트를 빌드할 때 필요한 설정을 정리한다.

프로젝트 준비

Yarn v4로 프로젝트를 만든다.

yarn create vite yarn-v4-app --template vanilla-ts

디렉터리로 이동한다.

cd ./yarn-v4-app && pwd

Bitbucket Pipelines 설정

bitbucket-pipelines.yml 을 만든다.

image: node:22.6.0
definitions:
  caches:
    yarn:
      key:
        files:
          - yarn.lock
          - .pnp.cjs
          - .pnp.loader.mjs
      path: ~/.yarn/berry/cache

  scripts:
    - &Init export TZ=Asia/Tokyo && corepack enable
    - &Install yarn install --frozen-lockfile

pipelines:
  custom:
    build-vite:
      - step:
          name: "Build"
          caches:
            - yarn
          script:
            - *Init
            - *Install
            - yarn build

포인트

corepack 활성화: corepack enable 로 Yarn v4를 쓸 수 있게 한다
캐시 설정: yarn.lock, .pnp.cjs, .pnp.loader.mjs 를 키로 캐시를 관리한다
frozen-lockfile: yarn install --frozen-lockfile 로 lockfile 변경을 막는다

정리

Bitbucket Pipelines에서 Yarn v4 PnP 모드를 쓰려면 corepack 활성화와 적절한 캐시 설정이 필요하다.

PnP용 파일인 .pnp.cjs, .pnp.loader.mjs 도 캐시 키에 포함하면 빌드를 더 효율적으로 돌릴 수 있다.