condaforge/miniforge-pypy3

miniforge-pypy3 Docker镜像文档

1. 镜像概述和主要用途

本镜像是基于最小化Ubuntu系统构建的Docker容器，预安装了conda-forge提供的https://github.com/conda-forge/miniforge%E5%AE%89%E8%A3%85%E5%99%A8%EF%BC%8C%E9%BB%98%E8%AE%A4%E5%AE%89%E8%A3%85%E8%B7%AF%E5%BE%84%E4%B8%BA%60/opt/conda%60%E3%80%82%E4%B8%BB%E8%A6%81%E7%94%A8%E9%80%94%E6%98%AF%E4%B8%BA%E7%94%A8%E6%88%B7%E6%8F%90%E4%BE%9B%E4%B8%80%E4%B8%AA%E5%BF%AB%E9%80%9F%E9%83%A8%E7%BD%B2%E5%9F%BA%E4%BA%8EPyPy3%E7%9A%84conda%E7%8E%AF%E5%A2%83%E7%9A%84%E5%9F%BA%E7%A1%80%E9%95%9C%E5%83%8F%EF%BC%8C%E7%AE%80%E5%8C%96%E5%BC%80%E5%8F%91%E3%80%81%E6%B5%8B%E8%AF%95%E5%8F%8A%E7%94%9F%E4%BA%A7%E7%8E%AF%E5%A2%83%E4%B8%ADPyPy3+conda%E7%8E%AF%E5%A2%83%E7%9A%84%E9%85%8D%E7%BD%AE%E6%B5%81%E7%A8%8B%E3%80%82

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），命令格式如下：

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

其中<标签>需替换为与官方miniforge发布一致的版本标签（如23.11.0-0，标签列表见https://github.com/conda-forge/miniforge/releases%EF%BC%89%E3%80%82

4.2 容器运行示例

4.2.1 基础交互式运行

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

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

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

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

4.2.2 挂载本地目录

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

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

4.2.3 自定义环境变量

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

bash
# 设置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示例，配置容器启动参数（含挂载目录和环境变量）：

yaml
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  # 启用交互式终端

启动命令：

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

4.4 标签说明

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

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

标签详情可参考https://github.com/conda-forge/miniforge/releases%E3%80%82

5. 构建代码地址

镜像构建代码开源托管于GitHub：https://github.com/conda-forge/miniforge-images