Skip to content

jenkinsci/label-verifier-plugin

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Label Verifier plugin for Jenkins

This plugin allows system administrators to programmatically verify the label assignment correctness on agents. It is useful to prevent a human error in label assignment when you have a larger number or self-organizing agents and generally as a means to make sure your Jenkins agent labels are correct.

Usage

Go to the label configuration page of the label whose assignment you want to validate. For example, http://yourserver/jenkins/label/foo/configure. You can associate "label verifies" through this UI, as follows:

Verifier Configuration

The specified script is executed every time an agent with this label comes online. If the script returns a non-zero exit code, the label assignment is considered illegal and Jenkins will mark the agent as offline to prevent it from being used for a build.

Configuration as code

The configuration as code plugin can define the label verifiers.

A label verifier to confirm that command line git 2.25 is installed on the agent can be configured like this:

jenkins:
  labelAtoms:
  - name: "git-2.25"
    properties:
    - ? ''
      : verifiers:
        - shellScriptVerifier:
            script: "git --version 2>&1 | grep -F 2.25"

Changelog

See GitHub Releases