.docker/
├── alpine/                    # Alpine Linux variants
│   ├── Dockerfile.prebuild    # Alpine + pre-built binaries
│   └── Dockerfile.source      # Alpine + source compilation
├── ubuntu/                    # Ubuntu variants
│   ├── Dockerfile.prebuild    # Ubuntu + pre-built binaries
│   ├── Dockerfile.source      # Ubuntu + source compilation
│   └── Dockerfile.dev         # Ubuntu + development environment
└── cargo.config.toml         # Rust cargo configuration

🎯 Image Variants

Production Images

Variant	Base OS	Build Method	Size	Use Case
`production` (default)	Alpine 3.18	Pre-built	Smallest	Production deployment
`alpine`	Alpine 3.18	Pre-built	Small	Explicit Alpine choice
`alpine-source`	Alpine 3.18	Source build	Small	Custom Alpine builds
`ubuntu`	Ubuntu 22.04	Pre-built	Medium	Ubuntu environments
`ubuntu-source`	Ubuntu 22.04	Source build	Medium	Full Ubuntu compatibility

Development Images

Variant	Base OS	Features	Use Case
`ubuntu-dev`	Ubuntu 22.04	Full toolchain + dev tools	Interactive development

🚀 Usage Examples

Quick Start (Production)

# Default production image (Alpine + pre-built)
docker run -p 9000:9000 rustfs/rustfs:latest

# Specific version with production variant
docker run -p 9000:9000 rustfs/rustfs:1.2.3-production

# Explicit Alpine variant
docker run -p 9000:9000 rustfs/rustfs:latest-alpine

# Ubuntu-based production
docker run -p 9000:9000 rustfs/rustfs:latest-ubuntu

Complete Tag Strategy Examples

# Stable Releases
docker run rustfs/rustfs:1.2.3                # Main version (production)
docker run rustfs/rustfs:1.2.3-production     # Explicit production variant
docker run rustfs/rustfs:1.2.3-alpine         # Explicit Alpine variant
docker run rustfs/rustfs:1.2.3-alpine-source  # Alpine source build
docker run rustfs/rustfs:latest               # Latest stable

# Prerelease Versions
docker run rustfs/rustfs:1.3.0-alpha.2        # Specific alpha version
docker run rustfs/rustfs:1.3.0-alpha.2-alpine # Alpha with Alpine
docker run rustfs/rustfs:alpha                # Latest alpha
docker run rustfs/rustfs:beta                 # Latest beta
docker run rustfs/rustfs:rc                   # Latest release candidate

# Development Versions
docker run rustfs/rustfs:dev                  # Latest development
docker run rustfs/rustfs:dev-13e4a0b          # Specific commit
docker run rustfs/rustfs:dev-alpine           # Development Alpine

Development Environment

# Start development container
docker run -it -v $(pwd):/app -p 9000:9000 rustfs/rustfs:latest-ubuntu-dev

# Inside container:
cd /app
cargo build --release
cargo run

🏗️ Build Arguments

All images support dynamic version selection:

# Build with specific version
docker build \
  --build-arg VERSION="1.0.0" \
  --build-arg BUILD_TYPE="release" \
  -f .docker/alpine/Dockerfile.prebuild \
  -t rustfs:1.0.0-alpine .

🌐 Multi-Platform Support

All images support multiple architectures:

linux/amd64 (Intel/AMD 64-bit)
linux/arm64 (ARM 64-bit, Apple Silicon, etc.)

⚡ Build Speed Optimizations

Docker Build Optimizations

Multi-layer caching: GitHub Actions cache + Registry cache
Parallel matrix builds: All 5 variants build simultaneously
Multi-platform builds: amd64/arm64 built in parallel
BuildKit features: Advanced caching and inline cache

Rust Compilation Optimizations

sccache: Distributed compilation cache for Rust builds
Parallel compilation: Uses all available CPU cores (-j $(nproc))
Optimized cargo config: Sparse registry protocol, fast linker (lld)
Dependency caching: Separate Docker layers for dependencies vs. source code
Release optimizations: LTO, strip symbols, optimized codegen

Cache Strategy

# GitHub Actions cache
cache-from: type=gha,scope=docker-{variant}
cache-to: type=gha,mode=max,scope=docker-{variant}

# Registry cache (persistent across runs)
cache-from: type=registry,ref=ghcr.io/rustfs/rustfs:buildcache-{variant}
cache-to: type=registry,ref=ghcr.io/rustfs/rustfs:buildcache-{variant}

Build Performance Comparison

Build Type	Time (Est.)	Cache Hit	Cache Miss
Production (Alpine pre-built)	~2-3 min	~1 min	~2 min
Alpine pre-built	~2-3 min	~1 min	~2 min
Alpine source	~8-12 min	~3-5 min	~10 min
Ubuntu pre-built	~3-4 min	~1-2 min	~3 min
Ubuntu source	~10-15 min	~4-6 min	~12 min

📋 Build Matrix

Trigger	Version Format	Download Path	Image Tags
`push main`	`dev-{sha}`	`artifacts/rustfs/dev/`	`dev-{sha}-{variant}`, `dev-{variant}`, `dev`
`push 1.2.3`	`1.2.3`	`artifacts/rustfs/release/`	`1.2.3-{variant}`, `1.2.3`, `latest-{variant}`, `latest`
`push 1.3.0-alpha.2`	`1.3.0-alpha.2`	`artifacts/rustfs/release/`	`1.3.0-alpha.2-{variant}`, `alpha-{variant}`, `alpha`
`push 1.3.0-beta.1`	`1.3.0-beta.1`	`artifacts/rustfs/release/`	`1.3.0-beta.1-{variant}`, `beta-{variant}`, `beta`
`push 1.3.0-rc.1`	`1.3.0-rc.1`	`artifacts/rustfs/release/`	`1.3.0-rc.1-{variant}`, `rc-{variant}`, `rc`