Bundle Without External Packages

Use esbuild with --bundle --minify.

The more dependencies and source files one has, the more impact bundling and minification will have.

esbuild only supports bundling to ESM if the code and all of its dependencies are ESM modules. Otherwise, it has to be bundled as CommonJS, and in that case top-level await is not supported.

Also, minified JavaScript makes debugging production issues harder.

Branch

010-alpine-esbuild

Diff

009-alpine-esbuild-external…​010-alpine-esbuild

Result

Image (MB) Layer Count node Binary (MB) node_modules (MB) Server (B)

Baseline

1740

22

116.0

51.0

2515

Previous

117

17

41.3

10.9

2003

Result

105

16

41.3

0

1325646

 
$ SOURCE_DATE_EPOCH=1 GITHUB_SHA="N/A" scripts/docker_build.sh -p linux/amd64 -t 010-alpine-esbuild -n
...

$ docker images de.sdavids/sdavids-node-docker-image-slimming:010-alpine-esbuild --format "{{.Repository}}\t{{.Tag}}\t{{.Size}}"
de.sdavids/sdavids-node-docker-image-slimming  010-alpine-esbuild   105MB

$ docker run --rm de.sdavids/sdavids-node-docker-image-slimming:010-alpine-esbuild du -hs /usr/bin/node
41.3M /usr/bin/node

$ docker run --rm de.sdavids/sdavids-node-docker-image-slimming:010-alpine-esbuild du -hs /node
1.3M /node

$ docker run --rm de.sdavids/sdavids-node-docker-image-slimming:010-alpine-esbuild stat -c "%s" /node/server.cjs
1325646

$ docker run --rm de.sdavids/sdavids-node-docker-image-slimming:010-alpine-esbuild ls -A /node
healthcheck.mjs
server.cjs
tmp

$ docker image history --format "table {{.Size}}\t{{.CreatedBy}}" de.sdavids/sdavids-node-docker-image-slimming:010-alpine-esbuild
SIZE      CREATED BY
0B        LABEL org.opencontainers.image.licenses=Apac…
0B        HEALTHCHECK &{["CMD-SHELL" "node /node/healt…
0B        CMD ["node" "server.cjs"]
0B        EXPOSE map[3000/tcp:{}]
0B        USER node:node
0B        ENV PORT=3000
0B        ENV NODE_ENV=production
1.34MB    COPY --chown=node:node /node/dist ./ # build…
4.1kB     WORKDIR /node
2.96MB    COPY --chown=node:node /usr/lib/libgcc_s.so.…
43.4MB    COPY --chown=node:node /usr/local/bin/node /…
0B        ENV TMPDIR=/node/tmp
1.44MB    RUN /bin/ash -eo pipefail -c echo "https://d…
0B        SHELL [/bin/ash -eo pipefail -c]
0B        CMD ["/bin/sh"]
8.5MB     ADD alpine-minirootfs-3.21.3-x86_64.tar.gz /…

$ printf 'Layer Count: %s\n' "$(docker history de.sdavids/sdavids-node-docker-image-slimming:010-alpine-esbuild | tail -n +2 | wc -l | tr -d ' ')"
Layer Count: 16

More Information