From 2be7e5ac1eaa161aeee448dd9e555a111af3dd5e Mon Sep 17 00:00:00 2001 From: anisha-amd Date: Tue, 9 Dec 2025 11:41:43 -0500 Subject: [PATCH] Docs: verl framework - compatibility - 25.11 release (#5752) --- .../compatibility-matrix-historical-6.0.csv | 2 +- docs/compatibility/compatibility-matrix.rst | 2 +- .../ml-compatibility/verl-compatibility.rst | 76 +++++++++++++------ 3 files changed, 53 insertions(+), 27 deletions(-) diff --git a/docs/compatibility/compatibility-matrix-historical-6.0.csv b/docs/compatibility/compatibility-matrix-historical-6.0.csv index 04611b6c3..0d9476a3b 100644 --- a/docs/compatibility/compatibility-matrix-historical-6.0.csv +++ b/docs/compatibility/compatibility-matrix-historical-6.0.csv @@ -33,7 +33,7 @@ ROCm Version,7.1.1,7.1.0,7.0.2,7.0.1/7.0.0,6.4.3,6.4.2,6.4.1,6.4.0,6.3.3,6.3.2,6 :doc:`PyTorch <../compatibility/ml-compatibility/pytorch-compatibility>`,"2.9, 2.8, 2.7","2.8, 2.7, 2.6","2.8, 2.7, 2.6","2.7, 2.6, 2.5","2.6, 2.5, 2.4, 2.3","2.6, 2.5, 2.4, 2.3","2.6, 2.5, 2.4, 2.3","2.6, 2.5, 2.4, 2.3","2.4, 2.3, 2.2, 1.13","2.4, 2.3, 2.2, 1.13","2.4, 2.3, 2.2, 1.13","2.4, 2.3, 2.2, 2.1, 2.0, 1.13","2.3, 2.2, 2.1, 2.0, 1.13","2.3, 2.2, 2.1, 2.0, 1.13","2.3, 2.2, 2.1, 2.0, 1.13","2.3, 2.2, 2.1, 2.0, 1.13","2.1, 2.0, 1.13","2.1, 2.0, 1.13","2.1, 2.0, 1.13","2.1, 2.0, 1.13","2.1, 2.0, 1.13","2.1, 2.0, 1.13" :doc:`TensorFlow <../compatibility/ml-compatibility/tensorflow-compatibility>`,"2.20.0, 2.19.1, 2.18.1","2.20.0, 2.19.1, 2.18.1","2.19.1, 2.18.1, 2.17.1 [#tf-mi350-past-60]_","2.19.1, 2.18.1, 2.17.1 [#tf-mi350-past-60]_","2.18.1, 2.17.1, 2.16.2","2.18.1, 2.17.1, 2.16.2","2.18.1, 2.17.1, 2.16.2","2.18.1, 2.17.1, 2.16.2","2.17.0, 2.16.2, 2.15.1","2.17.0, 2.16.2, 2.15.1","2.17.0, 2.16.2, 2.15.1","2.17.0, 2.16.2, 2.15.1","2.16.1, 2.15.1, 2.14.1","2.16.1, 2.15.1, 2.14.1","2.16.1, 2.15.1, 2.14.1","2.16.1, 2.15.1, 2.14.1","2.15.0, 2.14.0, 2.13.1","2.15.0, 2.14.0, 2.13.1","2.15.0, 2.14.0, 2.13.1","2.15.0, 2.14.0, 2.13.1","2.14.0, 2.13.1, 2.12.1","2.14.0, 2.13.1, 2.12.1" :doc:`JAX <../compatibility/ml-compatibility/jax-compatibility>`,0.7.1,0.7.1,0.6.0,0.6.0,0.4.35,0.4.35,0.4.35,0.4.35,0.4.31,0.4.31,0.4.31,0.4.31,0.4.26,0.4.26,0.4.26,0.4.26,0.4.26,0.4.26,0.4.26,0.4.26,0.4.26,0.4.26 - :doc:`verl <../compatibility/ml-compatibility/verl-compatibility>` [#verl_compat-past-60]_,N/A,N/A,N/A,N/A,N/A,N/A,N/A,N/A,N/A,N/A,N/A,N/A,N/A,N/A,N/A,0.3.0.post0,N/A,N/A,N/A,N/A,N/A,N/A + :doc:`verl <../compatibility/ml-compatibility/verl-compatibility>` [#verl_compat-past-60]_,N/A,N/A,N/A,0.6.0,N/A,N/A,N/A,N/A,N/A,N/A,N/A,N/A,N/A,N/A,N/A,0.3.0.post0,N/A,N/A,N/A,N/A,N/A,N/A :doc:`Stanford Megatron-LM <../compatibility/ml-compatibility/stanford-megatron-lm-compatibility>` [#stanford-megatron-lm_compat-past-60]_,N/A,N/A,N/A,N/A,N/A,N/A,N/A,N/A,N/A,N/A,N/A,85f95ae,N/A,N/A,N/A,N/A,N/A,N/A,N/A,N/A,N/A,N/A :doc:`DGL <../compatibility/ml-compatibility/dgl-compatibility>` [#dgl_compat-past-60]_,N/A,N/A,N/A,2.4.0,2.4.0,N/A,N/A,2.4.0,N/A,N/A,N/A,N/A,N/A,N/A,N/A,N/A,N/A,N/A,N/A,N/A,N/A,N/A :doc:`Megablocks <../compatibility/ml-compatibility/megablocks-compatibility>` [#megablocks_compat-past-60]_,N/A,N/A,N/A,N/A,N/A,N/A,N/A,N/A,N/A,N/A,N/A,0.7.0,N/A,N/A,N/A,N/A,N/A,N/A,N/A,N/A,N/A,N/A diff --git a/docs/compatibility/compatibility-matrix.rst b/docs/compatibility/compatibility-matrix.rst index d156df1e9..7589453eb 100644 --- a/docs/compatibility/compatibility-matrix.rst +++ b/docs/compatibility/compatibility-matrix.rst @@ -241,7 +241,7 @@ Expand for full historical view of: .. [#os-compatibility-past-60] Some operating systems are supported on limited GPUs. For detailed information, see :ref:`supported_distributions` and select the required ROCm version for version specific support. .. [#gpu-compatibility-past-60] Some GPUs have limited operating system support. For detailed information, see :ref:`supported_GPUs` and select the required ROCm version for version specific support. .. [#tf-mi350-past-60] TensorFlow 2.17.1 is not supported on AMD Instinct MI350 Series GPUs. Use TensorFlow 2.19.1 or 2.18.1 with MI350 Series GPUs instead. - .. [#verl_compat-past-60] verl is supported only on ROCm 6.2.0. + .. [#verl_compat-past-60] verl is supported only on ROCm 7.0.0 and 6.2.0. .. [#stanford-megatron-lm_compat-past-60] Stanford Megatron-LM is supported only on ROCm 6.3.0. .. [#dgl_compat-past-60] DGL is supported only on ROCm 7.0.0, ROCm 6.4.3 and ROCm 6.4.0. .. [#megablocks_compat-past-60] Megablocks is supported only on ROCm 6.3.0. diff --git a/docs/compatibility/ml-compatibility/verl-compatibility.rst b/docs/compatibility/ml-compatibility/verl-compatibility.rst index d4936a0ec..a4b10b5c0 100644 --- a/docs/compatibility/ml-compatibility/verl-compatibility.rst +++ b/docs/compatibility/ml-compatibility/verl-compatibility.rst @@ -31,7 +31,7 @@ Support overview - To get started and install verl on ROCm, use the prebuilt :ref:`Docker image `, which includes ROCm, verl, and all required dependencies. - - See the :doc:`ROCm verl installation guide ` + - See the :doc:`ROCm verl installation guide ` for installation and setup instructions. - You can also consult the upstream `verl documentation `__ @@ -40,7 +40,8 @@ Support overview Version support -------------------------------------------------------------------------------- -verl is supported on `ROCm 6.2.0 `__. +verl is supported on `ROCm 7.0.0 `__ and +`ROCm 6.2.0 `__. Supported devices -------------------------------------------------------------------------------- @@ -57,7 +58,7 @@ Use cases and recommendations GPUs with verl and ROCm Integration `__ blog. The blog post outlines how the Volcano Engine Reinforcement Learning (verl) framework integrates with the AMD ROCm platform to optimize training on - Instinct™ MI300X GPUs. The guide details the process of building a Docker image, + AMD Instinct™ GPUs. The guide details the process of building a Docker image, setting up single-node and multi-node training environments, and highlights performance benchmarks demonstrating improved throughput and convergence accuracy. This resource serves as a comprehensive starting point for deploying verl on AMD GPUs, @@ -79,12 +80,20 @@ The following table shows verl on ROCm support for GPU-accelerated modules. - ROCm version * - ``FSDP`` - Training engine - - 0.3.0.post0 - - 6.2.0 + - + * 0.6.0 + * 0.3.0post0 + - + * 7.0.0 + * 6.2.0 * - ``vllm`` - Inference engine - - 0.3.0.post0 - - 6.2.0 + - + * 0.6.0 + * 0.3.0post0 + - + * 7.0.0 + * 6.2.0 .. _verl-docker-compat: @@ -95,28 +104,45 @@ Docker image compatibility -AMD validates and publishes ready-made `verl Docker images `_ +AMD validates and publishes `verl Docker images `_ with ROCm backends on Docker Hub. The following Docker image tag and associated inventories represent the latest verl version from the official Docker Hub. Click |docker-icon| to view the image on Docker Hub. -.. list-table:: - :header-rows: 1 +.. list-table:: + :header-rows: 1 + :class: docker-image-compatibility - * - Docker image - - ROCm - - verl - - Ubuntu - - Pytorch - - Python - - vllm + * - Docker image + - ROCm + - verl + - Ubuntu + - PyTorch + - Python + - vllm - * - .. raw:: html + * - .. raw:: html - rocm/verl - - `6.2.0 `_ - - `0.3.0post0 `_ - - 20.04 - - `2.5.0 `_ - - `3.9.19 `_ - - `0.6.3 `_ + rocm/verl + - `7.0.0 `__ + - `0.6.0 `__ + - 22.04 + - `2.9.0 `__ + - `3.12.11 `__ + - `0.11.0 `__ + + * - .. raw:: html + + rocm/verl + - `6.2.0 `__ + - `0.3.0post0 `__ + - 20.04 + - `2.5.0 `__ + - `3.9.19 `__ + - `0.6.3 `__ + + +Previous versions +=============================================================================== +See :doc:`rocm-install-on-linux:install/3rd-party/previous-versions/verl-history` to find documentation for previous releases +of the ``ROCm/verl`` Docker image.