Corepack

Añadido en: v16.9.0, v14.19.0

[Estable: 1 - Experimental]

Estable: 1 Estabilidad: 1 - Experimental

Corepack es una herramienta experimental para ayudar a gestionar las versiones de tus gestores de paquetes. Expone proxies binarios para cada gestor de paquetes soportado que, cuando se llaman, identificarán qué gestor de paquetes está configurado para el proyecto actual, lo descargarán si es necesario y, finalmente, lo ejecutarán.

A pesar de que Corepack se distribuye con las instalaciones predeterminadas de Node.js, los gestores de paquetes gestionados por Corepack no forman parte de la distribución de Node.js y:

• En el primer uso, Corepack descarga la última versión de la red.
• Cualquier actualización requerida (relacionada con vulnerabilidades de seguridad o de otro tipo) está fuera del alcance del proyecto Node.js. Si es necesario, los usuarios finales deben averiguar cómo actualizar por su cuenta.

Esta característica simplifica dos flujos de trabajo principales:

• Facilita la incorporación de nuevos colaboradores, ya que ya no tendrán que seguir procesos de instalación específicos del sistema solo para tener el gestor de paquetes que deseas que tengan.
• Te permite asegurarte de que todos en tu equipo usarán exactamente la versión del gestor de paquetes que deseas que usen, sin que tengan que sincronizarla manualmente cada vez que necesites hacer una actualización.

Flujos de trabajo

Habilitar la característica

Debido a su estado experimental, Corepack actualmente necesita ser habilitado explícitamente para tener algún efecto. Para ello, ejecuta corepack enable, que configurará los enlaces simbólicos en tu entorno junto al binario node (y sobrescribirá los enlaces simbólicos existentes si es necesario).

A partir de este momento, cualquier llamada a los binarios soportados funcionará sin necesidad de configuración adicional. Si experimentas algún problema, ejecuta corepack disable para eliminar los proxies de tu sistema (y considera la posibilidad de abrir un problema en el repositorio de Corepack para hacérnoslo saber).

Configurando un paquete

Los proxies de Corepack encontrarán el archivo package.json más cercano en la jerarquía de tu directorio actual para extraer su propiedad "packageManager".

Si el valor corresponde a un administrador de paquetes soportado, Corepack se asegurará de que todas las llamadas a los binarios relevantes se ejecuten contra la versión solicitada, descargándola bajo demanda si es necesario y abortando si no se puede recuperar correctamente.

Puedes usar corepack use para pedirle a Corepack que actualice tu package.json local para usar el administrador de paquetes de tu elección:

corepack use  # establece la última versión 7.x en el package.json
corepack use yarn@* # establece la última versión en el package.json

Actualizando las versiones globales

Cuando se ejecuta fuera de un proyecto existente (por ejemplo, al ejecutar yarn init), Corepack utilizará por defecto versiones predefinidas que corresponden aproximadamente a las últimas versiones estables de cada herramienta. Esas versiones se pueden anular ejecutando el comando corepack install junto con la versión del administrador de paquetes que deseas establecer:

corepack install --global

Alternativamente, se puede usar una etiqueta o rango:

corepack install --global pnpm@*
corepack install --global yarn@stable

Flujo de trabajo sin conexión

Muchos entornos de producción no tienen acceso a la red. Dado que Corepack generalmente descarga las versiones del administrador de paquetes directamente desde sus registros, puede entrar en conflicto con dichos entornos. Para evitar que eso suceda, llama al comando corepack pack mientras todavía tienes acceso a la red (normalmente al mismo tiempo que estás preparando tu imagen de despliegue). Esto garantizará que los administradores de paquetes requeridos estén disponibles incluso sin acceso a la red.

El comando pack tiene varias banderas. Consulta la documentación detallada de Corepack para obtener más información.

Administradores de paquetes compatibles

Los siguientes binarios se proporcionan a través de Corepack:

Administrador de paquetes	Nombres de binarios
Yarn	yarn , yarnpkg
pnpm	pnpm , pnpx

Preguntas comunes

¿Cómo interactúa Corepack con npm?

Si bien Corepack podría admitir npm como cualquier otro administrador de paquetes, sus shims no están habilitados de forma predeterminada. Esto tiene algunas consecuencias:

• Siempre es posible ejecutar un comando npm dentro de un proyecto configurado para ser usado con otro administrador de paquetes, ya que Corepack no puede interceptarlo.
• Si bien npm es una opción válida en la propiedad "packageManager", la falta de shim hará que se utilice el npm global.

Ejecutar npm install -g yarn no funciona

npm evita la sobreescritura accidental de los binarios de Corepack al realizar una instalación global. Para evitar este problema, considere una de las siguientes opciones:

• No ejecute este comando; Corepack proporcionará los binarios del administrador de paquetes de todos modos y se asegurará de que las versiones solicitadas estén siempre disponibles, por lo que no es necesario instalar los administradores de paquetes explícitamente.
• Agregue el flag --force a npm install; esto le dirá a npm que está bien sobrescribir binarios, pero borrará los de Corepack en el proceso. (Ejecute corepack enable para agregarlos de nuevo.)