Configuração para rodar Yarn v4 (modo PnP) no Bitbucket Pipelines

O modo PnP (Plug’n’Play) do Yarn v4 é uma forma mais nova de gerenciar pacotes sem usar node_modules.

Aqui fica um resumo da configuração necessária para fazer build de um projeto Yarn v4 no Bitbucket Pipelines.

Preparação do projeto

Crie o projeto com Yarn v4.

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

Entre no diretório.

cd ./yarn-v4-app && pwd

Configuração do Bitbucket Pipelines

Crie 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

Pontos

Ativar corepack: use corepack enable para disponibilizar o Yarn v4
Configuração de cache: gerencie o cache com yarn.lock, .pnp.cjs e .pnp.loader.mjs como chave
frozen-lockfile: use yarn install --frozen-lockfile para impedir mudanças no lockfile

Resumo

Para rodar Yarn v4 em modo PnP no Bitbucket Pipelines, é necessário ativar o corepack e definir o cache corretamente.

Incluir os arquivos PnP, .pnp.cjs e .pnp.loader.mjs, na chave de cache ajuda a deixar os builds mais eficientes.