Skip to content

Commit 2a90a94

Browse files
mergify[bot]claraberendsenfujitatomoya
authored
Update testing installation docs to use ros-apt-source package (backport #5783) (#5788)
* 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 <[email protected]> Signed-off-by: Clara Berendsen <[email protected]> * use console instead of bash Co-authored-by: Christophe Bedard <[email protected]> Signed-off-by: Clara Berendsen <[email protected]> * fix error with link Co-authored-by: Christophe Bedard <[email protected]> Signed-off-by: Clara Berendsen <[email protected]> * use console instead of bash Co-authored-by: Christophe Bedard <[email protected]> Signed-off-by: Clara Berendsen <[email protected]> * Use one sentence per line Co-authored-by: Christophe Bedard <[email protected]> Signed-off-by: Clara Berendsen <[email protected]> --------- Signed-off-by: Clara Berendsen <[email protected]> Co-authored-by: Christophe Bedard <[email protected]> (cherry picked from commit 9a74c30) # Conflicts: # source/Installation/Testing.rst * resolve conflicts. Signed-off-by: Tomoya.Fujita <[email protected]> --------- Signed-off-by: Tomoya.Fujita <[email protected]> Co-authored-by: Clara Berendsen <[email protected]> Co-authored-by: Tomoya.Fujita <[email protected]>
1 parent b3ffedd commit 2a90a94

File tree

1 file changed

+49
-8
lines changed

1 file changed

+49
-8
lines changed

source/Installation/Testing.rst

Lines changed: 49 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -10,27 +10,27 @@ Usually, you will get the released version of binaries when following :doc:`../I
1010
There are also pre-released versions of binaries that are useful for testing before making an official release.
1111
This article describes several options if you would like to try out pre-released versions of ROS binaries.
1212

13-
deb testing repository
14-
----------------------
15-
1613
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.
1714
As dependent packages are rebuilt, an automatic process periodically synchronizes the packages in **building** to a secondary repository called **ros-testing**.
1815
**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.
1916

2017
Approximately every two weeks, the rosdistro's release manager manually synchronizes the contents of **ros-testing** into the **main** ROS repository.
2118

19+
deb testing repository
20+
----------------------
21+
2222
For Debian-based operating systems, you can install binary packages from the **ros-testing** repository.
2323

2424
1. Make sure you have a working ROS 2 installation from deb packages (see :doc:`../Installation`).
2525

26-
2. Install the ``ros2-testing-apt-source`` package
27-
This will automatically uninstall the ``ros2-apt-source`` package since only one repository may be enabled at a time.
26+
2. Install the ros2-testing-apt-source package.
27+
This will automatically uninstall the ros2-apt-source package since only one repository may be enabled at a time.
2828

2929
.. code-block:: console
3030
3131
$ sudo apt install -y ros2-testing-apt-source
3232
33-
3. Update the ``apt`` index:
33+
3. Update the apt index:
3434

3535
.. code-block:: console
3636
@@ -48,11 +48,11 @@ For Debian-based operating systems, you can install binary packages from the **r
4848
4949
$ sudo apt dist-upgrade
5050
51-
6. Once you are finished testing, you can switch back to the normal repository by re-installing the ``ros-apt-source`` package:
51+
6. Once you are finished testing, you can switch back to the normal repository by re-installing the ros-apt-source package:
5252

5353
.. code-block:: console
5454
55-
$ sudo apt install -y ros-apt-source
55+
$ sudo apt install -y ros2-apt-source
5656
5757
and doing an update and upgrade:
5858

@@ -61,6 +61,47 @@ For Debian-based operating systems, you can install binary packages from the **r
6161
$ sudo apt update
6262
$ sudo apt dist-upgrade
6363
64+
65+
RHEL testing repository
66+
-----------------------
67+
68+
For RHEL you can install binary packages from the **ros-testing** repository, by enabling the testing repository on the source configuration:
69+
70+
1. Make sure you have a working ROS 2 installation for rpm packages (see the :doc:`RHEL installation instructions <RHEL-Install-RPMs>`).
71+
72+
2. Enable testing and disable main repository:
73+
74+
.. code-block:: console
75+
76+
$ sudo dnf config-manager setopt ros2-testing.enabled=1
77+
$ sudo dnf config-manager setopt ros2.enabled=0
78+
79+
3. Update the dnf index:
80+
81+
.. code-block:: console
82+
83+
$ sudo dnf update
84+
85+
4. You can now install individual packages from the testing repository, for example:
86+
87+
.. code-block:: console
88+
89+
$ sudo dnf install ros-{DISTRO}-my-just-released-package
90+
91+
5. Once you are finished testing, you can switch back to the normal repository by re-enabling the main repository:
92+
93+
.. code-block:: console
94+
95+
$ sudo dnf config-manager setopt ros2-testing.enabled=0
96+
$ sudo dnf config-manager setopt ros2.enabled=1
97+
98+
and doing an update and upgrade:
99+
100+
.. code-block:: console
101+
102+
$ sudo dnf update
103+
$ sudo dnf system-upgrade
104+
64105
.. _Prerelease_binaries:
65106

66107
Binary archives

0 commit comments

Comments
 (0)