chore(docker): add Dockerfile, .dockerignore, and CI workflow for Docker image build and push

Signed-off-by: samzong <[email protected]>

Author: samzong

.dockerignore

@@ -0,0 +1,95 @@
+# Git
+.git
+.gitignore
+.gitattributes
+
+# Documentation build artifacts
+docs/zh/site/
+docs/en/site/
+site/
+public/
+
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# Virtual environments
+.env
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# IDE
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+
+# OS
+.DS_Store
+.DS_Store?
+._*
+.Spotlight-V100
+.Trashes
+ehthumbs.db
+Thumbs.db
+
+# Logs
+*.log
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+
+# Dependencies
+node_modules/
+
+# Temporary files
+*.tmp
+*.temp
+.cache/
+
+# CI/CD
+.github/
+.gitlab-ci.yml
+
+# Documentation source in other languages (optional optimization)
+# Uncomment to reduce image size if only building specific language
+# docs/en/
+# docs/zh/
+
+# Scripts (keep if needed in container)
+# scripts/
+
+# README files (not needed in production)
+README*.md
+CONTRIBUTING.md
+CODE_OF_CONDUCT.md
+SECURITY.md
+LICENSE
+
+# Development tools
+makefile
+Makefile

.github/workflows/docker-build.yml

@@ -0,0 +1,94 @@
+name: Build and Push Docker Image
+
+on:
+  workflow_dispatch:
+  push:
+    tags: [ 'v*' ]
+
+env:
+  REGISTRY: ghcr.io
+  IMAGE_NAME: ${{ github.repository }}
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      packages: write
+
+    steps:
+    - name: Checkout repository
+      uses: actions/checkout@v4
+      with:
+        fetch-depth: 0
+
+    - name: Checkout OpenAPI docs
+      uses: actions/checkout@v4
+      with:
+        repository: daocloud/daocloud-api-docs
+        path: dao-openapi
+        fetch-depth: 0
+
+    - name: Checkout download docs
+      uses: actions/checkout@v4
+      with:
+        repository: daocloud/daocloud-download-docs
+        path: daocloud-download-docs
+        fetch-depth: 0
+
+    - name: Setup SSH for private repos
+      uses: MrSquaare/ssh-setup-action@v1
+      with:
+        host: github.com
+        private-key: ${{ secrets.SSH_PRIVATE_KEY }}
+
+    - name: Setup Python for merge script
+      uses: actions/setup-python@v4
+      with:
+        python-version: '3.x'
+
+    - name: Install Python dependencies for merge script
+      run: pip install pyyaml
+
+    - name: Merge external content
+      run: |
+        # Merge OpenAPI docs
+        cp -av dao-openapi/docs/openapi docs/zh/docs/
+        python scripts/merged_nav.py
+        
+        # Merge download docs
+        cp -av daocloud-download-docs/docs/zh/docs/download docs/zh/docs/
+        cp -av daocloud-download-docs/docs/en/docs/download docs/en/docs/
+
+    - name: Log in to Container Registry
+      uses: docker/login-action@v3
+      with:
+        registry: ${{ env.REGISTRY }}
+        username: ${{ github.actor }}
+        password: ${{ secrets.GITHUB_TOKEN }}
+
+    - name: Extract metadata
+      id: meta
+      uses: docker/metadata-action@v5
+      with:
+        images: ${{ env.REGISTRY }}/${{ env.IMAGE_NAME }}
+        tags: |
+          type=ref,event=branch
+          type=ref,event=pr
+          type=semver,pattern={{version}}
+          type=semver,pattern={{major}}.{{minor}}
+          type=raw,value=latest,enable={{is_default_branch}}
+
+    - name: Set up Docker Buildx
+      uses: docker/setup-buildx-action@v3
+
+    - name: Build and push Docker image
+      uses: docker/build-push-action@v5
+      with:
+        context: .
+        platforms: linux/amd64
+        push: true
+        tags: ${{ steps.meta.outputs.tags }}
+        labels: ${{ steps.meta.outputs.labels }}
+        ssh: |
+          default=${{ env.SSH_AUTH_SOCK }}

Dockerfile

@@ -0,0 +1,116 @@
+# Multi-stage Dockerfile for DaoCloud-docs documentation site
+# This Dockerfile creates a production-ready static site build
+
+FROM python:3.12-slim as builder
+
+# Set work directory
+WORKDIR /app
+
+# Install system dependencies
+RUN apt-get update && apt-get install -y \
+    git \
+    curl \
+    openssh-client \
+    && rm -rf /var/lib/apt/lists/*
+
+# Copy requirements and constraints
+COPY requirements.txt constraints.txt ./
+
+# Install Python dependencies
+RUN pip install -r requirements.txt -c constraints.txt
+
+# Install mkdocs-material-insiders from private repo
+RUN --mount=type=ssh \
+    mkdir -p ~/.ssh && \
+    chmod 700 ~/.ssh && \
+    ssh-keyscan github.com >> ~/.ssh/known_hosts && \
+    chmod 600 ~/.ssh/known_hosts && \
+    git config --global user.email "[email protected]" && \
+    git config --global user.name "Docker Builder" && \
+    git clone [email protected]:DaoCloud/mkdocs-material-insiders.git mkdocs-material && \
+    pip install -e mkdocs-material
+
+# Install custom plugin with PDF support
+RUN pip install git+https://github.com/SAMZONG/mkdocs-with-pdf-support-material-v8
+
+# Copy source files (external content already merged by workflow)
+COPY . .
+
+# Build Chinese documentation to site
+RUN mkdocs build -f docs/zh/mkdocs.yml -d site
+
+# Build English documentation to site/en
+RUN mkdocs build -f docs/en/mkdocs.yml -d site
+
+# Production stage with nginx
+FROM nginx:alpine as production
+
+# Copy built sites from builder stage
+COPY --from=builder /app/docs/zh/site /usr/share/nginx/html
+COPY --from=builder /app/docs/en/site /usr/share/nginx/html/en
+
+# Copy nginx configuration
+COPY <<EOF /etc/nginx/conf.d/default.conf
+server {
+    listen 80;
+    listen [::]:80;
+    server_name localhost;
+    
+    root /usr/share/nginx/html;
+    index index.html;
+    
+    # Enable gzip compression
+    gzip on;
+    gzip_types text/plain text/css application/json application/javascript text/xml application/xml application/xml+rss text/javascript;
+    
+    # Cache static assets
+    location ~* \.(js|css|png|jpg|jpeg|gif|ico|svg)$ {
+        expires 1y;
+        add_header Cache-Control "public, immutable";
+    }
+    
+    # Handle Chinese docs (root)
+    location / {
+        try_files \$uri \$uri/ \$uri.html =404;
+        
+        # Add security headers
+        add_header X-Frame-Options "SAMEORIGIN" always;
+        add_header X-Content-Type-Options "nosniff" always;
+        add_header Referrer-Policy "no-referrer-when-downgrade" always;
+    }
+    
+    # Handle English docs
+    location /en/ {
+        try_files \$uri \$uri/ \$uri.html =404;
+    }
+    
+    # Health check endpoint
+    location /health {
+        access_log off;
+        return 200 "healthy\n";
+        add_header Content-Type text/plain;
+    }
+    
+    # Redirect old paths if needed
+    location /zh/ {
+        return 301 /;
+    }
+    
+    # Custom error pages
+    error_page 404 /404.html;
+    error_page 500 502 503 504 /50x.html;
+    location = /50x.html {
+        root /usr/share/nginx/html;
+    }
+}
+EOF
+
+# Expose port
+EXPOSE 80
+
+# Health check
+HEALTHCHECK --interval=30s --timeout=3s --start-period=5s --retries=3 \
+    CMD curl -f http://localhost/health || exit 1
+
+# Run nginx
+CMD ["nginx", "-g", "daemon off;"]