flywheel/python

镜像概述和主要用途

Flywheel项目的Python基础镜像，专为开发和生产环境设计。包含预设的flywheel:flywheel用户、用于存储多进程指标的/var/metrics目录，以及一系列适用于构建和运行时的实用工具。提供基于alpine或debian的基础镜像，并包含带有额外构建工具的-build变体。

核心功能和特性

预设用户与目录

• 专用用户：内置flywheel:flywheel用户，生产环境中可通过USER flywheel切换
• 指标目录：提供/var/metrics文件夹，设置ENV PROMETHEUS_MULTIPROC_DIR=/var/metrics即可用于多进程指标存储

实用工具集

包含以下适用于构建和运行时的基础工具：

• aria2 - 快速下载器
• bash - 推荐的脚本shell
• busybox - Unix工具集（ps、ping等）
• fd - 更快更好的find替代工具
• jo - 从命令行参数生成JSON
• jq - JSON处理工具
• micro - 开发者友好的文本编辑器
• rg - 更快更好的grep替代工具
• sd - 更快更好的sed替代工具
• templar - Jinja2风格的命令行模板工具
• uv - 更快更好的pip替代工具
• watchexec - 实时重载工具
• xh - 安全且开发者友好的curl替代工具
• yq - YAML处理工具
• zstd - 快速无损压缩算法

构建变体

-build变体额外包含：

• git - 版本控制工具
• ssh - 安全外壳协议工具

使用场景和适用范围

• 开发环境：利用build变体和丰富工具集进行代码编写、调试和构建
• 生产环境：使用基础镜像（非-build变体），切换至flywheel用户增强安全性
• 适用于需要Python运行环境且依赖多种系统工具的Flywheel项目
• 支持多阶段构建，优化开发到生产的工作流

标签（Tags）

main分支的CI流水线会按以下方案推送到DockerHub：

• flywheel/python:{PYTHON_VER}-{BASE_IMAGE} - 推荐的生产环境基础镜像
• flywheel/python:{PYTHON_VER}-{BASE_IMAGE}-build - 包含git和ssh的构建变体

可用版本

• Python版本（PYTHON_VER）：3.12（默认）、3.11、3.10、3.9
• 基础镜像（BASE_IMAGE）：alpine（默认）、debian（bookworm版本）

默认标签对应关系

• flywheel/python:latest === :3.12-alpine
• flywheel/python:build === :3.12-alpine-build

提交特定标签

为提高可重复性，提供提交哈希特定标签，例如：

• flywheel/python:3.12-debian-d34db33f

使用方法和配置说明

准备工作

创建.dockerignore文件以限制构建上下文：

# 排除所有文件
**
# 包含所需文件
!myproj
!pyproject.toml
!README.md
!requirements.txt
# 重新排除冗余文件
**/__pycache__

Dockerfile示例

# 推荐的生产环境基础镜像
FROM flywheel/python:3.12-alpine AS base
SHELL ["/bin/bash", "-euxo", "pipefail", "-c"]
WORKDIR /src
COPY requirements.txt ./
RUN uv pip install -rrequirements.txt
CMD ["my-app"]
EXPOSE 8000

# 开发阶段
FROM base AS dev
COPY requirements-dev.txt ./
RUN uv pip install -rrequirements-dev.txt
COPY . .
RUN python -m compileall -bqj0 . && \
    fd -epy -E__init__.py -xrm . && \
    uv pip install --no-deps -e.

# 生产阶段
FROM base AS prod
COPY --from=dev /src .
RUN uv pip install --no-deps -e.
# 切换到非root用户增强安全性
USER flywheel

许可证

代码仓库

flywheel-io/tools/img/python