kuralabs/python3-dev

镜像概述

kuralabs/python3-dev是基于Ubuntu 20.04的Python 3.8开发环境容器，专为Python项目构建及持续集成（CI）场景设计，提供全套开发工具及灵活的用户配置能力。

核心功能

• 预装Python 3.8及相关工具：python3、python3-dev、pip、venv、wheel、setuptools等
• 包含开发辅助工具：openssh-client、build-essential、cmake、graphviz、flake8、***graphy、tox、git、rsync
• 支持非root用户python3（具备sudo权限），可调整用户UID/GID以匹配主机用户，避免权限冲突
• 可调整Docker GID，支持容器内访问主机Docker socket构建镜像
• 支持时区配置及启动脚本执行（通过/docker-entrypoint-init.d/目录）

使用场景

• 本地Python项目开发与测试
• CI/CD流程中的Python项目构建环境
• 需要统一开发环境的团队协作场景

配置说明

基础使用

bash
docker pull kuralabs/python3-dev:latest
docker run --interactive --tty --init kuralabs/python3-dev:latest bash

调整用户及Docker GID

通过环境变量调整容器用户UID/GID及Docker GID，匹配主机用户避免权限问题：

bash
ADJUST_USER_UID=$(id -u)
ADJUST_USER_GID=$(id -g)
ADJUST_DOCKER_GID=$(getent group docker | cut -d: -f3)

docker run \
    --interactive --tty --init \
    --volume /var/run/docker.sock:/var/run/docker.sock \
    --env ADJUST_USER_UID=${ADJUST_USER_UID} \
    --env ADJUST_USER_GID=${ADJUST_USER_GID} \
    --env ADJUST_DOCKER_GID=${ADJUST_DOCKER_GID} \
    kuralabs/python3-dev:latest bash

注意：调整需以root用户启动容器（默认即为root，若不确定可添加--user root:root）

时区配置

同步主机时区：

bash
docker run \
    --interactive --tty --init \
    --env TZ=Asia/Shanghai \
    --volume /etc/timezone:/etc/timezone:ro \
    --volume /etc/localtime:/etc/localtime:ro \
    kuralabs/python3-dev:latest bash

启动脚本

将可执行脚本放入/docker-entrypoint-init.d/目录，容器启动时自动执行：

bash
docker run \
    --interactive --tty --init \
    --volume /your/local/scripts:/docker-entrypoint-init.d/ \
    kuralabs/python3-dev:latest bash

许可证

本镜像基于Apache License 2.0授权，详情见：[***]