org.jenkinsci.modules.domain_discovery

Class Pinger

java.lang.Object

java.util.TimerTask

hudson.triggers.SafeTimerTask

hudson.model.PeriodicWork

org.jenkinsci.modules.domain_discovery.Pinger

All Implemented Interfaces:

hudson.ExtensionPoint, Runnable

@Extension
public class Pinger
extends hudson.model.PeriodicWork

Based on the host name of Jenkins, find a suitable discovery node and if found, report our location. This allows organizations to discover Jenkins instances running in their domains.

For example, if the domain name is "myjenkins.foo.bar.com", then this class will try to report our location to "discover-jenkins.foo.bar.com" or "discover-jenkins.bar.com".

This code uses public suffix list to avoid reporting to "discover-jenkins.com", as that would allow the owner of this regular domain name to collect Jenkins usages in all the .com domains, which is clearly not what we want.

Author:

Kohsuke Kawaguchi

Nested Class Summary

Nested classes/interfaces inherited from interface hudson.ExtensionPoint

hudson.ExtensionPoint.LegacyInstancesAreScopedToHudson

Field Summary

Fields inherited from class hudson.model.PeriodicWork

DAY, HOUR, logger, MIN

Constructor Summary

Constructors

Constructor and Description
Pinger()

Method Summary

Methods

Modifier and Type	Method and Description
protected void	doRun()
long	getRecurrencePeriod() Runs once a day.
protected void	handle(String hostName)
protected void	reportTo(String name)

Methods inherited from class hudson.model.PeriodicWork

all, getInitialDelay

Methods inherited from class hudson.triggers.SafeTimerTask

run

Methods inherited from class java.util.TimerTask

cancel, scheduledExecutionTime

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

Pinger

public Pinger()

Method Detail

getRecurrencePeriod

public long getRecurrencePeriod()

Runs once a day. A long initial delay also helps avoid reporting a short-lived test instance.

Specified by:

getRecurrencePeriod in class hudson.model.PeriodicWork

doRun

protected void doRun()
              throws Exception

Specified by:

doRun in class hudson.triggers.SafeTimerTask

Throws:

Exception

handle

protected void handle(String hostName)
               throws IOException

Throws:

IOException

reportTo

protected void reportTo(String name)
                 throws IOException

Throws:

IOException