flywheel/python

flywheel/python

镜像概述和主要用途

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

核心功能和特性

预设用户与目录

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

实用工具集

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

• https://github.com/aria2/aria2 - 快速下载器
• https://github.com/bminor/bash - 推荐的脚本shell
• busybox - Unix工具集（ps、ping等）
• https://github.com/sharkdp/fd - 更快更好的find替代工具
• https://github.com/jpmens/jo - 从命令行参数生成JSON
• https://github.com/itchyny/gojq - JSON处理工具
• https://github.com/zyedidia/micro - 开发者友好的文本编辑器
• https://github.com/BurntSushi/ripgrep - 更快更好的grep替代工具
• https://github.com/chmln/sd - 更快更好的sed替代工具
• https://github.com/proctorlabs/templar - Jinja2风格的命令行模板工具
• https://github.com/astral-sh/uv - 更快更好的pip替代工具
• https://github.com/watchexec/watchexec - 实时重载工具
• https://github.com/ducaale/xh - 安全且开发者友好的curl替代工具
• https://github.com/mikefarah/yq - YAML处理工具
• https://github.com/***/zstd - 快速无损压缩算法

构建变体

-build变体额外包含：

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

使用场景和适用范围

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

标签（Tags）

main分支的CI流水线会按以下方案推送到https://hub.docker.com/repository/docker/flywheel/python-alpine/tags?page=1&ordering=last_updated：

• 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文件以限制构建上下文：

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

Dockerfile示例

docker
# 推荐的生产环境基础镜像
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