jazzdd/alpine-flask

Alpine OS 运行 Python Flask (支持 Python 2.7 或 3.6)

标签

• latest - 基于 Python 2.7 运行 Flask
• python3 - 基于 Python 3.6 运行 Flask

镜像概述

该镜像基于轻量级Alpine OS构建，用于运行Flask应用程序，提供Python 2.7（latest标签）和Python 3.6（python3标签）两种版本选择。集成Nginx作为反向代理和UWSGI作为应用服务器，支持自动安装依赖包，适用于开发和生产环境。

核心功能与特性

• 轻量级基础：基于Alpine OS，镜像体积小，资源占用低
• 多版本支持：提供Python 2.7和3.6两种运行环境
• 自动依赖管理：通过配置文件自动安装Python/Flask包和Alpine系统包
• 生产级部署：Nginx处理静态资源，UWSGI运行Flask应用，提升性能
• 调试模式：支持切换到Flask内置开发服务器，实现代码自动重载
• Docker控制能力：可挂载Docker套接字实现对主机Docker服务的管理

使用场景

• 开发和部署小型到中型Flask Web应用
• 构建轻量级、资源高效的Python Web服务
• 创建需要控制Docker服务的Flask应用（如容器管理工具、CI/CD系统）

使用方法

基本部署

使用以下命令启动容器：

bash
docker run --name flaskapp --restart=always \
    -p 80:80 \
    -v /path/to/app/:/app \
    -d jazzdd/alpine-flask

参数说明：

• -v /path/to/app/:/app：挂载包含app.py（应用入口文件）的主机目录到容器/app目录
• -p 80:80：将容器80端口映射到主机80端口（镜像默认暴露80端口）
• --restart=always：配置容器退出时自动重启

安装额外Python/Flask包

镜像预装基础Python包、Flask和pip。如需额外包，在应用根目录（挂载到/app的目录）创建requirements.txt文件，按pip文档格式列出依赖。容器首次启动时会自动通过pip安装这些包。

运行时安装额外包：

bash
docker exec YOUR_CONTAINER_ID/NAME /bin/bash -c "pip install package-name"

安装额外Alpine包

部分Python包可能需要系统级依赖。在应用根目录创建requirements_image.txt文件，列出需安装的Alpine包（空格或换行分隔），容器首次启动时会自动安装。

内部机制

应用架构

• Flask应用通过UWSGI socket启动
• Nginx将80端口请求转发到UWSGI socket，并直接处理静态资源（CSS、JS等）
• 不提供SSL功能，建议使用https://github.com/jwilder/nginx-proxy%E5%AE%9E%E7%8E%B0HTTPS

日志查看

使用以下命令查看容器日志：

bash
docker logs -f CONTAINER_ID/NAME

使用镜像控制Docker

通过挂载Docker套接字并添加特定参数，可创建控制主机Docker服务的容器：

bash
docker run --name flaskapp --restart=always \
    -p 80:80 \
    -v /path/to/app/:/app \
    -v /var/run/docker.sock:/var/run/docker.sock \
    -d jazzdd/alpine-flask -o gid

参数说明：

• -v /var/run/docker.sock:/var/run/docker.sock：挂载主机Docker套接字
• -o gid：启用Docker支持（容器首次启动时安装Docker），gid需替换为主机Docker组的GID，容器会将nginx用户添加到该组

示例：在Flask应用中控制Docker

python
from subprocess import call
call(["docker", "run", "-p", "80", "-v", "/path/to/app/:/app", "-d", "jazzdd/alpine-flask"])

调试模式

调试模式使用Flask内置开发服务器，支持代码修改后自动重载，不使用UWSGI和Nginx。

启动调试模式容器：

bash
docker run --name flaskapp --restart=always \
    -p 80:80 \
    -v /path/to/app/:/app \
    -d jazzdd/alpine-flask -d

app.py需包含以下代码：

python
if __name__ == '__main__':
    app.run(host='0.0.0.0', port=80, debug=True)

查看应用输出日志：

bash
docker logs -f CONTAINER_ID/NAME