rosti/python

Python 3.4.1 Docker镜像文档

镜像概述

基于debian:wheezy的Python 3.4.1 Docker镜像，集成Virtualenv及自动化部署脚本，旨在简化Python应用的部署流程。镜像预设标准化目录结构，自动处理依赖安装和应用初始化，最终通过Gunicorn启动WSGI应用，适用于快速部署Python 3.4.1开发的Web应用。

核心功能与特性

• 内置组件：包含Python 3.4.1和Virtualenv，提供完整的Python运行环境
• 标准化目录：预设/srv根目录，分离应用代码（/srv/app）、虚拟环境（/srv/venv）和日志（/srv/logs）
• 自动依赖管理：启动时自动执行pip install -r /srv/app/requirements.txt安装应用依赖
• 自定义初始化：支持通过/srv/app/init.sh执行自定义启动逻辑（如数据库迁移、静态文件处理）
• Gunicorn集成：默认使用Gunicorn作为WSGI服务器，自动监听8000端口并加载应用

使用场景与适用范围

适用于部署基于Python 3.4.1开发的WSGI应用（如Django、Flask），尤其适合需要标准化部署流程、自动依赖管理和自定义初始化逻辑的场景。

使用方法与配置说明

目录结构

镜像使用/srv作为应用数据根目录，需通过卷挂载本地应用目录到此路径。关键子目录说明：

• /srv/：应用数据根目录，需挂载本地应用目录
• /srv/app/：存放Python应用代码（必须包含requirements.txt和init.sh）
• /srv/venv/：Python 3.4.1虚拟环境目录（自动创建，无需手动配置）
• /srv/logs/：应用日志目录，包含Gunicorn访问日志（access.log）和错误日志（error.log）

启动流程

容器启动后按以下顺序执行操作：

1. 安装依赖：运行pip install -r /srv/app/requirements.txt安装/srv/app目录下的依赖包
2. 执行初始化脚本：调用/srv/app/init.sh执行自定义初始化逻辑（需用户提供，如数据库迁移）
3. 启动Gunicorn：通过以下命令启动WSGI应用：

   bash
   /srv/venv/bin/gunicorn -u app -g app -b 0.0.0.0:8000 -w $WORKERS --error-logfile /srv/logs/error.log --access-logfile /srv/logs/access.log --reload app
   

   • -w $WORKERS：工作进程数，通过环境变量WORKERS控制
   • --reload：代码变更时自动重启（开发环境适用）
   • app：指定WSGI入口为/srv/app/app.py中的application对象

环境变量

• WORKERS：Gunicorn工作进程数，未指定时使用Gunicorn默认值

部署示例

基础部署命令

将本地应用目录/my/site挂载到容器/srv目录，启动应用：

bash
docker run -d --name=pyapp -p 10001:8000 -v /my/site:/srv docker.xuanyuan.run/rosti/python:3.4.1

• -p 10001:8000：将容器8000端口映射到主机***端口
• -v /my/site:/srv：挂载本地应用目录到容器/srv

初始化脚本示例（init.sh）

在/srv/app目录下创建init.sh（需添加执行权限），示例Django初始化逻辑：

bash
#!/bin/bash

# 激活虚拟环境
source /srv/venv/bin/activate
# 进入应用目录
cd /srv/app
# 执行数据库迁移
python manage.py migrate
# 收集静态文件
python manage.py collectstatic --noinput

WSGI应用入口示例（app.py）

Gunicorn默认加载/srv/app/app.py中的application对象，Django应用示例：

python
import os
os.environ.setdefault("DJANGO_SETTINGS_MODULE", "triatlon.settings")

from django.core.wsgi import get_wsgi_application
application = get_wsgi_application()