articulate/python

Articulate Python基础Docker镜像

概述与主要用途

Articulate Python基础Docker镜像是用于构建Python应用的标准化基础镜像。该镜像集成了必要的工具、配置和依赖，旨在简化Python应用的容器化流程，确保开发与生产环境的一致性，并提供安全、高效的运行时环境。

核心功能与组件

内置工具与组件

• docker-bootstrap入口点：从Consul和Vault加载环境变量，支持动态配置管理（https://github.com/articulate/docker-bootstrap）。
• secrets脚本：将Docker secrets自动加载为环境变量，简化敏感信息管理（https://github.com/articulate/docker-bootstrap/blob/main/scripts/docker-secrets）。
• install_packages脚本：便捷安装apt包，统一依赖管理流程（https://github.com/articulate/docker-bootstrap/blob/main/scripts/install_packages）。
• AWS CLI：集成AWS命令行工具，支持与AWS服务直接交互（https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html）。

可用标签

🌟 推荐镜像

使用场景与适用范围

• Python应用容器化：作为基础镜像构建各类Python应用，如Web服务、数据处理工具等。
• 云服务集成：需与AWS服务交互的Python应用（如S3、EC2、Lambda等）。
• 配置与密钥管理：依赖Consul（配置中心）或Vault（密钥管理）的环境。
• 标准化部署：需要统一用户、目录结构和基础工具链的生产环境。

构建新镜像的要求

基于本基础镜像构建新镜像时，需满足以下要求（若从现有镜像复制，可直接修改基础镜像版本；若从零构建，需确保包含以下内容）：

必要组件

• 包含核心功能与组件中列出的所有工具及依赖。
• 安装make工具，用于内部脚本与工具链的执行。

用户与权限配置

• 创建service用户及同名用户组，GID和UID均为1001，并设为默认用户（非root运行，增强安全性）。

目录结构

• 创建/service目录，设为默认工作目录（统一应用代码存放路径）。

使用方法与配置示例

基础使用（Dockerfile示例）

基于推荐标签构建Python应用镜像：

dockerfile
# 使用推荐的3.13版本作为基础镜像
FROM docker.xuanyuan.run/articulate/python:3.13

# 可选：安装额外系统依赖（使用内置install_packages脚本）
RUN install_packages curl git

# 复制应用代码到工作目录
COPY . /service

# 安装Python依赖（如需）
RUN pip install --no-cache-dir -r requirements.txt

# 保持默认用户和工作目录（无需额外配置，基础镜像已预设）
# USER 1001  # 基础镜像已默认启用
# WORKDIR /service  # 基础镜像已预设

# 定义启动命令
CMD ["python", "app.py"]

构建与运行

1. 构建镜像：

   bash
   docker build -t my-python-app .
   

2. 运行容器（示例，挂载Docker secrets）：

   bash
   docker run -d \
     --name my-app \
     --secret docker.xuanyuan.run/my-secret \ # 传递Docker secret
     -e CONSUL_URL=http://consul:8500 \  # 配置Consul地址（如需从Consul加载环境变量）
     my-python-app
   

基于PyTorch版本的示例

若需使用PyTorch，选择对应标签：

dockerfile
FROM articulate/python:3.12-pytorch

# 验证PyTorch安装
RUN python -c "import torch; print('PyTorch version:', torch.__version__)"

CMD ["python", "ml_app.py"]