thelay/al2py Docker 镜像 - 轩辕镜像

Amazon Linux 2 with Python 镜像文档

1. 镜像概述

Amazon Linux 2 with Python是一款基于Amazon Linux 2操作系统的Docker镜像，预集成Python运行环境。该镜像旨在为Python应用程序提供与Amazon Linux 2兼容的标准化运行时，简化开发、测试和部署流程，特别适合需要依托Amazon Linux 2生态的Python项目。

2. 核心功能与特性

2.1 基础环境特性

• 稳定底层系统：基于Amazon Linux 2稳定版本构建，遵循长期支持(LTS)策略，提供可靠的系统环境
• 预配置Python环境：内置Python解释器及基础工具链(pip)，可直接运行Python代码
• 生态兼容性：兼容Amazon Linux 2的系统库、包管理器(yum)及工具链，支持Amazon Linux 2特有的依赖项安装

2.2 实用功能

• 轻量级设计：在保证功能完整性的前提下优化镜像体积，减少资源占用
• 灵活扩展：支持通过yum/pip安装额外系统依赖或Python包，满足定制化需求
• 多场景适配：兼容Docker、Kubernetes等主流容器化部署平台

3. 使用场景与适用范围

3.1 开发与测试

• Python应用程序的本地开发环境搭建
• 跨平台测试Amazon Linux 2环境下的Python代码兼容性
• 快速验证Python脚本在类生产环境中的运行状态

3.2 部署与运维

• 运行需要Amazon Linux 2系统环境的Python服务
• CI/CD流水线中的构建、测试环节集成
• 微服务架构中Python组件的容器化部署

3.3 其他场景

• 临时Python运行环境（如脚本执行、数据处理任务）
• 教学或演示环境快速搭建
• 与Amazon Web Services(AWS)服务集成的Python应用部署

4. 使用方法与配置说明

4.1 基本使用（docker run）

4.1.1 查看Python版本

bash
docker run --rm amazonlinux:2-with-python python --version

说明：--rm参数表示容器退出后自动删除，适合临时任务

4.1.2 运行Python交互式终端

bash
docker run -it --rm amazonlinux:2-with-python python

说明：-it参数提供交互终端，进入Python REPL环境，可直接执行Python代码

4.2 运行本地Python脚本

4.2.1 挂载本地目录并执行脚本

假设本地存在/path/to/project/app.py，执行：

bash
docker run -it --rm -v /path/to/project:/app -w /app amazonlinux:2-with-python python app.py

参数说明：

• -v /path/to/project:/app：将本地项目目录挂载到容器内/app目录
• -w /app：设置容器工作目录为/app

4.3 容器交互与环境定制

4.3.1 进入容器bash终端

bash
docker run -it --rm amazonlinux:2-with-python /bin/bash

进入后可执行系统命令或Python操作：

bash
# 查看系统版本
cat /etc/os-release

# 安装系统依赖（示例：安装gcc）
yum install -y gcc

# 安装Python包（示例：安装requests）
pip install requests

4.3.2 通过Dockerfile构建自定义镜像

如需固化依赖，可创建Dockerfile：

dockerfile
FROM amazonlinux:2-with-python

# 安装系统依赖
RUN yum install -y gcc && yum clean all

# 安装Python依赖
RUN pip install --no-cache-dir requests pandas

# 设置工作目录
WORKDIR /app

# 复制应用代码
COPY . /app

# 运行命令
CMD ["python", "app.py"]

构建并运行：

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

4.4 docker-compose配置示例

创建docker-compose.yml：

yaml
version: '3.8'

services:
  python-service:
    image: amazonlinux:2-with-python
    volumes:
      - ./src:/app  # 挂载本地源代码目录
    working_dir: /app
    command: python main.py  # 启动命令
    environment:
      - PYTHONUNBUFFERED=1  # 实时输出Python日志
      - APP_ENV=production  # 自定义环境变量
    restart: unless-stopped  # 故障自动重启策略

启动服务：

bash
docker-compose up -d

5. 注意事项

• 版本管理：镜像标签可能对应不同Python版本（如2-with-python3.9），使用前建议通过官方渠道确认具体版本信息
• 依赖管理：生产环境建议通过Dockerfile固化依赖，避免运行时动态安装导致环境不一致
• 安全更新：定期更新基础镜像以获取Amazon Linux 2的安全补丁和系统更新
• 资源限制：部署时建议根据应用需求配置容器CPU/内存限制，避免资源过度占用
• 数据持久化：敏感数据或需要持久化的文件需通过卷(volume)挂载，避免存储在容器内部

6. 扩展说明

• 镜像维护：由Amazon官方或可信第三方维护，具体更新策略请参考镜像发布渠道
• 兼容性：与Amazon Linux 2系统的包管理工具(yum)和Python生态完全兼容
• 更多用法：支持通过docker exec进入运行中容器、通过docker cp传输文件等标准Docker操作