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

Merge request reports

Loading