Dockerfile

ARG deploy_base_image="nginx:1.27.0-alpine"
ARG build_base_image="node:18.19.0-alpine3.19"

# Use an intermediary image to do our builds, removing coupling from the machine executing commands and allowing us to
# trim the fat.
FROM $build_base_image AS builder

WORKDIR /opt/build

# Install Git if lastUpdated is enabled
RUN apk update && apk add git

# Copy in dependency resolution files.
COPY package*.json ./

# Install NPM dependencies. Execute this before copy to ensure that caching occurs.
RUN npm ci

# Copy in docs folder to build from.
COPY docs ./docs

# Build the site into static js/html.
RUN npm run docs:build


FROM $deploy_base_image

# Destroy the old html folder contents to avoid confusion.
RUN rm -rf /usr/share/nginx/html/*

# Copy in the required files we built in the previous image.
# Only the Dist folder is required as everything is compiled into there on build.
COPY --from=builder /opt/build/docs/.vitepress/dist /usr/share/nginx/html

# Copy in our configuration, which is applied on startup.
COPY ./deployment/server.conf /etc/nginx/conf.d/server.conf

# We serve on http and https.
EXPOSE 80 443

# Start nginx with a global parameter specifying that we wish to follow the process.
# This is required as a docker container is a single running process, so if nginx crashes we also want the container
# to turn off, allowing us to view that it's no longer working.
ENTRYPOINT ["nginx", "-g", "daemon off;"]