devilbox/python-flask

Python Flask Docker镜像

本项目提供用于开发目的的Python Flask Docker镜像。

查看GitHub上的**https://github.com/devilbox/docker-python-flask/blob/master/Dockerfile**。

文档

如需帮助，请访问社区页面。

</a>

Docker镜像标签

• 镜像名称: devilbox/python-flask

滚动标签

滚动标签会在夜间更新并推送，以确保使用最新的Python补丁版本。

发布标签

发布标签是固定的，与Git标签绑定。

示例

为方便使用，提供了Docker Compose示例项目：

bash
cp .env.example .env
docker-compose up

bash
curl localhost:3000

环境变量

• [1] 请参考项目目录结构了解用法

项目目录结构

以下展示如何在主机操作系统上组织项目。

基础结构

至少需要以下目录结构：

bash
<project-dir>/
└── app                      # 入口目录名称可通过环境变量修改 [1]
    └── main.py              # 入口文件名可通过环境变量修改 [2]

• [1] 使用FLASK_APP_DIR环境变量定义<project-dir>/app/中的入口目录。例如：FLASK_APP_DIR=src。
• [2] 使用FLASK_APP_FILE环境变量定义<project-dir>/app/main.py中的入口文件。例如：FLASK_APP_FILE=test.py。

带依赖的结构

以下目录结构允许在启动期间自动将Python依赖安装到虚拟环境中：

bash
<project-dir>/
├── app                      # 入口目录名称可通过环境变量修改
│   ├── __init__.py
│   └── main.py              # 入口文件名可通过环境变量修改
└── requirements.txt         # 可选：将在虚拟环境中pip安装

启动包含requirements.txt的容器后，会新增venv/目录作为Python虚拟环境：

bash
<project-dir>/
├── app
│   ├── __init__.py
│   ├── main.py
│   └── __pycache__
├── requirements.txt
└── venv
    ├── bin
    ├── include
    └── lib

挂载项目

使用此镜像时，需将项目目录挂载到容器内的/shared/httpd/：

bash
docker run \
  --rm \
  -v $(pwd)/<project-dir>:/shared/httpd/<project-dir> \
  docker.xuanyuan.run/devilbox/python-flask:3.9-dev

如果本地uid或gid不是1000，应通过环境变量设置相应值，确保容器与主机系统的文件系统权限同步：

bash
docker run \
  --rm \
  -v $(pwd)/<project-dir>:/shared/httpd/<project-dir> \
  -e NEW_UID=$(id -u) \
  -e NEW_GID=$(id -g) \
  docker.xuanyuan.run/devilbox/python-flask:3.9-dev

本地构建

bash
# 构建默认版本（Python 3.8）
make build

# 构建特定版本
make build PYTHON=3.7

本地测试

bash
# 测试默认版本（Python 3.8）
make test

# 测试特定版本
make test PYTHON=3.7

许可证

MIT许可证

Copyright (c) 2019 https://github.com/cytopia