Fix apt package install version string and change to a newer version in the docs
-
Please check this box if this contribution uses AI-generated content (including content generated by GitLab Duo features) as outlined in the GitLab DCO & CLA. As a benefit of being a GitLab Community Contributor, you can request access to GitLab Duo.
What does this MR do?
Fix doc for apt to install a specific version of the Gitlab Runner. Also bump the example version to a newer v17 version.
Why was this MR needed?
The current documentation explains to install a specific version like this which leads to an error if a newer version than 16.8.1 is used.
Example with 16.8.1
$ sudo apt install gitlab-runner=16.8.1
Reading package lists... Done
Building dependency tree... Done
Reading state information... Done
The following additional packages will be installed:
git git-man less libbsd0 libcbor0.8 libcurl3-gnutls libedit2 liberror-perl libexpat1 libfido2-1 libgdbm-compat4 libgdbm6 libmd0 libperl5.34 libx11-6 libx11-data libxau6 libxcb1
libxdmcp6 libxext6 libxmuu1 netbase openssh-client patch perl perl-modules-5.34 xauth
Suggested packages:
gettext-base git-daemon-run | git-daemon-sysvinit git-doc git-email git-gui gitk gitweb git-cvs git-mediawiki git-svn docker-engine gdbm-l10n keychain libpam-ssh monkeysphere
ssh-askpass ed diffutils-doc perl-doc libterm-readline-gnu-perl | libterm-readline-perl-perl make libtap-harness-archive-perl
The following NEW packages will be installed:
git git-man gitlab-runner less libbsd0 libcbor0.8 libcurl3-gnutls libedit2 liberror-perl libexpat1 libfido2-1 libgdbm-compat4 libgdbm6 libmd0 libperl5.34 libx11-6 libx11-data libxau6
libxcb1 libxdmcp6 libxext6 libxmuu1 netbase openssh-client patch perl perl-modules-5.34 xauth
0 upgraded, 28 newly installed, 0 to remove and 0 not upgraded.
Need to get 506 MB of archives.
After this operation, 613 MB of additional disk space will be used.
Do you want to continue? [Y/n]
Example with 16.9.0
$ sudo apt install gitlab-runner=16.9.0
Reading package lists... Done
Building dependency tree... Done
Reading state information... Done
Package gitlab-runner is not available, but is referred to by another package.
This may mean that the package is missing, has been obsoleted, or
is only available from another source
E: Version '16.9.0' for 'gitlab-runner' was not found
This is mainly because the package name changed starting with 16.9.0 to the pattern <version>-1
Example with 16.9.0-1
$ sudo apt install gitlab-runner=16.9.0-1
Reading package lists... Done
Building dependency tree... Done
Reading state information... Done
The following additional packages will be installed:
git git-man less libbsd0 libcbor0.8 libcurl3-gnutls libedit2 liberror-perl libexpat1 libfido2-1 libgdbm-compat4 libgdbm6 libmd0 libperl5.34 libx11-6 libx11-data libxau6 libxcb1
libxdmcp6 libxext6 libxmuu1 netbase openssh-client patch perl perl-modules-5.34 xauth
Suggested packages:
gettext-base git-daemon-run | git-daemon-sysvinit git-doc git-email git-gui gitk gitweb git-cvs git-mediawiki git-svn docker-engine gdbm-l10n keychain libpam-ssh monkeysphere
ssh-askpass ed diffutils-doc perl-doc libterm-readline-gnu-perl | libterm-readline-perl-perl make libtap-harness-archive-perl
The following NEW packages will be installed:
git git-man gitlab-runner less libbsd0 libcbor0.8 libcurl3-gnutls libedit2 liberror-perl libexpat1 libfido2-1 libgdbm-compat4 libgdbm6 libmd0 libperl5.34 libx11-6 libx11-data libxau6
libxcb1 libxdmcp6 libxext6 libxmuu1 netbase openssh-client patch perl perl-modules-5.34 xauth
0 upgraded, 28 newly installed, 0 to remove and 0 not upgraded.
Need to get 506 MB of archives.
After this operation, 613 MB of additional disk space will be used.
Do you want to continue? [Y/n]
What's the best way to test this MR?
Try to install a specific version of the package with and without the suffix "-1"
Edited by Thorsten Banhart