# mindformers-dockerfile

**Repository Path**: jimmyisme/mindformers-dockerfile

## Basic Information

- **Project Name**: mindformers-dockerfile
- **Description**: mindformers-dockerfile
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-02-09
- **Last Updated**: 2026-02-10

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# MindFormers Dockerfile

## 仓库用途
该仓库提供用于构建 MindFormers 训练环境的 Dockerfile 和版本配置，
可以在 Ascend 平台上快速搭建包含指定 MindSpore、CANN 及 Python 版本的镜像。

## 前置条件
- 已安装 Docker（推荐版本 `Docker version 26.1.4, build 5650f9b`）
- 可访问华为云/Ascend 软件源以下载 CANN、MindSpore 等依赖
- 已安装 `curl`、`jq` 等工具

## 参数说明
- `PYTHON_VERSION`：镜像中安装的 Python 版本
- `CANN_TOOLKIT_URL`：CANN Toolkit 安装包下载地址
- `CANN_KERNELS_URL`：CANN Kernels 安装包下载地址
- `MS_WHL_URL`：MindSpore 轮子包下载地址
- `MINDFORMERS_GIT_REF`：MindFormers 仓库的 Git 分支或标签

## 选择版本并构建
`versions.json` 列出了可用的版本及其参数，示例：

```bash
# 下载版本配置
curl -LO https://raw.githubusercontent.com/jimmyisme/mindformers-dockerfile/main/versions.json

# 查看可用版本
jq -r 'keys[]' versions.json

# 选择需要的版本
VERSION=r1.6.0_ms2.7.0-rc1_cann8.2.RC1_py3.11
```

构建镜像时将配置项作为 `--build-arg` 传入：

```bash
git clone https://gitee.com/jimmyisme/mindformers-dockerfile.git
cd mindformers-dockerfile
docker build --network host -t mindformers:${VERSION} \
  $(jq -r ".\"${VERSION}\" | to_entries | .[] | \"--build-arg \\(.key)=\\(.value)\"" versions.json) \
  -f Dockerfile.base .
```

## 运行示例

```bash
docker run --rm -it mindformers:${VERSION} bash
```