使用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里面环境什么情况。而且是两年前的一个版本。