Skip to content

Modern Docker Management, Designed for Everyone

refactor: use Debian Trixie for container builds/runtime (#975)

Kyle Mendell5d58bdde3c93
diff --git a/.github/workflows/e2e-tests.yml b/.github/workflows/e2e-tests.yml
index 57a3d1a59..8e8e16908 100644
--- a/.github/workflows/e2e-tests.yml
+++ b/.github/workflows/e2e-tests.yml
@@ -23,6 +23,7 @@ concurrency:
jobs:
build:
+ name: E2E Tests - Build Image
if: ${{ github.event_name != 'pull_request' || github.head_ref != 'l10n_crowdin' }}
timeout-minutes: 20
permissions:
diff --git a/docker/Dockerfile b/docker/Dockerfile
index 9319d1989..6268d1571 100644
--- a/docker/Dockerfile
+++ b/docker/Dockerfile
@@ -1,11 +1,9 @@
# syntax=docker/dockerfile:1
-
-# Tags passed to "go build"
ARG BUILD_TAGS=""
# Stage 1: Build Frontend
-FROM node:25-alpine AS frontend-builder
-RUN npm install -g --force corepack && corepack enable
+FROM --platform=$BUILDPLATFORM node:25-trixie-slim AS frontend-builder
+RUN npm install -g --force [email protected] && corepack enable
WORKDIR /build
COPY package.json pnpm-workspace.yaml pnpm-lock.yaml ./
COPY frontend/package.json ./frontend/package.json
@@ -16,10 +14,13 @@ ENV BUILD_PATH=dist
RUN pnpm -C frontend build
# Stage 2: Build Backend
-FROM golang:1.25-alpine AS backend-builder
+FROM --platform=$BUILDPLATFORM golang:1.25-trixie AS backend-builder
+ARG TARGETARCH
ARG BUILD_TAGS
WORKDIR /build
-RUN apk add --no-cache ca-certificates curl git tzdata
+
+RUN apt-get update && apt-get install -y --no-install-recommends ca-certificates curl git tzdata \
+&& apt-get clean && rm -rf /var/lib/apt/lists/*
COPY ./.version ./VERSION
COPY ./backend/go.mod ./backend/go.sum ./
@@ -29,7 +30,7 @@ COPY --from=frontend-builder /build/frontend/dist ./frontend/dist
RUN --mount=type=cache,target=/root/.cache/go-build \
VERSION=$(cat VERSION | tr -d '[:space:]') && \
REVISION=$(git rev-parse --short HEAD 2>/dev/null || echo "unknown") && \
- CGO_ENABLED=0 GOOS=linux \
+ CGO_ENABLED=0 GOOS=linux GOARCH=$TARGETARCH \
go build \
-tags "${BUILD_TAGS}" \
-ldflags "-w -s -X github.com/ofkm/arcane-backend/internal/config.Version=${VERSION} -X github.com/ofkm/arcane-backend/internal/config.Revision=${REVISION}" \
@@ -38,22 +39,36 @@ RUN --mount=type=cache,target=/root/.cache/go-build \
./cmd/main.go
# Stage 3: Production Image
-FROM alpine:3 AS runner
+FROM debian:trixie-slim AS runner
+ARG TARGETARCH
ARG VERSION="dev"
ARG REVISION="unknown"
-RUN apk upgrade && apk --no-cache add ca-certificates curl tzdata gcompat
+
+RUN apt-get update && apt-get upgrade -y \
+ && apt-get install -y --no-install-recommends ca-certificates curl tzdata \
+ vainfo clinfo \
+ && if [ "$TARGETARCH" = "amd64" ]; then \
+ apt-get install -y --no-install-recommends intel-gpu-tools; \
+ fi \
+ && apt-get clean && rm -rf /var/lib/apt/lists/*
+
ENV GIN_MODE=release
ENV PORT=3552
ENV ENVIRONMENT=production
-# Multi-distro, multi-arch library path for GPU support
-# Includes paths for: NVIDIA runtime mounts, Debian/Ubuntu (AMD64/ARM64), RHEL/CentOS/Fedora, Arch, and standard fallbacks
-# Covers: NVIDIA GPUs (all distros/architectures), future AMD ROCm support, and Intel GPU support
-ENV LD_LIBRARY_PATH=/usr/local/nvidia/lib:/usr/local/nvidia/lib64:/opt/rocm/lib:/usr/lib/x86_64-linux-gnu:/usr/lib/aarch64-linux-gnu:/usr/lib64:/usr/lib:/lib64:/lib
+ENV NVIDIA_VISIBLE_DEVICES=all \
+ NVIDIA_DRIVER_CAPABILITIES=compute,utility \
+ ROCR_VISIBLE_DEVICES=all \
+ HIP_VISIBLE_DEVICES=all \
+ ONEAPI_DEVICE_SELECTOR=level_zero:*,opencl:* \
+ LD_LIBRARY_PATH=/usr/local/nvidia/lib:/usr/local/nvidia/lib64:/opt/rocm/lib:/opt/intel/oneapi/lib:/opt/intel/oneapi/lib/intel64:/usr/lib/x86_64-linux-gnu:/usr/lib/aarch64-linux-gnu:/usr/lib64:/usr/lib:/lib64:/lib
+
+
WORKDIR /app
RUN mkdir -p /app/data
COPY --from=backend-builder /build/arcane .
EXPOSE 3552
VOLUME ["/app/data"]
+
LABEL org.opencontainers.image.authors="OFKM Technologies" \
org.opencontainers.image.url="https://github.com/getarcaneapp/arcane" \
org.opencontainers.image.documentation="https://github.com/getarcaneapp/arcane/blob/main/README.md" \
@@ -66,4 +81,5 @@ org.opencontainers.image.title="Arcane" \
org.opencontainers.image.description="Modern Docker Management, Made for Everyone" \
com.ofkm.arcane.updater="false" \
com.ofkm.arcane.server="true"
+
CMD ["./arcane"]
\ No newline at end of file
diff --git a/docker/Dockerfile-agent b/docker/Dockerfile-agent
index 52a583f6c..aa34acbe2 100644
--- a/docker/Dockerfile-agent
+++ b/docker/Dockerfile-agent
@@ -1,14 +1,14 @@
# syntax=docker/dockerfile:1
-
-# Build agent binary
ARG VERSION="dev"
ARG REVISION="unknown"
-FROM golang:1.25-alpine AS agent-builder
+FROM --platform=$BUILDPLATFORM golang:1.25-trixie AS agent-builder
+ARG TARGETARCH
ARG BUILD_TAGS="exclude_frontend"
WORKDIR /build
-RUN apk add --no-cache git ca-certificates tzdata curl
+RUN apt-get update && apt-get install -y --no-install-recommends git ca-certificates tzdata curl \
+&& apt-get clean && rm -rf /var/lib/apt/lists/*
COPY ./.version ./VERSION
COPY ./backend/go.mod ./backend/go.sum ./
@@ -20,7 +20,7 @@ WORKDIR /build/backend
RUN --mount=type=cache,target=/root/.cache/go-build \
VERSION=$(cat ../VERSION | tr -d '[:space:]') && \
REVISION=$(git rev-parse --short HEAD 2>/dev/null || echo "unknown") && \
- CGO_ENABLED=0 GOOS=linux \
+ CGO_ENABLED=0 GOOS=linux GOARCH=$TARGETARCH \
go build \
-tags "${BUILD_TAGS}" \
-ldflags "-w -s -X github.com/ofkm/arcane-backend/internal/config.Version=${VERSION} -X github.com/ofkm/arcane-backend/internal/config.Revision=${REVISION}" \
@@ -28,8 +28,15 @@ RUN --mount=type=cache,target=/root/.cache/go-build \
-o /out/arcane-agent \
./cmd/main.go
-FROM alpine:3 AS agent
-RUN apk upgrade && apk --no-cache add ca-certificates tzdata curl gcompat
+FROM debian:trixie-slim AS agent
+ARG TARGETARCH
+RUN apt-get update && apt-get upgrade -y \
+ && apt-get install -y --no-install-recommends ca-certificates curl tzdata \
+ vainfo clinfo \
+ && if [ "$TARGETARCH" = "amd64" ]; then \
+ apt-get install -y --no-install-recommends intel-gpu-tools; \
+ fi \
+ && apt-get clean && rm -rf /var/lib/apt/lists/*
WORKDIR /app
RUN mkdir -p /app/data
@@ -39,10 +46,12 @@ COPY --from=agent-builder /out/arcane-agent /usr/local/bin/arcane-agent
ARG VERSION="dev"
ARG REVISION="unknown"
-# Multi-distro, multi-arch library path for GPU support
-# Includes paths for: NVIDIA runtime mounts, Debian/Ubuntu (AMD64/ARM64), RHEL/CentOS/Fedora, Arch, and standard fallbacks
-# Covers: NVIDIA GPUs (all distros/architectures), future AMD ROCm support, and Intel GPU support
-ENV LD_LIBRARY_PATH=/usr/local/nvidia/lib:/usr/local/nvidia/lib64:/opt/rocm/lib:/usr/lib/x86_64-linux-gnu:/usr/lib/aarch64-linux-gnu:/usr/lib64:/usr/lib:/lib64:/lib
+ENV NVIDIA_VISIBLE_DEVICES=all \
+ NVIDIA_DRIVER_CAPABILITIES=compute,utility \
+ ROCR_VISIBLE_DEVICES=all \
+ HIP_VISIBLE_DEVICES=all \
+ ONEAPI_DEVICE_SELECTOR=level_zero:*,opencl:* \
+ LD_LIBRARY_PATH=/usr/local/nvidia/lib:/usr/local/nvidia/lib64:/opt/rocm/lib:/opt/intel/oneapi/lib:/opt/intel/oneapi/lib/intel64:/usr/lib/x86_64-linux-gnu:/usr/lib/aarch64-linux-gnu:/usr/lib64:/usr/lib:/lib64:/lib
ENV ENVIRONMENT=production \
AGENT_MODE=true \
diff --git a/docker/Dockerfile-agent-static b/docker/Dockerfile-agent-static
index f7f9de1ce..cc9420019 100644
--- a/docker/Dockerfile-agent-static
+++ b/docker/Dockerfile-agent-static
@@ -1,11 +1,11 @@
-FROM alpine:3
+FROM debian:trixie-slim
ARG TARGETARCH
ARG VERSION="dev"
ARG REVISION="unknown"
WORKDIR /app
-RUN apk upgrade && apk --no-cache add ca-certificates tzdata curl gcompat
+RUN apt-get update && apt-get upgrade -y && apt-get install --no-install-recommends -y ca-certificates tzdata curl && rm -rf /var/lib/apt/lists/*
RUN mkdir -p /app/data
COPY ./backend/.bin/arcane-agent-linux-${TARGETARCH} ./arcane-agent
diff --git a/docker/Dockerfile-static b/docker/Dockerfile-static
index 4f20b3781..05aac5fd4 100644
--- a/docker/Dockerfile-static
+++ b/docker/Dockerfile-static
@@ -1,11 +1,11 @@
-FROM alpine:3
+FROM debian:trixie-slim
ARG TARGETARCH
ARG VERSION="dev"
ARG REVISION="unknown"
WORKDIR /app
-RUN apk upgrade && apk --no-cache add ca-certificates tzdata curl gcompat
+RUN apt-get update && apt-get upgrade -y && apt-get install --no-install-recommends -y ca-certificates tzdata curl && rm -rf /var/lib/apt/lists/*
RUN mkdir -p /app/data
COPY ./backend/.bin/arcane-linux-${TARGETARCH} ./arcane
diff --git a/docker/Dockerfile.dev b/docker/Dockerfile.dev
index a143e0ca2..3f6b8fc71 100644
--- a/docker/Dockerfile.dev
+++ b/docker/Dockerfile.dev
@@ -1,4 +1,4 @@
-FROM node:25-alpine AS frontend-dev
+FROM --platform=$BUILDPLATFORM node:25-trixie-slim AS frontend-dev
RUN npm install -g --force corepack && corepack enable
WORKDIR /app
@@ -18,14 +18,15 @@ EXPOSE 3000
CMD ["pnpm", "-C", "frontend", "dev", "--host", "0.0.0.0"]
# Stage 2: Backend Development
-FROM golang:1.25-alpine AS backend-dev
+FROM --platform=$BUILDPLATFORM golang:1.25-trixie AS backend-dev
# Install development tools and dependencies
-RUN apk add --no-cache \
+RUN apt-get update && apt-get install -y \
ca-certificates \
curl \
git \
tzdata && \
+ rm -rf /var/lib/apt/lists/* && \
go install github.com/air-verse/air@latest
# Set development environment variables