Refactor Dockerfiles to optimize build stages and reduce image sizes; update README with usage instructions and optimization details.

Author: MuhammadQadora

Dockerfile.debian

@@ -1,9 +1,47 @@
+# Build stage - contains all build tools and dependencies
+FROM debian:bookworm-slim as builder
+
+# Install build dependencies in a single layer and clean up
+RUN apt-get update -y && \
+    apt-get install -y --no-install-recommends \
+        build-essential \
+        cmake \
+        m4 \
+        automake \
+        peg \
+        libtool \
+        autoconf \
+        python3 \
+        python3-pip \
+        git \
+        lcov \
+        openssl \
+        libssl-dev \
+        curl \
+        ca-certificates && \
+    # Install rust
+    curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh -s -- -y && \
+    # Clean up package cache to reduce image size
+    apt-get clean && \
+    rm -rf /var/lib/apt/lists/* /tmp/* /var/tmp/*
+
+# Add rust to path
+ENV PATH="/root/.cargo/bin:${PATH}"
+
+# Final runtime stage - smaller base with only runtime dependencies
 FROM debian:bookworm-slim
 
-RUN apt-get update -y && apt-get install -y build-essential cmake m4 automake peg libtool autoconf python3 python3-pip git peg lcov openssl libssl-dev curl
+# Install only runtime dependencies
+RUN apt-get update -y && \
+    apt-get install -y --no-install-recommends \
+        python3 \
+        openssl \
+        ca-certificates && \
+    apt-get clean && \
+    rm -rf /var/lib/apt/lists/* /tmp/* /var/tmp/*
 
-# install rust
-RUN curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh -s -- -y
+# Copy rust installation from builder stage
+COPY --from=builder /root/.cargo /root/.cargo
 
-# add rust to path
+# Add rust to path
 ENV PATH="/root/.cargo/bin:${PATH}"

Dockerfile.rhel

@@ -1,28 +1,72 @@
+# Build stage - contains all build tools and dependencies
 FROM redhat/ubi9 as builder
 
+# Install build dependencies and tools in optimized layers
 RUN yum update -y && \
-  yum install -y wget autoconf automake python3.11 python3.11-pip libtool git make openssl-devel gcc gcc-c++ libstdc++-static diffutils cmake3 && \
-  alternatives --install /usr/bin/python3 python3 /usr/bin/python3.11 1 && \
-  alternatives --auto python3
+    yum install -y \
+        wget \
+        autoconf \
+        automake \
+        python3.11 \
+        python3.11-pip \
+        libtool \
+        git \
+        make \
+        openssl-devel \
+        gcc \
+        gcc-c++ \
+        libstdc++-static \
+        diffutils \
+        cmake3 \
+        curl && \
+    alternatives --install /usr/bin/python3 python3 /usr/bin/python3.11 1 && \
+    alternatives --auto python3 && \
+    # Install rust
+    curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh -s -- -y && \
+    # Clean up package cache
+    yum clean all && \
+    rm -rf /var/cache/yum /tmp/* /var/tmp/*
 
-# install rust
-RUN curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh -s -- -y
-
-# add rust to path
+# Add rust to path
 ENV PATH="/root/.cargo/bin:${PATH}"
 
-# install leg/geg
+# Install peg in a separate layer to enable better caching
 RUN wget https://www.piumarta.com/software/peg/peg-0.1.19.tar.gz && \
-  tar -xzvf peg-0.1.19.tar.gz && \
-  cd peg-0.1.19 && \
-  make && \
-  make install && \
-  cd ..
+    tar -xzvf peg-0.1.19.tar.gz && \
+    cd peg-0.1.19 && \
+    make && \
+    make install && \
+    cd .. && \
+    rm -rf peg-0.1.19*
 
-# install redis
+# Install redis in a separate layer to enable better caching
 RUN wget https://download.redis.io/redis-stable.tar.gz && \
-  tar -xzvf redis-stable.tar.gz && \
-  cd redis-stable && \
-  make && \
-  make install && \
-  cd ..
+    tar -xzvf redis-stable.tar.gz && \
+    cd redis-stable && \
+    make && \
+    make install && \
+    cd .. && \
+    rm -rf redis-stable*
+
+# Final runtime stage - smaller base with only runtime dependencies
+FROM redhat/ubi9
+
+# Install only runtime dependencies
+RUN yum update -y && \
+    yum install -y \
+        python3.11 \
+        openssl && \
+    alternatives --install /usr/bin/python3 python3 /usr/bin/python3.11 1 && \
+    alternatives --auto python3 && \
+    yum clean all && \
+    rm -rf /var/cache/yum /tmp/* /var/tmp/*
+
+# Copy rust installation from builder stage
+COPY --from=builder /root/.cargo /root/.cargo
+
+# Copy installed binaries from builder stage
+COPY --from=builder /usr/local/bin/peg /usr/local/bin/
+COPY --from=builder /usr/local/bin/redis-* /usr/local/bin/
+
+# Add rust to path
+ENV PATH="/root/.cargo/bin:${PATH}"

Dockerfile.ubuntu

@@ -1,9 +1,53 @@
+# Build stage - contains all build tools and dependencies
 FROM ubuntu:22.04 as builder
 
-RUN apt-get update -y && apt-get install -y curl build-essential cmake m4 automake peg libtool autoconf python3 python3-pip git lcov openssl libssl-dev
+# Prevent interactive prompts during package installation
+ENV DEBIAN_FRONTEND=noninteractive
 
-# install rust
-RUN curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh -s -- -y
+# Install build dependencies in a single layer and clean up
+RUN apt-get update -y && \
+    apt-get install -y --no-install-recommends \
+        curl \
+        build-essential \
+        cmake \
+        m4 \
+        automake \
+        peg \
+        libtool \
+        autoconf \
+        python3 \
+        python3-pip \
+        git \
+        lcov \
+        openssl \
+        libssl-dev \
+        ca-certificates && \
+    # Install rust
+    curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh -s -- -y && \
+    # Clean up package cache to reduce image size
+    apt-get clean && \
+    rm -rf /var/lib/apt/lists/* /tmp/* /var/tmp/*
 
-# add rust to path
+# Add rust to path
+ENV PATH="/root/.cargo/bin:${PATH}"
+
+# Final runtime stage - smaller base with only runtime dependencies
+FROM ubuntu:22.04
+
+# Prevent interactive prompts during package installation
+ENV DEBIAN_FRONTEND=noninteractive
+
+# Install only runtime dependencies
+RUN apt-get update -y && \
+    apt-get install -y --no-install-recommends \
+        python3 \
+        openssl \
+        ca-certificates && \
+    apt-get clean && \
+    rm -rf /var/lib/apt/lists/* /tmp/* /var/tmp/*
+
+# Copy rust installation from builder stage
+COPY --from=builder /root/.cargo /root/.cargo
+
+# Add rust to path
 ENV PATH="/root/.cargo/bin:${PATH}"

README.md

@@ -1,2 +1,37 @@
 # build-image
 FalkorDB Docker build image
+
+## Overview
+This repository contains optimized Docker build images for FalkorDB development across different Linux distributions.
+
+## Available Images
+- **Debian** (`Dockerfile.debian`) - Based on Debian Bookworm Slim
+- **Ubuntu** (`Dockerfile.ubuntu`) - Based on Ubuntu 22.04  
+- **RHEL** (`Dockerfile.rhel`) - Based on Red Hat UBI 9
+
+## Optimizations
+All Dockerfiles use multi-stage builds to significantly reduce final image size:
+
+1. **Build Stage**: Contains all development tools, compilers, and build dependencies
+2. **Runtime Stage**: Contains only essential runtime dependencies and compiled artifacts
+
+### Key optimization features:
+- Multi-stage builds to separate build and runtime dependencies
+- Consolidated RUN commands to reduce layers
+- Package cache cleanup to minimize image size
+- `--no-install-recommends` flag to avoid unnecessary packages
+- Proper copying of only required binaries and installations from build stage
+
+## Usage
+Build an image for your target distribution:
+
+```bash
+# Debian
+docker build -f Dockerfile.debian -t falkordb-build:debian .
+
+# Ubuntu  
+docker build -f Dockerfile.ubuntu -t falkordb-build:ubuntu .
+
+# RHEL
+docker build -f Dockerfile.rhel -t falkordb-build:rhel .
+```