chrisham/amzn2023-pyenv

chrisham/amzn2023-pyenv 镜像说明

镜像概述

本Docker镜像基于官方Amazon Linux 2023构建，利用pyenv工具实现多Python版本管理及多用户独立虚拟环境，兼容Apple Silicon Mac的Docker环境和ARM64架构云实例，为各类Python项目提供稳定可靠的运行基础。

核心功能

1. 多版本Python管理：通过pyenv安装、切换不同Python版本（如3.9.x、3.11.x等）
2. 多用户独立环境：支持为每个用户分配特定Python版本及独立虚拟环境
3. 架构兼容性：适配ARM64架构，可在Apple Silicon Mac及ARM云实例上高效运行
4. 广泛应用支持：适用于*** Bot、Web框架（FastAPI/Flask/Django）、机器学习、Excel/PDF生成等场景

使用场景

• *** Bot开发与部署
• FastAPI/Flask/Django Web应用构建
• 机器学习项目环境搭建
• Excel/PDF文件生成工具开发
• 多版本Python测试环境创建

配置说明

运行镜像示例

shell
docker run -it --hostname amzn2023 --name amzn2023-pyenv docker.xuanyuan.run/chrisham/amzn2023-pyenv /bin/bash

安装指定Python版本

若所需版本未预装，可执行以下命令安装：

shell
pyenv install 3.12.x

添加用户并分配虚拟环境

1. 创建用户：

shell
[root@amzn2023 ~]# adduser {用户名}

2. 查看可用Python版本：

shell
[root@amzn2023 ~]# pyenv versions
  system
* 3.9.18 (set by /usr/local/pyenv/version)
  3.11.8

3. 设置全局Python版本：

shell
[root@amzn2023 ~]# pyenv global {选择的Python版本}

4. 切换到新用户并创建虚拟环境：

shell
[root@amzn2023 ~]# su - {用户名}
{用户名}$ python -m venv {虚拟环境文件夹名}
# 示例：{用户名}$ python -m venv .venv

虚拟环境管理命令

• 激活虚拟环境：

shell
source {虚拟环境文件夹路径}/bin/activate

• 退出虚拟环境：

shell
deactivate

基础使用示例

1. 版本切换演示：

shell
[root@amzn2023 ~]# python -V
Python 3.9.18
[root@amzn2023 ~]# source /home/pytest/venv/bin/activate
(venv) [root@amzn2023 ~]# python -V
Python 3.11.8
(venv) [root@amzn2023 ~]# deactivate
[root@amzn2023 ~]#

2. 用户环境示例：

shell
[root@amzn2023 ~]# su - pytest
(venv) [pytest@amzn2023 ~]$ pip list
Package    Version
---------- -------
pip        24.0
setuptools 65.5.0
(venv) [pytest@amzn2023 ~]$

时区设置

若需修改时区，执行以下命令（以首尔时区为例）：

shell
ln -sf /usr/share/zoneinfo/Asia/Seoul /etc/localtime