# Multi-stage Dockerfile Template for FastAPI Services # Based on BlackRoad OS best practices # ============================================================================= # Stage 1: Build stage # ============================================================================= FROM python:3.11-slim as builder WORKDIR /build # Install build dependencies RUN apt-get update && apt-get install -y \ gcc \ postgresql-client \ && rm -rf /var/lib/apt/lists/* # Copy requirements and install dependencies COPY requirements.txt . RUN pip install --no-cache-dir --user -r requirements.txt # ============================================================================= # Stage 2: Runtime stage # ============================================================================= FROM python:3.11-slim WORKDIR /app # Install runtime dependencies RUN apt-get update && apt-get install -y \ libpq5 \ curl \ && rm -rf /var/lib/apt/lists/* \ && apt-get clean # Create non-root user for security RUN useradd -m -u 1000 appuser && \ chown -R appuser:appuser /app # Copy installed packages from builder COPY --from=builder /root/.local /home/appuser/.local # Copy application code COPY --chown=appuser:appuser . . # Make sure scripts in .local are usable ENV PATH=/home/appuser/.local/bin:$PATH # Switch to non-root user USER appuser # Health check HEALTHCHECK --interval=30s --timeout=5s --start-period=60s --retries=3 \ CMD curl -f http://localhost:${PORT:-8000}/health || exit 1 # Expose port (Railway will override with $PORT) EXPOSE 8000 # Start command CMD ["uvicorn", "app.main:app", "--host", "0.0.0.0", "--port", "8000"]