xr09/python-requests

python-requests 镜像文档

镜像概述

python-requests 是一个基于Alpine Linux的Python镜像，每周进行构建更新，已预先安装 Requests 库。该镜像旨在为需要发送HTTP请求的Python应用提供轻量级、开箱即用的运行环境，减少依赖安装步骤，提升开发和部署效率。

核心功能与特性

• 轻量级基础：基于Alpine Linux构建，镜像体积小，资源占用低
• 每周更新：定期构建确保Python环境及依赖库保持最新稳定版本
• 预装Requests库：无需手动安装即可使用Python生态中流行的HTTP请求库
• 完整Python环境：包含标准Python运行时及基础工具，满足常规开发需求
• 兼容性良好：支持标准Python应用部署流程，可无缝集成现有Python项目

使用场景

• HTTP客户端开发：快速开发需要发送GET/POST等HTTP请求的应用
• API测试脚本：编写和运行与RESTful API交互的测试脚本
• 网络数据采集：构建简单的网页爬虫或数据采集工具
• 微服务通信：作为需要与外部服务通信的Python微服务基础镜像

使用方法与配置说明

基本使用

1. 运行交互式Python shell

通过以下命令启动容器并进入交互式Python环境，直接使用Requests库：

bash
docker run -it --rm python-requests python

在Python shell中验证Requests库：

python
import requests
response = requests.get('https://api.github.com')
print(response.status_code)  # 应输出200

2. 运行本地Python脚本

将包含HTTP请求逻辑的Python脚本（如app.py）挂载到容器中运行：

bash
docker run --rm -v $(pwd):/app -w /app python-requests python app.py

其中app.py示例代码：

python
import requests

def main():
    response = requests.get('https://httpbin.org/get')
    print(response.json())

if __name__ == '__main__':
    main()

Docker Compose配置示例

创建docker-compose.yml文件，定义服务并挂载项目目录：

yaml
version: '3'
services:
  app:
    image: python-requests
    volumes:
      - ./src:/app
    working_dir: /app
    command: python main.py
    environment:
      - PYTHONUNBUFFERED=1  # 实时输出日志

通过docker-compose up启动服务。

环境变量配置

支持Python官方镜像的标准环境变量，常用配置包括：

• PYTHONUNBUFFERED=1：禁用输出缓冲，确保日志实时打印
• PYTHONPATH：自定义Python模块搜索路径
• PYTHONDONTWRITEBYTECODE=1：禁止生成.pyc文件，减少容器内文件数量

注意事项

• 该镜像基于Alpine Linux，部分依赖可能需要额外安装系统库（可通过apk add命令）
• 每周构建可能包含Python版本更新，生产环境建议固定镜像标签以确保稳定性
• 如需扩展依赖，可通过requirements.txt配合pip install在容器启动时安装额外库