openeuler/distroless-python

distroless-python | openEuler 镜像文档

快速参考

• 官方distroless-python Docker镜像。
• 维护者：openEuler CloudNative SIG。
• 获取帮助：openEuler CloudNative SIG、openEuler。

镜像概述和主要用途

本镜像包含最小化的Linux系统和Python运行时。Distroless Python镜像是设计用于运行Python应用的最小容器镜像，通过减少***面增强安全性。它们仅包含必要的Python运行时及其依赖，排除标准Linux发行版中常见的不必要组件（如shell和包管理器），从而简化依赖管理并提升安全性。

核心功能和特性

• 最小化设计：仅包含运行Python应用所需的核心组件，减少镜像体积和潜在***面。
• 增强安全性：排除非必要工具（如shell、包管理器），降低***利用风险。
• 简化依赖：仅保留Python运行时及其必要依赖，避免依赖膨胀。
• 基于openEuler：构建于openEuler系统，确保稳定性和兼容性。

支持的标签及对应Dockerfile链接

标签详情如下：

使用场景和适用范围

• 运行对安全性有较高要求的Python应用。
• 需要最小化容器体积的场景。
• 简化依赖管理，避免不必要组件干扰的Python应用部署。

使用方法和配置说明

在Python项目中创建Dockerfile

dockerfile
# Dockerfile

FROM openeuler/distroless-python:3.11.6-oe2403lts
COPY . /usr/src/myapp
WORKDIR /usr/src/myapp

# 指定容器启动时运行的命令
CMD ["python3", "./your-script.py"]

构建并运行Docker镜像的命令：

bash
$ docker build -t my-python-app .
$ docker run -it --rm --name my-running-app my-python-app

运行单个Python脚本（标准库导入测试）

如需快速测试Python脚本，特别是验证distroless环境中标准库的可用性，可直接挂载并执行脚本。以下示例使用标准库导入测试脚本import.py：

bash
docker run -it --rm \
  -v "$PWD/import.py":/usr/src/app/import.py \
  -w /usr/src/app \
  openeuler/distroless-python:3.11.6-oe2403lts \
  python3 import.py

预期输出：

......
Imported syslog
Imported termios
Imported unicodedata
Imported xxlimited
Imported xxlimited_35
Imported zlib
Import everything test successfully!

以非root用户运行应用

实现细节请参考distroless-base-nonroot文档。

问题与解答

如有任何问题或需要使用特定功能，请在openeuler-docker-images提交issue或pull request。