From 1613b100a5bd3586fe03ffc8629dcfd5ae2759ea Mon Sep 17 00:00:00 2001 From: Clara Berendsen <42071084+claraberendsen@users.noreply.github.com> Date: Fri, 18 Jul 2025 12:07:23 -0300 Subject: [PATCH 1/2] Update testing installation docs to use ros-apt-source package (#5783) * Update testing installation docs to use ros-apt-source package ---- - Mirror changes done on kilted for deb testing installation - Include new section with RPM testing repository configuration * fix lint errors * truly fix lint errors * Fix D000 error on test * Use console instead of bash Co-authored-by: Christophe Bedard Signed-off-by: Clara Berendsen <42071084+claraberendsen@users.noreply.github.com> * use console instead of bash Co-authored-by: Christophe Bedard Signed-off-by: Clara Berendsen <42071084+claraberendsen@users.noreply.github.com> * fix error with link Co-authored-by: Christophe Bedard Signed-off-by: Clara Berendsen <42071084+claraberendsen@users.noreply.github.com> * use console instead of bash Co-authored-by: Christophe Bedard Signed-off-by: Clara Berendsen <42071084+claraberendsen@users.noreply.github.com> * Use one sentence per line Co-authored-by: Christophe Bedard Signed-off-by: Clara Berendsen <42071084+claraberendsen@users.noreply.github.com> --------- Signed-off-by: Clara Berendsen <42071084+claraberendsen@users.noreply.github.com> Co-authored-by: Christophe Bedard (cherry picked from commit 9a74c30ecdd196c67867fbe2ece1ca9fc80879fc) # Conflicts: # source/Installation/Testing.rst --- source/Installation/Testing.rst | 68 +++++++++++++++++++++++++++++---- 1 file changed, 61 insertions(+), 7 deletions(-) diff --git a/source/Installation/Testing.rst b/source/Installation/Testing.rst index a1290f8e869..7242575b334 100644 --- a/source/Installation/Testing.rst +++ b/source/Installation/Testing.rst @@ -10,28 +10,37 @@ Usually, you will get the released version of binaries when following :doc:`../I There are also pre-released versions of binaries that are useful for testing before making an official release. This article describes several options if you would like to try out pre-released versions of ROS binaries. -deb testing repository ----------------------- - When packages are released into a ROS distribution (using bloom), the buildfarm builds them into deb packages which are stored temporarily in the **building** apt repository. As dependent packages are rebuilt, an automatic process periodically synchronizes the packages in **building** to a secondary repository called **ros-testing**. **ros-testing** is intended as a soaking area where developers and bleeding-edge users may give the packages extra testing, before they are manually synced into the public ros repository from which users typically install packages. Approximately every two weeks, the rosdistro's release manager manually synchronizes the contents of **ros-testing** into the **main** ROS repository. +deb testing repository +---------------------- + For Debian-based operating systems, you can install binary packages from the **ros-testing** repository. 1. Make sure you have a working ROS 2 installation from deb packages (see :doc:`../Installation`). +<<<<<<< HEAD 2. Edit (with sudo) the file ``/etc/apt/sources.list.d/ros2.list`` and change ``ros2`` with ``ros2-testing``. For example, on Ubuntu Jammy the contents should look like the following: +======= +2. Install the ros2-testing-apt-source package. + This will automatically uninstall the ros2-apt-source package since only one repository may be enabled at a time. +>>>>>>> 9a74c30 (Update testing installation docs to use ros-apt-source package (#5783)) - .. code-block:: bash + .. code-block:: console +<<<<<<< HEAD # deb http://packages.ros.org/ros2/ubuntu jammy main deb http://packages.ros.org/ros2-testing/ubuntu jammy main +======= + $ sudo apt install -y ros2-testing-apt-source +>>>>>>> 9a74c30 (Update testing installation docs to use ros-apt-source package (#5783)) -3. Update the ``apt`` index: +3. Update the apt index: .. code-block:: console @@ -49,12 +58,16 @@ For Debian-based operating systems, you can install binary packages from the **r $ sudo apt dist-upgrade -6. Once you are finished testing, you can switch back to the normal repository by changing back the contents of ``/etc/apt/sources.list.d/ros2.list``: +6. Once you are finished testing, you can switch back to the normal repository by re-installing the ros-apt-source package: - .. code-block:: bash + .. code-block:: console +<<<<<<< HEAD deb http://packages.ros.org/ros2/ubuntu jammy main # deb http://packages.ros.org/ros2-testing/ubuntu jammy main +======= + $ sudo apt install -y ros2-apt-source +>>>>>>> 9a74c30 (Update testing installation docs to use ros-apt-source package (#5783)) and doing an update and upgrade: @@ -63,6 +76,47 @@ For Debian-based operating systems, you can install binary packages from the **r $ sudo apt update $ sudo apt dist-upgrade + +RHEL testing repository +----------------------- + +For RHEL you can install binary packages from the **ros-testing** repository, by enabling the testing repository on the source configuration: + +1. Make sure you have a working ROS 2 installation for rpm packages (see the :doc:`RHEL installation instructions `). + +2. Enable testing and disable main repository: + + .. code-block:: console + + $ sudo dnf config-manager setopt ros2-testing.enabled=1 + $ sudo dnf config-manager setopt ros2.enabled=0 + +3. Update the dnf index: + + .. code-block:: console + + $ sudo dnf update + +4. You can now install individual packages from the testing repository, for example: + + .. code-block:: console + + $ sudo dnf install ros-{DISTRO}-my-just-released-package + +5. Once you are finished testing, you can switch back to the normal repository by re-enabling the main repository: + + .. code-block:: console + + $ sudo dnf config-manager setopt ros2-testing.enabled=0 + $ sudo dnf config-manager setopt ros2.enabled=1 + + and doing an update and upgrade: + + .. code-block:: console + + $ sudo dnf update + $ sudo dnf system-upgrade + .. _Prerelease_binaries: Binary archives From b9142c00bc85f0a230570903c13c8df5da7acbfa Mon Sep 17 00:00:00 2001 From: "Tomoya.Fujita" Date: Fri, 18 Jul 2025 10:28:55 -0700 Subject: [PATCH 2/2] resolve conflicts. Signed-off-by: Tomoya.Fujita --- source/Installation/Testing.rst | 15 --------------- 1 file changed, 15 deletions(-) diff --git a/source/Installation/Testing.rst b/source/Installation/Testing.rst index 7242575b334..c608d23c382 100644 --- a/source/Installation/Testing.rst +++ b/source/Installation/Testing.rst @@ -23,22 +23,12 @@ For Debian-based operating systems, you can install binary packages from the **r 1. Make sure you have a working ROS 2 installation from deb packages (see :doc:`../Installation`). -<<<<<<< HEAD -2. Edit (with sudo) the file ``/etc/apt/sources.list.d/ros2.list`` and change ``ros2`` with ``ros2-testing``. - For example, on Ubuntu Jammy the contents should look like the following: -======= 2. Install the ros2-testing-apt-source package. This will automatically uninstall the ros2-apt-source package since only one repository may be enabled at a time. ->>>>>>> 9a74c30 (Update testing installation docs to use ros-apt-source package (#5783)) .. code-block:: console -<<<<<<< HEAD - # deb http://packages.ros.org/ros2/ubuntu jammy main - deb http://packages.ros.org/ros2-testing/ubuntu jammy main -======= $ sudo apt install -y ros2-testing-apt-source ->>>>>>> 9a74c30 (Update testing installation docs to use ros-apt-source package (#5783)) 3. Update the apt index: @@ -62,12 +52,7 @@ For Debian-based operating systems, you can install binary packages from the **r .. code-block:: console -<<<<<<< HEAD - deb http://packages.ros.org/ros2/ubuntu jammy main - # deb http://packages.ros.org/ros2-testing/ubuntu jammy main -======= $ sudo apt install -y ros2-apt-source ->>>>>>> 9a74c30 (Update testing installation docs to use ros-apt-source package (#5783)) and doing an update and upgrade: