fix: improve Docker Python environment setup for reliable builds

loonghao · loonghao · commit b9b9d8ff08e5 · 2025-06-02T02:51:52.000+08:00
Python environment improvements:
- Add essential build dependencies (python3-dev, g++, make, pkg-config)
- Add libffi-dev and libssl-dev for cryptographic packages
- Simplify requirements copying (remove pyproject.toml dependency)
- Use proper uv virtual environment setup with explicit PATH
- Add verbose output for debugging dependency installation
- Remove redundant gRPC installation (already in requirements.txt)

Build dependencies added:
- gcc, g++: C/C++ compilers for native extensions
- make: Build automation tool
- pkg-config: Package configuration tool
- libffi-dev: Foreign Function Interface library
- libssl-dev: SSL/TLS library for secure connections
- python3-dev: Python development headers

These changes should resolve the Docker build failures related to
Python package compilation, particularly for gRPC and other native
extensions that require compilation during installation.

Signed-off-by: longhao &lt;hal.long@outlook.com&gt;
diff --git a/Dockerfile b/Dockerfile
@@ -34,22 +34,32 @@ FROM python:3.11-slim AS python-base
 
 WORKDIR /app
 
-# Install system dependencies
+# Install system dependencies for building Python packages
 RUN apt-get update && apt-get install -y \
     gcc \
+    g++ \
+    make \
+    pkg-config \
+    libffi-dev \
+    libssl-dev \
+    python3-dev \
     && rm -rf /var/lib/apt/lists/*
 
 # Install UV
-RUN pip install uv
+RUN pip install --no-cache-dir uv
 
 # Copy Python requirements
-COPY pyproject.toml ./
-COPY requirements*.txt ./
+COPY requirements.txt ./
 
-# Install Python dependencies
-RUN uv venv /opt/venv && \
-    /opt/venv/bin/pip install grpcio grpcio-tools && \
-    /opt/venv/bin/pip install -r requirements.txt
+# Create virtual environment and install dependencies using uv
+RUN uv venv /opt/venv
+ENV VIRTUAL_ENV=/opt/venv
+ENV PATH="/opt/venv/bin:$PATH"
+
+# Install Python dependencies using uv with verbose output
+RUN echo "Installing Python dependencies..." && \
+    cat requirements.txt && \
+    uv pip install --verbose -r requirements.txt
 
 # Stage 3: Final runtime image
 FROM python:3.11-slim
