PDS docker CI环境搭建分享

aozima

1. 系统及镜像选择
官网下载的软件名称为 PDS_2022.2-SP6.7-ads-CentOS7.3-x64.tar.gz
所以应该使用 CentOS7.3 ，或使用对应的docker镜像

1. docker pull centos:7.3.1611

复制代码

2. LIC适配
因为docker中MAC地址是随机的，所以可以使用 --mac-address 参数来设置为和授权机器一致。

示例：

1. docker run --mac-address xx:xx:xx:xx:xx:xx centos:7.3.1611

复制代码

其实这种用法，理论上讲是不合规的。建议使用网络浮动许可。

3. 运行
3.1 基础库依赖和UI显示
因为在docker中运行默认是没有UI显示的，但pds是基于QT的UI软件，因此可以指定VNC的方式来进行显示。
可以在运行docker时，把5900端口映射出来，这样就可以使用VNC客户端来连接了。

但在运行时提示缺少libGL，在线安装即可。安装前最好设置下镜像源，以提高网络速度。

1. curl -o /etc/yum.repos.d/CentOS-Base.repo http://mirrors.cloud.tencent.com/repo/centos7_base.repo
   
2. 
   
3. yum clean all
   
4. time yum makecache
   
5. 
   
6. # error while loading shared libraries: libGL.so.1
   
7. time yum install -y mesa-libGL

复制代码

3.2 命令行程序及参数

根据PDF上面的示例，指定run参数来运行，然后通过VNC连接上去。
发现工程确实打开了，但并没有RUN。

1. export QT_QPA_PLATFORM=vnc
   
2. 
   
3. pds -continue -project led_PGL22G.pds -run gen_bit_stream

复制代码

后面发现还有个pds_shell，测试这个可以运行编译和综合，也不需要UI界面。

1. time pds_shell -project led_PGL22G.pds -run gen_bit_stream

复制代码

4. 总结
- 支持在docker中运行，可以方便在linux上面使用，不需要给宿主机安装单独的系统。
- 支持在docker中运行，方便部署CI，由服务器来生成FPGA固件，避免本地开发环境差异，以及漏提交代码，规范管理。
- CI环境中可以自动生成详细的版本信息，并内嵌到固件中，方便管理和识别。