Konfiguration für Yarn v4 (PnP-Modus) in Bitbucket Pipelines

Der PnP-(Plug’n’Play)-Modus von Yarn v4 ist eine neuere Art der Paketverwaltung ohne node_modules.

Hier ist eine kurze Zusammenfassung der Konfiguration, die zum Bauen eines Yarn-v4-Projekts in Bitbucket Pipelines nötig ist.

Projekt vorbereiten

Das Projekt mit Yarn v4 anlegen.

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

Dann in das Verzeichnis wechseln.

cd ./yarn-v4-app && pwd

Bitbucket-Pipelines-Konfiguration

bitbucket-pipelines.yml anlegen.

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

Wichtige Punkte

1. corepack aktivieren: mit corepack enable wird Yarn v4 verfügbar
2. Cache-Konfiguration: Cache anhand von yarn.lock, .pnp.cjs und .pnp.loader.mjs verwalten
3. frozen-lockfile: yarn install --frozen-lockfile verhindert Änderungen an der Lockfile

Zusammenfassung

Um Yarn v4 im PnP-Modus in Bitbucket Pipelines zu verwenden, braucht es eine aktivierte corepack-Umgebung und die passenden Cache-Einstellungen.

Wenn auch die PnP-Dateien .pnp.cjs und .pnp.loader.mjs im Cache-Key enthalten sind, werden die Builds effizienter.