sunpeek/poetry

预安装Python Poetry的Python基础镜像

镜像概述

本镜像基于Python官方镜像构建，预安装了Poetry环境及构建管理工具，底层基础镜像的具体版本由镜像标签指示。

核心功能与特性

• 预安装Poetry：无需额外配置即可使用Poetry进行Python项目的依赖管理、打包和发布
• 基于官方Python镜像：确保与官方Python运行环境的兼容性和稳定性
• 标签化基础版本：通过镜像标签可直接了解底层所使用的Python基础镜像版本，便于版本控制

使用场景

• Python项目的本地开发环境搭建
• CI/CD流水线中Python项目的依赖安装与构建过程
• 需要统一Poetry版本的团队协作开发
• 快速启动使用Poetry管理依赖的Python应用

使用方法

拉取镜像

根据项目所需的Python版本，通过标签拉取对应镜像：

bash
docker pull gitlab.com/sunpeek/poetry-docker:<tag>

说明：镜像标签<tag>对应底层Python基础镜像的版本，例如使用3.9表示基于python:3.9镜像构建，3.11-slim表示基于python:3.11-slim镜像构建。

启动容器

交互式开发环境

启动一个包含当前项目目录的交互式终端：

bash
docker run -it --rm -v $(pwd):/app -w /app gitlab.com/sunpeek/poetry-docker:<tag> /bin/bash

在容器内可直接执行Poetry命令：

bash
# 安装项目依赖
poetry install

# 运行Python脚本
poetry run python your_script.py

# 构建项目包
poetry build

直接运行命令

无需进入容器，直接执行Poetry命令：

bash
docker run --rm -v $(pwd):/app -w /app gitlab.com/sunpeek/poetry-docker:<tag> poetry install

相关链接

• 代码仓库：[***]