How to prevent instrumentation running during build

[captain-derp]

I'm using the instrumentation.ts to initialize infrastructure services such as message queue and database client. This required fetching passwords from secure secret storage such as Azure KeyVault. However the problem is that instrumentation code is executed during build time inside a docker build environment. This means that the code will not have access to the credentials required to retrieve the passwords from KeyVault.

Why does next.js need to run the instrumentation code?
Is there a way to prevent next.js from running the instrumentation code while building?

Here is my Dockerfile:

FROM node:18-alpine AS base

# Install dependencies only when needed
FROM base AS deps
RUN apk add --no-cache libc6-compat
WORKDIR /app

COPY package.json yarn.lock* package-lock.json* pnpm-lock.yaml* ./
RUN \
  if [ -f yarn.lock ]; then yarn --frozen-lockfile; \
  elif [ -f package-lock.json ]; then npm ci; \
  elif [ -f pnpm-lock.yaml ]; then yarn global add pnpm && pnpm i --frozen-lockfile; \
  else echo "Lockfile not found." && exit 1; \
  fi

FROM base AS builder
WORKDIR /app
COPY --from=deps /app/node_modules ./node_modules
COPY . .

# When running build, next.js executes instrumentation.ts  
RUN yarn build

FROM base AS runner
WORKDIR /app

ENV NODE_ENV production

RUN addgroup --system --gid 1001 nodejs
RUN adduser --system --uid 1001 nextjs

COPY --from=builder /app/public ./public

# Set the correct permission for prerender cache
RUN mkdir .next
RUN chown nextjs:nodejs .next

COPY --from=builder --chown=nextjs:nodejs /app/.next/standalone ./
COPY --from=builder --chown=nextjs:nodejs /app/.next/static ./.next/static

USER nextjs

EXPOSE 80

ENV PORT 80
ENV HOSTNAME "0.0.0.0"

CMD ["node", "server.js"]

[oyatek]

same problem for me

[truediogo]

same here, using instrumentation to validate environment variables at server start and getting error on build, because server variables is not set yet..

[Gregory-Ledray]

I successfully used https://nextjs.org/docs/app/building-your-application/optimizing/instrumentation#importing-runtime-specific-code

export async function register() {
    if (process.env.NEXT_RUNTIME === 'nodejs') {
        // This does NOT run during build
    }
}

[smoothdvd]

not working on nextjs 15

[bytekai]

experiencing same problem