Update Dockerfile

Author: FJiayang

Dockerfile

@@ -1,71 +1,92 @@
+# ==============================================================================
+# Dockerfile for a feature-rich, optimized code-server development environment
 #
-# Dockerfile for a feature-rich code-server with Conda and UV
-# Pre-configured for Asia/Shanghai timezone and Alibaba Cloud PyPI mirror.
-#
+# Features:
+# - Base: code-server (latest)
+# - Python: Miniforge (Conda) with a pre-created Python 3.11 environment
+# - Package Manager: 'uv' (ultra-fast) and 'conda'
+# - Optimization (China):
+#   - Timezone: Asia/Shanghai
+#   - PyPI Mirror: Alibaba Cloud (for uv/pip)
+#   - Conda Mirror: TUNA (Tsinghua University)
+# - Convenience: Auto-activates conda environment in the terminal
+# ==============================================================================
 
 # Step 1: Start from the official code-server base image.
 FROM codercom/code-server:latest
 
-# Step 2: Set arguments for tool versions.
+# Step 2: Set arguments for tool versions for easy updates.
 ARG MINIFORGE_VERSION=23.11.0-0
 ARG PYTHON_VERSION=3.11
 
-# Step 3: Define environment variables for tool paths and configurations.
+# Step 3: Define environment variables for paths and configurations.
 ENV CONDA_DIR=/opt/conda
 ENV UV_DIR=/home/coder/.local
-# Add bin directories to the system PATH.
+# Add bin directories of Conda and UV to the system's PATH.
 ENV PATH=${CONDA_DIR}/bin:${UV_DIR}/bin:${PATH}
-# CRITICAL: Set the timezone environment variable.
+# Set the timezone.
 ENV TZ=Asia/Shanghai
-# CRITICAL: Configure UV to use the Alibaba Cloud mirror by default.
+# Configure UV/pip to use the Alibaba Cloud mirror.
 ENV UV_INDEX_URL=https://mirrors.aliyun.com/pypi/simple
 
 # Step 4: Switch to the ROOT user for system-level installations.
 USER root
 
-# Step 5: Install system dependencies, set timezone, and install Miniforge.
+# Step 5: Install system dependencies, set timezone, install and configure Conda.
 RUN \
-    # Update package lists and install necessary tools
+    # Update package lists and install necessary tools.
     apt-get update && apt-get install -y --no-install-recommends \
         wget \
         curl \
         git \
         build-essential \
         tzdata \
-    # Set the timezone non-interactively
+    # Set the timezone non-interactively.
     && ln -snf /usr/share/zoneinfo/$TZ /etc/localtime && echo $TZ > /etc/timezone \
-    # Download and install Miniforge
+    # Download and install Miniforge.
     && wget "https://github.com/conda-forge/miniforge/releases/download/${MINIFORGE_VERSION}/Miniforge3-${MINIFORGE_VERSION}-Linux-x86_64.sh" -O miniforge.sh \
     && /bin/bash miniforge.sh -b -p ${CONDA_DIR} \
     && rm miniforge.sh \
-    # Give the 'coder' user ownership of the conda directory
+    # Give the 'coder' user ownership of the conda directory.
     && chown -R coder:coder ${CONDA_DIR} \
-    # Clean up apt cache to keep the image size down
+    # Create symbolic links for 'conda' and 'python3' to be accessible by root for debugging.
+    && ln -s ${CONDA_DIR}/bin/conda /usr/local/bin/conda \
+    && ln -s ${CONDA_DIR}/bin/python /usr/local/bin/python3 \
+    # Clean up apt cache to reduce image size.
     && apt-get clean \
     && rm -rf /var/lib/apt/lists/*
 
 # Step 6: Switch back to the standard, non-root 'coder' user.
 USER coder
 
-# Step 7: As the 'coder' user, install user-specific tools and set up the default environment.
+# Step 7: As the 'coder' user, configure tools and create the development environment.
 RUN \
-    # Install 'uv' using its official script
+    # Install 'uv' (the fast Python package manager).
     curl -LsSf https://astral.sh/uv/install.sh | sh && \
     \
-    # Create a default conda environment
+    # Configure Conda to use Tsinghua University mirrors for faster package downloads.
+    conda config --set show_channel_urls true && \
+    conda config --add channels https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/main && \
+    conda config --add channels https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/r && \
+    conda config --add channels https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/msys2 && \
+    conda config --add channels https://mirrors.tuna.tsinghua.edu.cn/conda-forge/ && \
+    conda config --set-default-channels https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/main && \
+    \
+    # Create the default conda environment. This will be fast due to the mirror.
     conda create -n py${PYTHON_VERSION} python=${PYTHON_VERSION} -y && \
     \
-    # Pre-install common packages into the new environment using 'uv'.
-    # This will now automatically use the Alibaba Cloud mirror due to the ENV var.
+    # Pre-install common Python packages into the new environment using 'uv'.
+    # This will use the Alibaba Cloud PyPI mirror configured via ENV var.
     uv pip install --python=${CONDA_DIR}/envs/py${PYTHON_VERSION}/bin/python \
         numpy \
         pandas \
         matplotlib \
         scikit-learn \
-        jupyterlab && \
+        jupyterlab \
+        requests && \
     \
-    # Configure the shell to automatically activate this environment on login
+    # Configure the shell to automatically activate this environment on login.
     echo "conda activate py${PYTHON_VERSION}" >> ~/.bashrc
 
-# Step 8: The base image's entrypoint will start code-server.
-# All environment variables (TZ, UV_INDEX_URL, PATH) will be inherited.
+# Step 8: The base image's entrypoint will automatically start code-server.
+# All our PATH and environment variable configurations will be inherited by the application.