mirror of
https://github.com/Studio-Saelix/sencho.git
synced 2026-07-28 12:49:03 +00:00
278f7f18d9
- Add docker/setup-qemu-action@v3 to docker-publish.yml (was missing, causing multi-platform builds to hang indefinitely) - Add platforms: linux/amd64,linux/arm64 to build-push-action step - Optimize Dockerfile with --platform=$BUILDPLATFORM on builder stages so TypeScript compilation runs at native amd64 speed; only the lean npm ci --omit=dev step runs under QEMU in the final stage, compiling the three native modules (bcrypt, better-sqlite3, node-pty) for the correct target architecture — reduces arm64 build time from 6+ hours to ~15-30 minutes
112 lines
4.3 KiB
Docker
112 lines
4.3 KiB
Docker
# Stage 1: Build Frontend
|
|
# Run on the BUILD platform (amd64 on GitHub Actions) — frontend has no native
|
|
# modules so the compiled output is platform-agnostic JS/CSS/HTML.
|
|
FROM --platform=$BUILDPLATFORM node:20-alpine AS frontend-builder
|
|
|
|
WORKDIR /app/frontend
|
|
|
|
# Copy frontend package files
|
|
COPY frontend/package*.json ./
|
|
|
|
# Install dependencies
|
|
RUN npm config set fetch-retry-maxtimeout 120000 && \
|
|
npm config set fetch-retries 5 && \
|
|
npm install
|
|
|
|
# Copy frontend source
|
|
COPY frontend/ ./
|
|
|
|
# Build frontend
|
|
RUN npm run build
|
|
|
|
# Stage 2: Build Backend (TypeScript compilation only)
|
|
# Run on the BUILD platform (amd64) so tsc runs at native speed.
|
|
# Native modules (bcrypt, better-sqlite3, node-pty) are intentionally NOT
|
|
# copied to the final image — they are re-installed on the TARGET platform
|
|
# in Stage 3 so the correct architecture binaries are produced.
|
|
FROM --platform=$BUILDPLATFORM node:20-alpine AS backend-builder
|
|
|
|
WORKDIR /app/backend
|
|
|
|
# Install build dependencies for node-pty native modules
|
|
RUN apk add --no-cache python3 make g++
|
|
|
|
# Copy backend package files
|
|
COPY backend/package*.json ./
|
|
|
|
# Install dependencies
|
|
RUN npm config set fetch-retry-maxtimeout 120000 && \
|
|
npm config set fetch-retries 5 && \
|
|
npm install
|
|
|
|
# Copy backend source
|
|
COPY backend/ ./
|
|
|
|
# Build backend
|
|
RUN npm run build
|
|
|
|
# Stage 3: Production
|
|
# Runs on the TARGET platform (e.g. linux/arm64 via QEMU on amd64 runners).
|
|
# We minimise QEMU-emulated work to a single lean `npm ci --omit=dev` which
|
|
# compiles only the three native production modules (bcrypt, better-sqlite3,
|
|
# node-pty) for the correct architecture. Build tooling is removed afterwards
|
|
# to keep the image small.
|
|
FROM node:20-alpine
|
|
|
|
# Install Docker CLI, Docker Compose CLI, and Bash for Host Console
|
|
RUN apk add --no-cache docker-cli docker-cli-compose bash su-exec
|
|
|
|
WORKDIR /app
|
|
|
|
# Install production dependencies on the TARGET platform so native modules
|
|
# (bcrypt, better-sqlite3, node-pty) are compiled for the right architecture.
|
|
# Build tools are added, used, then removed in a single RUN layer.
|
|
COPY backend/package*.json ./
|
|
RUN apk add --no-cache python3 make g++ && \
|
|
npm ci --omit=dev && \
|
|
apk del python3 make g++
|
|
|
|
# Copy compiled TypeScript output from the backend builder (platform-agnostic JS)
|
|
COPY --from=backend-builder /app/backend/dist ./dist
|
|
|
|
# Copy built frontend from frontend-builder to public folder
|
|
COPY --from=frontend-builder /app/frontend/dist ./public
|
|
|
|
# Set environment to production
|
|
ENV NODE_ENV=production
|
|
|
|
# Create a non-root user and ensure the data/compose directories are writable.
|
|
# The actual volume paths are mounted at runtime, so we only pre-create the
|
|
# default data dir here; the compose dir is user-supplied via COMPOSE_DIR.
|
|
RUN addgroup -S sencho && adduser -S -G sencho sencho \
|
|
&& mkdir -p /app/data \
|
|
&& chown -R sencho:sencho /app
|
|
|
|
# Copy the entrypoint script that fixes data-volume ownership at startup and
|
|
# then drops privileges to the sencho user via su-exec (the idiomatic Alpine
|
|
# equivalent of gosu). This mirrors the pattern used by official Docker images
|
|
# such as PostgreSQL, Redis, and MariaDB.
|
|
#
|
|
# NOTE: USER directive is intentionally absent here. The entrypoint starts as
|
|
# root so it can chown the mounted data volume, then exec's as sencho. Static
|
|
# security scanners (Trivy, Clair) may flag "running as root" — this is a known
|
|
# and accepted trade-off for self-hosted apps with user-supplied volume mounts.
|
|
COPY docker-entrypoint.sh /usr/local/bin/docker-entrypoint.sh
|
|
# Strip Windows CRLF line endings that can sneak in on Windows dev machines
|
|
# even with .gitattributes eol=lf, then make executable. A shell script with
|
|
# \r in tokens like "fi\r" will fail with "unexpected end of file" in Alpine.
|
|
RUN sed -i 's/\r//' /usr/local/bin/docker-entrypoint.sh \
|
|
&& chmod +x /usr/local/bin/docker-entrypoint.sh
|
|
|
|
# Expose port
|
|
EXPOSE 3000
|
|
|
|
# Health check — polls the public /api/health endpoint every 30s
|
|
HEALTHCHECK --interval=30s --timeout=5s --start-period=15s --retries=3 \
|
|
CMD node -e "const h=require('http');h.get('http://localhost:3000/api/health',r=>{process.exit(r.statusCode===200?0:1)}).on('error',()=>process.exit(1))"
|
|
|
|
# Entrypoint fixes volume ownership as root then drops to sencho via su-exec.
|
|
# CMD provides the default arguments passed through to the entrypoint.
|
|
ENTRYPOINT ["/usr/local/bin/docker-entrypoint.sh"]
|
|
CMD ["node", "dist/index.js"]
|