Extension Points defined in Jenkins Core

Table of Contents

AbstractProject.LabelValidator

hudson.model.AbstractProject.LabelValidator

Plugins may want to contribute additional restrictions on the use of specific labels for specific projects. This extension point allows such restrictions.

Implementations:

(no known implementations)

AdministrativeMonitor

hudson.model.AdministrativeMonitor

Checks the health of a subsystem of Jenkins and if there's something that requires administrator's attention, notify the administrator.

Implementations:

AgentProtocol

jenkins.AgentProtocol

Pluggable Jenkins TCP agent protocol handler called from TcpSlaveAgentListener .

Implementations:

AlternativeUiTextProvider

hudson.util.AlternativeUiTextProvider

Provides the alternative text to be rendered in the UI.

Implementations:

AperiodicWork

hudson.model.AperiodicWork

Extension point which allows scheduling a task with variable interval. Interval in evaluated every time before next task is scheduled by calling #getRecurrencePeriod() . Task to be scheduled is obtain by calling #getNewInstance() .

Implementations:

ArtifactManagerFactory

jenkins.model.ArtifactManagerFactory

Pluggable ability to manage transfer and/or storage of build artifacts. The descriptor should specify at least a display name, and optionally a {@code config} view. Since the user can configure this class, you must have a DataBoundConstructor .

Implementations:

AuthorizationStrategy

hudson.security.AuthorizationStrategy

Controls authorization throughout Hudson.

Implementations:

BasicHeaderAuthenticator

jenkins.security.BasicHeaderAuthenticator

When Jenkins receives HTTP basic authentication, this hook will validate the username/password pair.

Implementations:

BuildDiscarder

jenkins.model.BuildDiscarder

Implementation of "Discard old build records" feature.

Implementations:

BuildReference.HolderFactory

jenkins.model.lazy.BuildReference.HolderFactory

Extensible factory for creating build references.

Implementations:

BuildStepListener

hudson.model.BuildStepListener

Receives events that happen as a build executes BuildStep s.

Implementations:

BuildVariableContributor

hudson.model.BuildVariableContributor

Contributes build variables to builds.

Implementations:

BuildWrapper

hudson.tasks.BuildWrapper

Pluggability point for performing pre/post actions for the build process.

Implementations:

Builder

hudson.tasks.Builder

BuildStep s that perform the actual build.

Implementations:

CLICommand

hudson.cli.CLICommand

Base class for Hudson CLI.

Implementations:

CaptchaSupport

hudson.security.captcha.CaptchaSupport

Extension point for adding Captcha Support to User Registration Page CaptchaSupport .

Implementations:

ChangeLogAnnotator

hudson.scm.ChangeLogAnnotator

Performs mark up on changelog messages to be displayed.

Implementations:

ChannelConfigurator

jenkins.security.ChannelConfigurator

Intercepts the new creation of Channel and tweak its configuration.

Implementations:

CliTransportAuthenticator

hudson.cli.CliTransportAuthenticator

This extension point has no Javadoc documentation.

Implementations:

(no known implementations)

Cloud

hudson.slaves.Cloud

Creates Node s to dynamically expand/shrink the agents attached to Hudson.

Implementations:

CloudProvisioningListener

hudson.slaves.CloudProvisioningListener

Allows extensions to be notified of events in any Cloud and to prevent provisioning from a Cloud .

Implementations:

ComputerConnector

hudson.slaves.ComputerConnector

Factory of ComputerLauncher .

Implementations:

ComputerLauncher

hudson.slaves.ComputerLauncher

Extension point to allow control over how Computer s are "launched", meaning how they get connected to their agent program.

Implementations:

ComputerListener

hudson.slaves.ComputerListener

Receives notifications about status changes of Computer s.

Implementations:

ComputerPanelBox

hudson.model.ComputerPanelBox

Adds box rendered in the computer side panel.

Implementations:

ComputerPinger

hudson.model.ComputerPinger

A way to see if a computer is reachable.

Implementations:

ComputerSet.ComputerSource

hudson.model.ComputerSet.ComputerSource

Allows plugins to override the displayed list of computers.

Implementations:

ConsoleAnnotationDescriptor

hudson.console.ConsoleAnnotationDescriptor

Descriptor for ConsoleNote .

Implementations:

ConsoleAnnotatorFactory

hudson.console.ConsoleAnnotatorFactory

Entry point to the ConsoleAnnotator extension point. This class creates a new instance of ConsoleAnnotator that starts a new console annotation session.

Implementations:

ConsoleLogFilter

hudson.console.ConsoleLogFilter

A hook to allow filtering of information that is written to the console log. Unlike ConsoleAnnotator and ConsoleNote , this class provides direct access to the underlying OutputStream so it's possible to suppress data, which isn't possible from the other interfaces. ( jenkinsdoc:ArgumentListBuilder#add(String, boolean)[] is a simpler way to suppress a single password.)

Implementations which are Serializable may be sent to an agent JVM for processing. In particular, this happens under JEP-210. In this case, the implementation should not assume that JenkinsJVM#isJenkinsJVM , and if generating ConsoleNote s will need to encode them on the master side first.</p>

Implementations:

ConsoleNote

hudson.console.ConsoleNote

Data that hangs off from a console output.

Implementations:

CrumbExclusion

hudson.security.csrf.CrumbExclusion

Allows plugins to define exceptions to the CSRF protection filter.

Implementations:

CrumbIssuer

hudson.security.csrf.CrumbIssuer

A CrumbIssuer represents an algorithm to generate a nonce value, known as a crumb, to counter cross site request forgery exploits. Crumbs are typically hashes incorporating information that uniquely identifies an agent that sends a request, along with a guarded secret so that the crumb value cannot be forged by a third party.

Implementations:

CustomClassFilter

jenkins.security.CustomClassFilter

Allows extensions to adjust the behavior of ClassFilter#DEFAULT . Custom filters can be called frequently, and return values are uncached, so implementations should be fast.

Implementations:

DescriptorVisibilityFilter

hudson.model.DescriptorVisibilityFilter

Hides Descriptor s from users.

Implementations:

DownloadService.Downloadable

hudson.model.DownloadService.Downloadable

Represents a periodically updated JSON data file obtained from a remote URL.

Implementations:

EnvVarsFilterGlobalRule

jenkins.tasks.filters.EnvVarsFilterGlobalRule

Environment variables filter rule that is configured globally for all jobs.

The job types can be filtered using jenkinsdoc:#isApplicable(Run, Object, Launcher)[] </p>

Implementations:

EnvVarsFilterLocalRule

jenkins.tasks.filters.EnvVarsFilterLocalRule

Environment variables filter rule that is specific to a job configuration, using script-specific variables, etc.

The job types can be filtered using EnvVarsFilterLocalRuleDescriptor#isApplicable(Class) </p>

Implementations:

EnvironmentContributor

hudson.model.EnvironmentContributor

Contributes environment variables to builds.

Implementations:

ExecutorListener

hudson.model.ExecutorListener

A listener for task related events from executors. A Computer#getRetentionStrategy or SlaveComputer#getLauncher may implement this interface. Or you may create an implementation as an extension (since 2.318).

Implementations:

ExtendedReadRedaction

jenkins.security.ExtendedReadRedaction

Redact {@code config.xml} contents for users with ExtendedRead permission while lacking the required Configure permission to see the full unredacted configuration.

Implementations:

ExtensionFilter

jenkins.ExtensionFilter

Filters out ExtensionComponent s discovered by ExtensionFinder s, as if they were never discovered.

Implementations:

ExtensionFinder

hudson.ExtensionFinder

Discovers the implementations of an extension point.

Implementations:

FederatedLoginService

hudson.security.FederatedLoginService

Abstraction for a login mechanism through external authenticator/identity provider (instead of username/password.)

Implementations:

FilePath.FileCallableWrapperFactory

hudson.FilePath.FileCallableWrapperFactory

This extension point allows to contribute a wrapper around a fileCallable so that a plugin can "intercept" a call.

The #wrap(hudson.remoting.DelegatingCallable) method itself will be executed on the controller (and may collect contextual data if needed) and the returned wrapper will be executed on remote.</p>

Implementations:

FingerprintFacet

jenkins.model.FingerprintFacet

Plugin-specific additions to fingerprint information.

Implementations:

FingerprintStorage

jenkins.fingerprints.FingerprintStorage

Pluggable fingerprint storage API for fingerprints.

Implementations:

GlobalBuildDiscarderStrategy

jenkins.model.GlobalBuildDiscarderStrategy

Extension point for global background build discarders.

Implementations:

GlobalConfiguration

jenkins.model.GlobalConfiguration

Convenient base class for extensions that contributes to the system configuration page but nothing else, or to manage the global configuration of a plugin implementing several extension points.

Implementations:

GlobalConfigurationCategory

jenkins.model.GlobalConfigurationCategory

Grouping of related GlobalConfiguration s.

Implementations:

GlobalSettingsProvider

jenkins.mvn.GlobalSettingsProvider

This extension point has no Javadoc documentation.

Implementations:

jenkins.views.Header

Extension point that provides capabilities to render a specific header.

Implementations:

HttpServletFilter

jenkins.util.HttpServletFilter

More convenient and declarative way to use PluginServletFilter . Register an implementation if you wish to intercept certain HTTP requests. Typical implementations will inspect HttpServletRequest#getPathInfo to determine if they should be active.

Implementations:

HttpSessionListener

jenkins.util.HttpSessionListener

jakarta.servlet.http.HttpSessionListener ExtensionPoint for Jenkins.

Allows plugins to listen to HttpSession lifecycle events.</p>

Implementations:

HudsonHomeDiskUsageMonitor.Solution

hudson.diagnosis.HudsonHomeDiskUsageMonitor.Solution

Extension point for suggesting solutions for full JENKINS_HOME. Views are as follows:

Implementations:

(no known implementations)

IdStrategy

jenkins.model.IdStrategy

The strategy to use for manipulating converting names (e.g. user names, group names, etc) into ids.

Implementations:

InstallState

jenkins.install.InstallState

Jenkins install state.

Implementations:

InstallStateFilter

jenkins.install.InstallStateFilter

Allows plugging in to the lifecycle when determining InstallState from InstallUtil#getNextInstallState(InstallState)

Implementations:

(no known implementations)

InstanceIdentityProvider

jenkins.model.identity.InstanceIdentityProvider

A source of instance identity.

Should not be used from plugins, except to be implemented by {@code instance-identity}. Other plugins wishing to get the RSA key may depend on {@code instance-identity} directly.</p>

Implementations:

ItemCategory

jenkins.model.item_category.ItemCategory

A category for hudson.model.Item s.

Implementations:

ItemListener

hudson.model.listeners.ItemListener

Receives notifications about CRUD operations of Item .

Implementations:

JnlpAgentReceiver

jenkins.slaves.JnlpAgentReceiver

Receives incoming agents connecting through the likes of JnlpSlaveAgentProtocol4 or WebSocketAgents .

Implementations:

Job

hudson.model.Job

A job is an runnable entity under the monitoring of Hudson.

Implementations:

Job.BuildNumberAssigner

hudson.model.Job.BuildNumberAssigner

Alternate strategy for assigning build numbers.

Implementations:

JobProperty

hudson.model.JobProperty

Extensible property of Job .

Implementations:

LabelAtomProperty

hudson.model.labels.LabelAtomProperty

Extensible property of LabelAtom .

Implementations:

LabelFinder

hudson.model.LabelFinder

Automatically adds labels to Node s.

Implementations:

LabelValidator

jenkins.model.labels.LabelValidator

Plugins may want to contribute additional restrictions on the use of specific labels for specific context items. This extension point allows such restrictions.

Implementations:

(no known implementations)

LauncherDecorator

hudson.LauncherDecorator

Decorates Launcher so that one can intercept executions of commands and alters the command being executed, such as doing this in fakeroot, sudo, pfexec, etc.

Implementations:

Lifecycle

hudson.lifecycle.Lifecycle

Provides the capability for starting/stopping/restarting/uninstalling Hudson.

Implementations:

ListViewColumn

hudson.views.ListViewColumn

Extension point for adding a column to a table rendering of Item s, such as ListView .

Implementations:

LoadBalancer

hudson.model.LoadBalancer

Strategy that decides which Task gets run on which Executor .

Implementations:

LoadPredictor

hudson.model.queue.LoadPredictor

Predicts future load to the system, to assist the scheduling decisions

Implementations:

hudson.model.ManagementLink

Extension point to add icon to {@code http://server/hudson/manage} page.

Implementations:

MarkupFormatter

hudson.markup.MarkupFormatter

Generalization of a function that takes text with some markup and converts that to HTML. Such markup is often associated with Wiki.

Implementations:

MyViewsTabBar

hudson.views.MyViewsTabBar

Extension point for adding a MyViewsTabBar header to Projects MyViewsProperty .

Implementations:

Node

hudson.model.Node

Base type of Jenkins agents (although in practice, you probably extend Slave to define a new agent type).

Implementations:

NodeListener

jenkins.model.NodeListener

Listen to Node CRUD operations.

Implementations:

NodeMonitor

hudson.node_monitors.NodeMonitor

Extension point for managing and monitoring Node s.

Implementations:

NodeProperty

hudson.slaves.NodeProperty

Extensible property of Node .

Implementations:

NodeProvisioner.Strategy

hudson.slaves.NodeProvisioner.Strategy

Extension point for node provisioning strategies.

Implementations:

Notifier

hudson.tasks.Notifier

BuildStep s that run after the build is completed.

Implementations:

PageDecorator

hudson.model.PageDecorator

Participates in the rendering of HTML pages for all pages of Hudson.

Implementations: