服务器上使用docker搭建gem5-gcn3环境

使用docker配置gem5-gcn3环境

3步：拉取镜像，编译gcn，测试square

1、拉取镜像

默认主机有梯子/代理，根据官网步骤 gem5 gpu：AMD VEGA GPU

docker pull ghcr.io/gem5-test/gcn-gpu:v23-1

报错：

Error response from daemon: Head "https://ghcr.io/v2/gem5-test/gcn-gpu/manifests/v23-1": denied

解决，需要在github上设置一下token信息，参考链接 关于容器注册表支持。设置步骤：

vim ~/.bashrc
export CR_PAT=YOUR_TOKEN
### 退出重新进入终端，或者
source ~/.bashrc
echo $CR_PAT | docker login ghcr.io -u USERNAME --password-stdin
### login success

重新拉取镜像，

docker pull ghcr.io/gem5-test/gcn-gpu:v23-1

报错： Error response from daemon: manifest unknown，清单未知。去gem5 github主页，查看gcn的package下的版本列表 gcn-gpu 。发现目前没有v23-1的版本，改为已经发布的最新的v23-0，重新拉取

docker pull ghcr.io/gem5-test/gcn-gpu:v23-0

2、环境编译

根据镜像创建一个gcn3-gpu的容器，然后进入容器。

docker run --net host -itd --name gcn3-gpu -v /home/wgs/gem5space/:/root/gem5space  ghcr.io/gem5/gcn-gpu:v23-0 bash
docker exec -w /root/gem5space -it gcn3-gpu bash

上面的一些参数说明：

docker run：
--net="bridge": 指定容器的网络连接类型，支持 bridge/host/none/container: 四种类型；
-i : 以交互模式运行容器，通常与 -t 同时使用；
-t : 为容器重新分配一个伪输入终端，通常与 -i 同时使用；
--volume , -v: 绑定一个卷
docker exec：
-i :即使没有附加也保持STDIN 打开
-t :分配一个伪终端
-w ：指定初始化的工作目录

描述一下后面的文件夹结构

gem5-space
	|--gem5
	|--gem5-resources

gem5的源码，可以从github gem5的历史版本中下载相应的源码压缩包，然后解压
gem5-resources可以从github上clone下来，

git clone https://github.com/gem5/gem5-resources.git

编译gem5-gcn3的部分：

cd gem5
scons build/GCN3_X86/gem5.opt -j 64

编译的输出如下

其他的一些说明：
如果想实现快速创建，进入或者删除容器，可以在主机的环境变量~/.bashrc中添加下面内容

alias cgcn3='docker run --net host -itd --name gcn3-gpu -v /home/wgs/gem5space/:/root/gem5space  ghcr.io/gem5/gcn-gpu:v23-0 bash'
alias egcn3='docker exec -w /root/gem5space -it gcn3-gpu bash'
alias dgcn3='docker stop gcn3-gpu; docker rm -f gcn3-gpu'

在主机终端分别执行cgn3/egcn3/dgcn3可以实现，对容器的创建/进入/删除操作。
进入容器，可以通过下面操作修改终端的显示彩色

apt update & apt install vim
vim ~/.barshrc
# 在vim命令中输入： j 64，跳转到第64行
# 取消第39行的注释
#force_color_prompt=yes

3、测试square

square在github上的介绍和测试流程 square

# pwd: /root/gem5space
cd gem5-resources/src/gpu/square
make
# Warning: The specified HIP target: gfx902 is unknown. Correct compilation is not guaranteed.
cd -
gem5/build/GCN3_X86/gem5.opt gem5/configs/example/apu_se.py -n 3 -c gem5-resources/src/gpu/square/bin/square

成功运行后的输出如下：

info: check result
PASSED!
Ticks: 139906310500
Exiting because  exiting with last active thread context

运行时会有一些warning，而且也需要等待一小段时间。

其他的情况说明

docker官网有一个版本的gem5-gcn3， 地址docker官网 gcn3。这个版本可以编译，但是运行起来会有报错，不太清楚这个docker里面环境什么情况。而且是两年前的一个版本。