Docker镜像文档

镜像概述和主要用途

本镜像为基于Python的运行环境，预安装了多种常用Python库，集成了数据库连接、消息队列交互、云服务集成及定时任务管理等功能。旨在提供开箱即用的开发/运行环境，减少依赖配置时间，适用于快速部署依赖多数据源、消息队列或定时任务的Python应用。

核心功能和特性

1. 多数据库连接支持

• 关系型数据库：集成MySQL-python（1.2.5）和PyMySQL（0.9.3），支持MySQL数据库连接与操作
• NoSQL数据库：包含pymongo（3.6.0）和redis（2.10.6），支持MongoDB和Redis数据库交互
• 缓存服务：提供python-memcached（1.58），支持Memcached缓存操作

2. 消息队列与通信

• Kafka客户端：集成kafka-python（1.3.5），支持Kafka消息队列的生产与消费
• WebSocket支持：包含websocket-client（0.44.0）和socketclusterclient（1.3.4），支持WebSocket通信

3. 云服务集成

• AWS服务支持：通过boto3（1.9.197）和s3transfer（0.2.1）提供AWS S3、EC2等服务的访问能力

4. 任务调度与时间处理

• 定时任务管理：集成python-crontab（2.3.8），支持Linux crontab定时任务配置
• 时间处理工具：包含python-dateutil（2.8.0）和pytz（2019.1），提供日期时间解析与时区处理功能

5. 其他核心工具

• HTTP请求：requests（2.22.0）支持HTTP/HTTPS请求发送
• 字符处理：Unidecode（1.1.1）提供Unicode到ASCII字符转换
• 包管理：预安装pip（19.2.3）、setuptools（36.5.0）、wheel（0.30.0）等包管理工具

使用场景和适用范围

• 数据ETL流程：需连接多种数据库（MySQL、MongoDB、Redis）进行数据抽取、转换、加载的任务
• 定时数据同步：通过python-crontab实现定时数据同步或报表生成
• 多数据源聚合服务：需同时处理关系型数据库、NoSQL数据库及消息队列数据的后端服务
• 云服务集成应用：依赖AWS S3等云服务进行文件存储或数据交互的应用
• 快速开发环境：简化依赖多种Python库的应用开发环境配置

使用方法和配置说明

基础运行

通过以下命令启动容器，进入交互式Python环境：

docker run -it --rm [镜像名称] python

挂载本地代码运行

将本地项目代码挂载到容器中运行：

docker run -it --rm -v /本地代码路径:/app [镜像名称] python /app/your_script.py

运行定时任务示例

在容器中使用python-crontab配置定时任务（示例脚本schedule_task.py）：

from crontab import CronTab

# 创建定时任务（每分钟执行一次test.py）
cron = CronTab(user='root')
job = cron.new(command='python /app/test.py')
job.setall('* * * * *')  # 每分钟执行
cron.write()

运行脚本：

docker run -it --rm -v /本地脚本路径:/app [镜像名称] python /app/schedule_task.py

连接数据库示例

连接MySQL

import pymysql

conn = pymysql.connect(host='mysql-host', user='user', password='pass', db='dbname')
cursor = conn.cursor()
cursor.execute("SELECT * FROM table")
print(cursor.fetchall())
conn.close()

连接Redis

import redis

r = redis.Redis(host='redis-host', port=6379, db=0)
r.set('key', 'value')
print(r.get('key'))

环境变量配置

可通过-e参数设置Python相关环境变量，如编码格式：

docker run -it --rm -e PYTHONIOENCODING=utf-8 [镜像名称] python

安装额外依赖

如需安装镜像未包含的库，可在容器内使用pip：

docker run -it --rm [镜像名称] pip install package_name