smartlab/flask

Smartlab Flask 镜像文档

镜像概述

Smartlab Flask是一个专为Flask应用设计的Docker镜像，提供了灵活的部署和运行方式。该镜像支持多种运行模式，包括纯Flask运行、uWSGI部署、调试模式、代码质量测试以及容器终端检查，适用于Flask应用的开发、测试和生产环境。推荐使用项目提供的docker-compose.yml来构建完整的NGINX > uWSGI > Flask技术栈，以获得更优的性能和稳定性。

核心功能与特性

• 多模式运行：支持纯Flask运行、uWSGI部署、调试模式、代码质量测试及终端交互
• 灵活挂载：通过卷挂载本地应用目录，实现代码实时更新
• 标准化配置：要求应用主文件统一命名为/app/main.py，确保部署一致性
• 完整栈支持：推荐配合docker-compose使用，构建包含NGINX和uWSGI的生产级架构

使用场景

• 开发环境：通过调试模式实时开发和测试Flask应用
• 生产部署：使用uWSGI模式配合NGINX实现高性能生产环境部署
• 代码质量检测：通过内置测试工具检查代码质量
• 容器调试：通过终端模式进入容器内部进行问题排查

使用方法与配置说明

前提条件

• 本地Flask应用目录需包含主文件main.py
• Docker环境已安装并正常运行

基本运行命令

1. 纯Flask模式运行

bash
docker run -p 8080:5000 -d -v /path/app:/app smartlab/flask

• -p 8080:5000：将容器5000端口映射到主机8080端口
• -d：后台运行容器
• -v /path/app:/app：将本地应用目录（替换/path/app为实际路径）挂载到容器/app目录

2. uWSGI模式运行

bash
docker run -p 8080:5000 -d -v /path/app:/app smartlab/flask uwsgi

3. 调试模式运行

bash
docker run -p 8080:5000 -d -v /path/app:/app smartlab/flask debug

4. 代码质量测试

bash
docker run -p 8080:5000 -d -v /path/app:/app smartlab/flask test

5. 终端模式（容器内部检查）

bash
docker run -p 8080:5000 -it -v /path/app:/app smartlab/flask terminal

• -it：以交互模式运行，可直接在容器内执行命令

完整栈部署（推荐）

建议使用项目提供的https://github.com/smartlab-flpo-br/flask/blob/master/docker-compose.yml%E6%9D%A5%E9%83%A8%E7%BD%B2%E5%AE%8C%E6%95%B4%E7%9A%84%60NGINX > uWSGI > Flask`架构，具体步骤：

1. 克隆项目仓库获取docker-compose配置文件
2. 根据实际需求调整配置
3. 执行以下命令启动完整栈：

bash
docker-compose up -d

注意事项

• 主文件命名：应用必须包含/app/main.py作为入口文件，否则会导致运行失败
• 端口映射：可根据实际需求调整主机端口（命令中的8080部分）
• 卷挂载：确保本地应用目录路径正确，避免因路径错误导致文件无法访问