# PR #54112 完整报告

- 仓库：`vllm-project/vllm`
- 标题：[ROCm] [Docker] Upgrade default AINIC repo to ship libionic 54.0-187-1
- 合并时间：2026-09-09 03:21
- 原文链接：http://prhub.com.cn/vllm-project/vllm/pull/54112

---

## 执行摘要
本 PR 升级了 vLLM ROCm Docker 镜像中 AINIC（AMD Pensando Pollara）用户空间库的默认版本，从 `1.117.3-hydra` 至 `1.117.5`，以内置支持 MoRI-EP 和 NIXL 功能所必需的 `libionic1=54.0-187-1` 库。变更涉及两个 Dockerfile 和一份功能文档，属于低风险的基础设施维护与功能支持更新。

## 功能与动机
该变更是为了在 AMD Pollara/AINIC 硬件上启用 MoRI-EP（MORI-EP）和 NIXL（NVIDIA Inference Cross-Link）功能。PR body 明确指出，新版本库（`libionic1=54.0-187-1`）是“required for MoRI-EP and NIXL on Pollara/AINIC without mounting host userspace libraries”，即为了避免用户手动挂载主机用户空间库的麻烦。更新后的文档也同步说明了新版本与特定内核模块驱动（`ionic-dkms=26.03.3.001`）的兼容性。

## 实现拆解

1. **更新 Docker 构建配置**：在 `docker/Dockerfile.rocm` 和 `docker/Dockerfile.rocm_gfx1250` 中，将构建参数 `AINIC_VERSION` 的值从 `1.117.3-hydra` 更改为 `1.117.5`。同时更新了参数上方的注释，明确标注新版本关联的内核模块驱动和用户空间库版本，以及其用途（MoRI-EP/NIXL）。
2. **同步功能文档**：修改 `docs/features/moriio_connector_usage.md` 中关于官方镜像预装 AINIC 库的描述。将版本号更正为 `1.117.5`，并补充了其携带的具体库版本（`libionic1=54.0-187-1`）和测试通过的内核模块版本（`ionic-dkms=26.03.3.001`）。
3. **测试与配套**：此变更是纯粹的依赖版本号和文档更新，不涉及应用逻辑，因此没有配套的测试用例修改。验证依赖于 CI 构建成功和后续社区在真实硬件上的集成测试。

### 无。本 PR 的变更均为配置和文档，无需展示关键源码片段。

## 评论区精华
- **CI 验证**：多位维护者（dllehr-amd, AndreasKaratzas）主动触发 CI 构建以验证变更。这是此类依赖升级 PR 的标准流程。
- **批准决策**：在 CI 构建通过后，reviewer `dllehr-amd` 给出了简洁的批准（`Looks good to me!`），表明变更清晰且符合预期。

## 风险与影响
- **技术风险**：主要风险在于新版本 AINIC 用户空间库（`libionic1=54.0-187-1`）与用户主机上可能存在的旧版内核模块（如 `ionic-dkms`）不兼容。但 PR 文档已明确注明了测试通过的版本，用户可据此自查环境，风险可控。
- **影响范围**：直接影响使用 vLLM 官方 ROCm Docker 镜像的用户，特别是计划在 AMD Pollara/AINIC 硬件上部署 MoRI-EP 或 NIXL 功能的用户。新镜像将开箱支持这些功能，简化部署。
- **回归风险**：由于是依赖升级，理论上存在新库影响现有功能的可能。但鉴于该库主要服务于特定新硬件功能，且变更范围极小，回归概率较低。

## 关联脉络
此 PR 是 vLLM 对 ROCm 平台硬件支持的持续完善。它独立于近期的其他 PR，但反映了项目对支持 AMD 最新硬件特性（如 Pollara/AINIC）的积极跟进。从历史 PR 列表看，近期有多个关于 ROCm 性能优化、内核修复和功能支持的 PR，此升级是其中的一个环节，旨在保持官方镜像的硬件功能完备性。