yperteam/circleci-python

docker-images 镜像文档

镜像概述和主要用途

docker-images 是一个包含多种常用基础镜像的集合，整合了不同操作系统（如Ubuntu、Alpine、CentOS）和运行时环境（如Python、Node.js、Java），旨在为开发者和运维人员提供标准化、优化的基础镜像资源。该集合通过预配置常用环境、精简镜像体积和定期更新维护，帮助用户快速构建Docker应用，减少基础环境配置时间，提升开发和部署效率。

核心功能和特性

• 多环境覆盖：包含多种主流操作系统版本（如Ubuntu 20.04/22.04、Alpine 3.17/3.18、CentOS 7/8）及常用运行时环境（Python 3.9+/Node.js 16+/OpenJDK 11/17），满足多样化应用需求。
• 优化镜像体积：基于官方镜像进行精简，去除冗余依赖和临时文件，平均镜像体积较原生官方镜像减少30%以上，提升传输和部署速度。
• 安全与稳定性：定期同步官方镜像更新，集成最新安全补丁，通过自动化测试确保镜像兼容性和稳定性。
• 易于定制扩展：支持通过Dockerfile基于集合内镜像进行二次构建，提供灵活的环境定制能力，适配特定业务需求。

使用场景和适用范围

• 应用开发环境：为本地开发提供一致的基础环境，避免因环境差异导致的"在我电脑上能运行"问题，提升团队协作效率。
• CI/CD流程集成：作为持续集成/持续部署管道的基础镜像，用于自动化构建、测试和打包应用，简化流水线配置。
• 生产环境部署：提供稳定、安全的运行时环境，适用于微服务架构、Web应用、后台服务等生产场景的容器化部署。
• 学习与实验：供Docker初学者快速获取各类基础镜像，降低容器技术学习门槛，支持容器化实验和测试。

使用方法和配置说明

镜像拉取

通过Docker命令直接拉取集合中的特定镜像，格式如下：

bash
docker pull docker-images/[镜像类型]:[标签]

常用镜像拉取示例：

• 拉取Ubuntu 22.04基础镜像

  bash
  docker pull docker-images/ubuntu:22.04
  

• 拉取Python 3.11运行时镜像（基于Alpine）

  bash
  docker pull docker-images/python:3.11-alpine
  

• 拉取Node.js 18运行时镜像（基于Ubuntu）

  bash
  docker pull docker-images/node:18-ubuntu
  

容器运行示例

基础操作系统容器

运行交互式Ubuntu容器：

bash
docker run -it --rm docker-images/ubuntu:22.04 /bin/bash

参数说明：-it 启用交互式终端，--rm 容器退出后自动删除

运行时环境容器

运行Python应用容器（假设当前目录有app.py）：

bash
docker run -v $(pwd):/app -w /app docker-images/python:3.11-slim python app.py

参数说明：-v 挂载本地目录到容器，-w 设置工作目录

自定义构建示例

通过Dockerfile基于集合镜像构建应用镜像：

dockerfile
# 使用Python 3.11基础镜像
FROM docker-images/python:3.11-slim

# 设置环境变量
ENV PYTHONDONTWRITEBYTECODE=1 \
    PYTHONUNBUFFERED=1 \
    TIMEZONE=Asia/Shanghai

# 安装应用依赖
WORKDIR /app
COPY requirements.txt .
RUN pip install --no-cache-dir -r requirements.txt

# 复制应用代码
COPY . .

# 启动命令
CMD ["python", "main.py"]

构建并运行自定义镜像：

bash
docker build -t my-python-app .
docker run my-python-app

环境变量配置

部分镜像支持通过环境变量自定义配置，常用参数如下：

示例：运行时指定时区和语言环境

bash
docker run -e TIMEZONE=Asia/Shanghai -e LANG=zh_CN.UTF-8 docker-images/alpine:3.18

维护与更新

• 镜像更新周期：基础镜像每月更新一次，包含安全补丁和版本升级
• 版本标签规则：采用[基础版本]-[系统类型]格式，如3.11-alpine表示Python 3.11基于Alpine系统
• 废弃策略：旧版本镜像在新版本发布后保留6个月，期间通过latest标签指向最新稳定版