meldestelle/dockerfiles/clients/web-app/Dockerfile
2025-08-17 00:15:29 +02:00

170 lines
6.0 KiB
Docker

# ===================================================================
# Dockerfile for Meldestelle Web Application
# Based on kotlin-multiplatform-web template
# ===================================================================
# Build arguments
ARG GRADLE_VERSION=8.14
ARG JAVA_VERSION=21
ARG NGINX_VERSION=alpine
ARG NODE_VERSION=20.11.0
# Client-specific build arguments (parametrized for better maintainability)
ARG CLIENT_PATH=client/web-app
ARG CLIENT_MODULE=client:web-app
# ===================================================================
# Build Stage - Kotlin/JS Compilation
# ===================================================================
FROM gradle:${GRADLE_VERSION}-jdk${JAVA_VERSION}-alpine AS kotlin-builder
# Re-declare build arguments for kotlin-builder stage
ARG CLIENT_PATH=client/web-app
ARG CLIENT_MODULE=client:web-app
ARG NODE_VERSION=20.11.0
LABEL stage=kotlin-builder
LABEL service=web-app
LABEL maintainer="Meldestelle Development Team"
WORKDIR /workspace
# Install specific Node.js version for Kotlin/JS compatibility
RUN apk add --no-cache wget ca-certificates && \
wget -q -O - https://unofficial-builds.nodejs.org/download/release/v${NODE_VERSION}/node-v${NODE_VERSION}-linux-x64-musl.tar.xz | \
tar -xJ -C /usr/local --strip-components=1 && \
apk del wget ca-certificates && \
rm -rf /var/cache/apk/* && \
npm config set cache /tmp/.npm-cache && \
npm config set progress false && \
npm config set audit false
# Gradle optimizations for Kotlin Multiplatform builds
ENV GRADLE_OPTS="-Dorg.gradle.caching=true \
-Dorg.gradle.daemon=false \
-Dorg.gradle.parallel=true \
-Dorg.gradle.configureondemand=true \
-Dorg.gradle.jvmargs=-Xmx3g \
-Dkotlin.compiler.execution.strategy=in-process"
# Kotlin/JS and Node.js environment variables
ENV NODE_OPTIONS="--max-old-space-size=4096" \
NPM_CONFIG_CACHE="/tmp/.npm-cache" \
KOTLIN_JS_GENERATE_EXTERNALS=false
# Copy build configuration files first for optimal Docker layer caching
COPY gradlew gradlew.bat gradle.properties settings.gradle.kts ./
COPY gradle/ gradle/
COPY build.gradle.kts ./
# Copy platform and core dependencies (changes less frequently)
COPY platform/ platform/
COPY core/ core/
# Copy client modules in dependency order for optimal caching
COPY client/common-ui/ client/common-ui/
COPY ${CLIENT_PATH}/ ${CLIENT_PATH}/
# Clear npm cache and verify Node.js installation
RUN npm cache clean --force && \
node --version && npm --version
# Download and cache dependencies in a separate layer
RUN ./gradlew :${CLIENT_MODULE}:dependencies --no-daemon --info --stacktrace
# Build web application with production optimizations and better error handling
RUN ./gradlew :${CLIENT_MODULE}:jsBrowserProductionWebpack --no-daemon --info --stacktrace --debug
# Verify build output
RUN ls -la /workspace/${CLIENT_PATH}/build/dist/ || (echo "Build failed - no dist directory found" && exit 1)
# ===================================================================
# Production Stage - Nginx serving
# ===================================================================
FROM nginx:${NGINX_VERSION} AS runtime
# Re-declare build arguments for runtime stage
ARG CLIENT_PATH=client/web-app
ARG CLIENT_MODULE=client:web-app
ARG GRADLE_VERSION=8.14
ARG JAVA_VERSION=21
ARG NGINX_VERSION=alpine
# Comprehensive metadata
LABEL service="web-app" \
version="1.0.0" \
description="Meldestelle Web Application - Kotlin Multiplatform Client" \
maintainer="Meldestelle Development Team" \
build.gradle.version="${GRADLE_VERSION}" \
java.version="${JAVA_VERSION}" \
nginx.version="${NGINX_VERSION}"
# Security and system setup
RUN apk update && \
apk upgrade && \
apk add --no-cache curl jq && \
rm -rf /var/cache/apk/*
# Remove default nginx content and logs
RUN rm -rf /usr/share/nginx/html/* && \
rm -f /var/log/nginx/*.log
# Copy built web application from builder stage
COPY --from=kotlin-builder /workspace/${CLIENT_PATH}/build/dist/ /usr/share/nginx/html/
# Copy optimized nginx configuration
COPY ${CLIENT_PATH}/nginx.conf /etc/nginx/nginx.conf
# Set proper permissions for nginx
RUN chown -R nginx:nginx /usr/share/nginx/html /var/cache/nginx /var/run /var/log/nginx && \
chmod -R 755 /usr/share/nginx/html
# Switch to nginx user for security
USER nginx
# Health check specifically for the web application
HEALTHCHECK --interval=30s --timeout=5s --start-period=15s --retries=3 \
CMD curl -f http://localhost/health || exit 1
# Expose HTTP port
EXPOSE 80
# Start nginx with proper signal handling for graceful shutdowns
STOPSIGNAL SIGQUIT
# Run nginx in foreground with error handling
CMD ["sh", "-c", "nginx -t && exec nginx -g 'daemon off;'"]
# ===================================================================
# Build and Usage Instructions
# ===================================================================
# Build with default parameters:
# docker build -t meldestelle/web-app:latest -f dockerfiles/clients/web-app/Dockerfile .
#
# Build with custom parameters:
# docker build -t meldestelle/web-app:latest \
# --build-arg NODE_VERSION=20.11.0 \
# --build-arg CLIENT_PATH=client/web-app \
# --build-arg CLIENT_MODULE=client:web-app \
# -f dockerfiles/clients/web-app/Dockerfile .
#
# Run standalone:
# docker run -p 3001:80 --name web-app meldestelle/web-app:latest
#
# Run with API backend:
# docker run -p 3001:80 --link api-gateway:api-gateway --name web-app meldestelle/web-app:latest
#
# Access application:
# http://localhost:3001
# http://localhost:3001/health (health check)
#
# Development with hot-reload (use docker-compose.override.yml instead)
#
# Optimization improvements:
# - Added Node.js v20.11.0 for optimal Kotlin/JS compatibility
# - Parametrized build arguments for better maintainability
# - Enhanced npm and Node.js environment variables
# - Improved error handling with --stacktrace and --debug flags
# - npm cache management for better performance
# ===================================================================