generateBuildId

Core Idea

generateBuildId lets you control the build ID Next.js uses to identify which application version is served, needed for consistent IDs across multiple containers built independently per environment stage.

Key Concepts

• generateBuildId: async function in next.config.js returning a string used as the build ID.
• Overridden by deploymentId: when deploymentId is set, Next.js uses a constant build ID and this function has no effect; version skew is detected from the deployment ID instead.

Code Examples

module.exports = {
  generateBuildId: async () => {
    // This could be anything, using the latest git hash
    return process.env.GIT_HASH
  },
}

• O que demonstra: usar o git hash como build ID consistente entre containers.

Key Takeaways

1. Necessário quando você faz rebuild separado por estágio de ambiente mas quer que os containers compartilhem o mesmo build ID.
2. Se deploymentId estiver configurado, essa função é ignorada.

Connects To

• deploymentId: config que substitui/anula esta função quando presente.