output

Durante una compilación, Next.js rastreará automáticamente cada página y sus dependencias para determinar todos los archivos necesarios para desplegar una versión en producción de tu aplicación.

Esta característica ayuda a reducir drásticamente el tamaño de los despliegues. Anteriormente, al desplegar con Docker necesitabas tener todos los archivos de las dependencies de tu paquete instalados para ejecutar next start. A partir de Next.js 12, puedes aprovechar el Rastreo de Archivos de Salida (Output File Tracing) en el directorio .next/ para incluir solo los archivos necesarios.

Además, esto elimina la necesidad del objetivo obsoleto serverless, que puede causar varios problemas y también crea duplicación innecesaria.

Cómo Funciona

Durante next build, Next.js usará @vercel/nft para analizar estáticamente el uso de import, require y fs para determinar todos los archivos que una página podría cargar.

El servidor de producción de Next.js también es rastreado para sus archivos necesarios y se genera en .next/next-server.js.nft.json, que puede ser aprovechado en producción.

Para aprovechar los archivos .nft.json generados en el directorio de salida .next, puedes leer la lista de archivos en cada rastreo que son relativos al archivo .nft.json y luego copiarlos a tu ubicación de despliegue.

Copia Automática de Archivos Rastreados

Next.js puede crear automáticamente una carpeta standalone que copia solo los archivos necesarios para un despliegue en producción, incluyendo archivos selectos en node_modules.

Para aprovechar esta copia automática, puedes habilitarla en tu next.config.js:

module.exports = {
  output: 'standalone',
}

Esto creará una carpeta en .next/standalone que luego puede ser desplegada por sí misma sin instalar node_modules.

Adicionalmente, también se genera un archivo mínimo server.js que puede usarse en lugar de next start. Este servidor mínimo no copia las carpetas public o .next/static por defecto, ya que idealmente deberían ser manejadas por un CDN, aunque estas carpetas pueden copiarse manualmente a standalone/public y standalone/.next/static, después de lo cual el archivo server.js las servirá automáticamente.

Para copiarlas manualmente, puedes usar la herramienta de línea de comandos cp después de ejecutar next build:

cp -r public .next/standalone/ && cp -r .next/static .next/standalone/.next/

Para iniciar tu archivo mínimo server.js localmente, ejecuta el siguiente comando:

node .next/standalone/server.js

Es bueno saber:

• next.config.js se lee durante next build y se serializa en el archivo de salida server.js. Si se están usando las opciones obsoletas serverRuntimeConfig o publicRuntimeConfig, los valores serán específicos a los valores en el momento de la compilación.
• Si tu proyecto necesita escuchar en un puerto o nombre de host específico, puedes definir las variables de entorno PORT o HOSTNAME antes de ejecutar server.js. Por ejemplo, ejecuta PORT=8080 HOSTNAME=0.0.0.0 node server.js para iniciar el servidor en http://0.0.0.0:8080.

Advertencias

• En configuraciones de monorepos, el directorio del proyecto se usa para el rastreo por defecto. Para next build packages/web-app, packages/web-app sería la raíz del rastreo y cualquier archivo fuera de esa carpeta no será incluido. Para incluir archivos fuera de esta carpeta, puedes configurar outputFileTracingRoot en tu next.config.js.

module.exports = {
  // esto incluye archivos desde la base del monorepo dos directorios arriba
  outputFileTracingRoot: path.join(__dirname, '../../'),
}

• Hay algunos casos en los que Next.js podría fallar al incluir archivos necesarios, o podría incluir incorrectamente archivos no utilizados. En esos casos, puedes usar outputFileTracingExcludes y outputFileTracingIncludes respectivamente en next.config.js. Cada configuración acepta un objeto con globs minimatch para la clave que coincide con páginas específicas y un valor de un array con globs relativos a la raíz del proyecto para incluir o excluir en el rastreo.

module.exports = {
  outputFileTracingExcludes: {
    '/api/hello': ['./un-necessary-folder/**/*'],
  },
  outputFileTracingIncludes: {
    '/api/another': ['./necessary-folder/**/*'],
    '/api/login/\\[\\[\\.\\.\\.slug\\]\\]': [
      './node_modules/aws-crt/dist/bin/**/*',
    ],
  },
}

Nota: La clave de outputFileTracingIncludes/outputFileTracingExcludes es un glob, por lo que los caracteres especiales necesitan ser escapados.

Experimental turbotrace

El rastreo de dependencias puede ser lento porque requiere cálculos y análisis muy complejos. Creamos turbotrace en Rust como una alternativa más rápida e inteligente a la implementación en JavaScript.

Para habilitarlo, puedes añadir la siguiente configuración a tu next.config.js:

module.exports = {
  experimental: {
    turbotrace: {
      // controla el nivel de log de turbotrace, por defecto es `error`
      logLevel?:
      | 'bug'
      | 'fatal'
      | 'error'
      | 'warning'
      | 'hint'
      | 'note'
      | 'suggestions'
      | 'info',
      // controla si el log de turbotrace debe contener detalles del análisis, por defecto es `false`
      logDetail?: boolean
      // muestra todos los mensajes de log sin límite
      // turbotrace solo muestra 1 mensaje por categoría por defecto
      logAll?: boolean
      // controla el directorio de contexto de turbotrace
      // archivos fuera del directorio de contexto no serán rastreados
      // configurar `outputFileTracingRoot` tiene el mismo efecto
      // si ambos `outputFileTracingRoot` y esta opción están configurados, se usará `experimental.turbotrace.contextDirectory`
      contextDirectory?: string
      // si hay expresiones `process.cwd()` en tu código, puedes configurar esta opción para indicarle a `turbotrace` el valor de `process.cwd()` durante el rastreo.
      // por ejemplo, require(process.cwd() + '/package.json') será rastreado como require('/path/to/cwd/package.json')
      processCwd?: string
      // controla el uso máximo de memoria de `turbotrace`, en `MB`, por defecto es `6000`.
      memoryLimit?: number
    },
  },
}