uwsgi-python Docker镜像文档

镜像概述

uwsgi-python是一款基于ossobv/python基础镜像构建的Docker镜像，集成了uwsgi服务器和uwsgi-plugin-python插件，主要用于部署Python Web应用（如Django、Flask等），提供高效的WSGI协议支持。

支持的标签及对应Dockerfile链接

• 3, 3.6, latest: uwsgi-python3/Dockerfile
• 2: uwsgi-python2/Dockerfile

核心功能与特性

• 基于ossobv/python基础镜像，确保Python环境兼容性
• 内置uwsgi服务器，支持WSGI协议的Python Web应用部署
• 包含uwsgi-plugin-python插件，实现Python应用与uwsgi的无缝对接
• 提供多版本标签，适配Python 2和Python 3环境需求

使用场景

适用于需要通过uwsgi服务器部署Python Web应用的场景，尤其适合需要自定义依赖管理和服务器配置的开发或生产环境。

使用方法

构建应用镜像示例

以下为基于该镜像构建自定义Python Web应用镜像的Dockerfile示例：

FROM ossobv/uwsgi-python

# 复制依赖文件并安装
COPY requirements.txt .
RUN buildDeps=' \
# 在此处添加临时构建依赖（后续将移除）
        ' \
    && apt-get update \
    && apt-get install -y \
        $buildDeps \
        --no-install-recommends \
    && rm -rf /var/lib/apt/lists/* \
    && pip install --no-cache-dir -r requirements.txt \
    && apt-get purge --auto-remove $buildDeps

# 复制应用代码并设置工作目录
COPY example_project /code
WORKDIR /code

# 暴露应用端口
EXPOSE 8080

配置说明

默认启动要求

镜像默认启动命令（CMD）依赖工作目录中存在uwsgi.ini配置文件，用于定义uwsgi服务器运行参数。

uwsgi.ini配置示例

以下为基础的uwsgi.ini配置模板，可根据应用需求调整参数：

[uwsgi]
master = true          # 启用主进程模式
chdir = /code          # 设置应用工作目录
http-socket = :8080    # 监听8080端口（HTTP协议）
memory-report = true   # 启用内存使用情况报告
die-on-term = true     # 接收到TERM信号时优雅退出
plugin = python        # 加载Python插件
workers = 4            # 启动4个工作进程（根据服务器资源调整）
module = example_project.wsgi  # 指定WSGI应用入口模块（需替换为实际应用模块）
static-map = /static=/code/static  # 静态文件路径映射（根据实际静态文件目录调整）

注意事项

• 构建镜像时，建议仅安装必要的构建依赖，并在依赖安装完成后通过apt-get purge --auto-remove移除，以减小镜像体积。
• uwsgi.ini中的module参数需根据实际应用的WSGI入口文件路径调整，例如Django应用通常为<项目名称>.wsgi。
• 静态文件映射路径需与应用实际静态资源存放目录一致，确保静态资源可被正确访问。