miniforge-pypy3 Docker镜像文档

1. 镜像概述和主要用途

本镜像是基于最小化Ubuntu系统构建的Docker容器，预安装了conda-forge提供的miniforge-pypy3安装器，默认安装路径为/opt/conda。主要用途是为用户提供一个快速部署基于PyPy3的conda环境的基础镜像，简化开发、测试及生产环境中PyPy3+conda环境的配置流程。

2. 核心功能和特性

• 精简基础系统：基于最小化Ubuntu构建，镜像体积精简，减少资源占用。
• 预配置环境：内置miniforge-pypy3安装器，无需手动安装，开箱即可使用conda命令。
• 跨架构支持：支持amd64、arm64和ppc64le三种架构，适配多种硬件平台。
• 版本对齐：镜像标签与官方miniforge发布标签完全一致，便于版本管理和环境一致性控制。

3. 使用场景和适用范围

• 快速开发环境搭建：需要快速初始化基于PyPy3的conda环境的开发场景，避免手动配置conda和PyPy3。
• 跨架构部署：在amd64（x86_64）、arm64（如ARM服务器、树莓派）或ppc64le（PowerPC）架构下部署依赖PyPy3和conda的应用。
• 版本一致性需求：需与官方miniforge版本严格对齐的测试或生产环境，确保依赖版本可控。

4. 使用方法和配置说明

4.1 镜像拉取

镜像可通过Docker Hub或其他容器仓库拉取（具体仓库名称需参考官方发布，通常为conda-forge/miniforge-pypy3），命令格式如下：

docker pull conda-forge/miniforge-pypy3:<标签>

其中<标签>需替换为与官方miniforge发布一致的版本标签（如23.11.0-0，标签列表见官方miniforge发布页）。

4.2 容器运行示例

4.2.1 基础交互式运行

启动容器并进入交互式终端，验证conda环境：

docker run -it --rm conda-forge/miniforge-pypy3:<标签> /bin/bash

进入容器后，可通过以下命令验证安装：

conda --version  # 输出conda版本
pypy3 --version  # 输出PyPy3版本

4.2.2 挂载本地目录

将本地工作目录挂载到容器内，便于文件共享（例如挂载当前目录到容器/workspace）：

docker run -it --rm -v $(pwd):/workspace conda-forge/miniforge-pypy3:<标签> /bin/bash

4.2.3 自定义环境变量

可通过-e参数设置环境变量，自定义conda行为（如修改包缓存路径、默认环境等）。例如：

# 设置conda包缓存路径为/opt/conda/pkgs
docker run -it --rm -e CONDA_PKGS_DIRS=/opt/conda/pkgs conda-forge/miniforge-pypy3:<标签> /bin/bash

4.3 docker-compose配置示例

以下为docker-compose.yml示例，配置容器启动参数（含挂载目录和环境变量）：

version: '3'
services:
  miniforge-pypy3:
    image: conda-forge/miniforge-pypy3:<标签>  # 替换为实际标签，如23.11.0-0
    volumes:
      - ./local_workspace:/workspace  # 本地目录挂载到容器/workspace
    environment:
      - CONDA_PREFIX=/opt/conda  # conda默认安装路径（镜像内置，可省略）
      - PYTHONPATH=/workspace  # 添加工作目录到Python路径
    tty: true  # 启用交互式终端

启动命令：

docker-compose up -d  # 后台运行
docker-compose exec miniforge-pypy3 /bin/bash  # 进入容器终端

4.4 标签说明

镜像标签严格遵循官方miniforge的发布标签，例如：

• 官方发布版本23.11.0-0对应镜像标签23.11.0-0
• 最新稳定版可使用标签latest（通常指向最新官方发布版本）

标签详情可参考官方miniforge发布页。

5. 构建代码地址

镜像构建代码开源托管于GitHub：[***]