Adds labels to Jenkins agents based on characteristics of the operating system running the agent.
Labels commonly include operating system name, version, architecture, and Windows feature update.
Intel / AMD x64 (amd64)
| Platform | OS Name | Version | Architecture |
|---|---|---|---|
| Alibaba Linux 3 | AlibabaCloud |
3 |
amd64 |
| Alma Linux 8 | AlmaLinux |
8.7 |
amd64 |
| Alma Linux 9 | AlmaLinux |
9.1 |
amd64 |
| Alpine 3.14 | Alpine |
3.14.9 |
amd64 |
| Alpine 3.15 | Alpine |
3.15.7 |
amd64 |
| Alpine 3.16 | Alpine |
3.16.4 |
amd64 |
| Alpine 3.17 | Alpine |
3.17.2 |
amd64 |
| Amazon Linux 2 | Amazon |
2 |
amd64 |
| Amazon Linux 2023 | Amazon |
2023 |
amd64 |
| CentOS 7 | CentOS |
7.9.2009 |
amd64 |
| Clear Linux | clear-linux-os |
38340 |
amd64 |
| Debian 10 | Debian |
10 |
amd64 |
| Debian 11 | Debian |
11 |
amd64 |
| Debian testing | Debian |
testing |
amd64 |
| Debian unstable | Debian |
unstable |
amd64 |
| Fedora 36 | Fedora |
36 |
amd64 |
| Fedora 37 | Fedora |
37 |
amd64 |
| FreeBSD 12 | freebsd |
12.3-RELEASE |
amd64 |
| FreeBSD 13 | freebsd |
13.1-RELEASE |
amd64 |
| Linux Mint 19.3 | LinuxMint |
19.3 |
amd64 |
| Linux Mint 20.3 | Linuxmint |
20.3 |
amd64 |
| openSUSE Leap | openSUSE |
15.4 |
amd64 |
| Oracle Linux 7 | OracleServer |
7.9 |
amd64 |
| Oracle Linux 8 | OracleServer |
8.7 |
amd64 |
| Oracle Linux 9 | OracleServer |
9.1 |
amd64 |
| Red Hat Enterprise Linux 7 | RedHatEnterprise |
7.9 |
amd64 |
| Red Hat Enterprise Linux 8 | RedHatEnterprise |
8.7 |
amd64 |
| Red Hat Enterprise Linux 9 | RedHatEnterprise |
9.1 |
amd64 |
| Rocky Linux 8 | Rocky |
8.7 |
amd64 |
| Rocky Linux 9 | Rocky |
9.1 |
amd64 |
| Scientific 7 | Scientific |
7.9 |
amd64 |
| SLES 12 | SUSE |
12.4 |
amd64 |
| SLES 15 | SUSE |
15 |
amd64 |
| Ubuntu 18 | Ubuntu |
18.04 |
amd64 |
| Ubuntu 20 | Ubuntu |
20.04 |
amd64 |
| Ubuntu 22 | Ubuntu |
22.04 |
amd64 |
| Windows 10 | windows |
10.0 |
amd64 |
ARM 64 bit (aarch64)
| Platform | OS Name | Version | Architecture |
|---|---|---|---|
| Debian 10 | Debian |
10 |
aarch64 |
| Oracle Linux 8 | OracleServer |
8.7 |
aarch64 |
ARM 32 bit (arm)
| Platform | OS Name | Version | Architecture |
|---|---|---|---|
| Raspbian 10 | Raspbian |
10 |
arm |
| Raspbian 11 | Raspbian |
11 |
arm |
IBM System 390 (s390x)
| Platform | OS Name | Version | Architecture |
|---|---|---|---|
| Ubuntu 18 | Ubuntu |
18.04 |
s390x |
| Ubuntu 20 | Ubuntu |
20.04 |
s390x |
On Windows computers, the plugin assigns a label based on the Windows feature update. Feature update labels use a two digit year and a two digit month representation. Common values for Windows feature update are 1809, 1903, 2009, and 2109.
On Linux computers, the plugin uses the output of the lsb_release command.
If lsb_release is not installed, labels on Linux agents will be guessed based on values in /etc/os-release. Red Hat Linux 9 and its derivatives intentionally do not delivery lsb_release.
Red Hat Linux and Scientific Linux agents have another fallback based on /etc/redhat-release.
Agents with an older version of SuSE Linux will fallback to /etc/SuSE-release. Older versions of this plugin might return "sles" or "SUSE LINUX" as OS name. This has been unified to "SUSE" as this is the lsb_release ID since 'SLES 12 SP2'.
Linux Mint changed its lsb_release distributor ID from "LinuxMint" to "Linuxmint" in Linux Mint 20. The Linux Mint label will be "LinuxMint" for Linux Mint 19.03. The Linux Mint label will be "Linuxmint" for Linux Mint 20 and later. Users running Linux Mint 19 agents may need to adjust their label references to use "Linuxmint" instead of "LinuxMint".
When /etc/os-release is used, less detailed labels may be provided because more specific version information is not included in the file. For example:
| Platform | Operating System | Version | Architecture |
|---|---|---|---|
| CentOS 7 | CentOS |
7 |
amd64 |
| Debian testing | Debian |
bookworm |
amd64 |
| Debian unstable | Debian |
bookworm |
amd64 |
The types of labels can be configured globally and per agent with the 'Automatic Platform Labels' setting.
To reduce the set of labels defined for an agent, activate 'Automatic Platform Labels' in the Node Properties section and select the desired label types.
Report an Issue
Please report issues and enhancements through the Jenkins issue tracker.