ROCm项目在Ubuntu 22.04上的安装问题分析与解决方案

在Ubuntu 22.04系统上安装ROCm 6.2.2版本的rocm-hip-runtime-dev软件包时，开发者可能会遇到依赖关系冲突的问题。这个问题特别容易在GitHub Actions的官方运行环境中出现，但在本地Ubuntu 20.04或22.04容器中却可以正常安装。

问题现象

当执行标准的ROCm安装流程时，系统会报告多个依赖关系不满足的错误。主要问题表现为：

• rocm-hip-runtime-dev需要特定版本的rocm-device-libs(1.0.0.60202-116~22.04)，但系统试图安装5.0.0-1版本
• 同样的情况也出现在rocm-cmake等依赖包上
• 最终导致安装失败，提示"无法修正问题，您持有损坏的软件包"

根本原因分析

经过深入调查，发现问题根源在于APT软件包管理器的优先级设置不正确。虽然开发者已经按照ROCm官方文档添加了软件源优先级配置，但由于格式问题，配置未能正确生效。

具体来说，在创建/etc/apt/preferences.d/rocm-pin-600文件时，使用了错误的转义字符格式，导致APT系统无法正确识别优先级设置。这使得系统仍然优先考虑Ubuntu官方仓库中的ROCm软件包，而非repo.radeon.com提供的版本。

解决方案

要解决这个问题，需要确保APT优先级配置文件采用正确的格式：

1. 使用echo -e命令确保换行符被正确解释
2. 文件内容应为三行格式，包含Package、Pin和Pin-Priority三个字段

正确的配置命令如下：

echo -e 'Package: *\nPin: release o=repo.radeon.com\nPin-Priority: 600' \
    | sudo tee /etc/apt/preferences.d/rocm-pin-600

配置完成后，执行apt update更新软件包列表，然后再次尝试安装rocm-hip-runtime-dev。

验证方法

为确保配置已正确生效，可以通过以下方法验证：

1. 检查配置文件内容：

cat /etc/apt/preferences.d/rocm-pin-600

正确输出应为三行格式。

2. 使用apt policy命令检查软件源优先级：

apt policy

在输出中，repo.radeon.com的优先级应显示为600。

总结

在Ubuntu系统上安装ROCm时，正确的APT优先级配置至关重要。特别是在自动化环境如GitHub Actions中，更需要注意命令格式的准确性。通过确保优先级配置文件的正确格式，可以避免依赖关系冲突，顺利完成ROCm及其相关组件的安装。