Configuration pour exécuter Yarn v4 (mode PnP) dans Bitbucket Pipelines

Le mode PnP (Plug’n’Play) de Yarn v4 est une nouvelle manière de gérer les paquets sans utiliser node_modules.

Voici un mémo sur la configuration nécessaire pour construire un projet Yarn v4 dans Bitbucket Pipelines.

Préparer le projet

Créer le projet avec Yarn v4.

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

Se déplacer dans le répertoire.

cd ./yarn-v4-app && pwd

Configuration de Bitbucket Pipelines

Créer 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

Points clés

Activer corepack: corepack enable permet d’utiliser Yarn v4
Configuration du cache: utiliser yarn.lock, .pnp.cjs et .pnp.loader.mjs comme clés de cache
frozen-lockfile: yarn install --frozen-lockfile empêche toute modification du lockfile

Résumé

Pour exécuter Yarn v4 en mode PnP dans Bitbucket Pipelines, il faut activer corepack et régler correctement le cache.

Inclure les fichiers PnP, .pnp.cjs et .pnp.loader.mjs, dans la clé de cache permet d’obtenir des builds plus efficaces.