com.redhat.jenkins.nodesharingbackend

Class ReservationVerifier

java.lang.Object

java.util.TimerTask

hudson.triggers.SafeTimerTask

hudson.model.PeriodicWork

com.redhat.jenkins.nodesharingbackend.ReservationVerifier

All Implemented Interfaces:

hudson.ExtensionPoint, Runnable

@Extension
public class ReservationVerifier
extends hudson.model.PeriodicWork

Re-sync orchestrator tracked reservations with executor usage. There are several state to balance for individual hosts. From the executor perspective the host can either be reserved for it or not. From the orchestrator perspective, the host can be idle, reserved for a given executor or missing completely - presumably because of recent removal from config repo. There are several situations resulting from that:

Agreement

• A1: All nodes agree the host is idle,
• A2: Orchestrator agree with the only executor that claims the host.

No action needed here as grid is in sync.

No collision

• NC1: Orchestrator tracks a reservation for executor that does not report the host being reserved. UC: Executor failover or Missed returnNode call
• NC2: Orchestrator tracks no reservation for the host yet one executor claims it. UC: Orchestrator failover.
• NC3: Orchestrator tracks reservation of a host for executor X that does not report it while executor Y does. Bug or Race Condition

State representation of the Orchestrator is adjusted to match the one of the grid.

Collision

• C1: Orchestrator tracks reservation but extra executors report usage of the host. Bug or Race condition.
• C2: Multiple executors report reservation but orchestrator tracks none. Bug or Race condition.

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
ReservationVerifier()

Method Summary

Modifier and Type	Method and Description
void	doRun()
static ReservationVerifier	getInstance()
long	getRecurrencePeriod()
static void	verify(ConfigRepo.Snapshot config, Api api)

Methods inherited from class hudson.model.PeriodicWork

all, getInitialDelay, init

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

ReservationVerifier

public ReservationVerifier()

Method Detail

getInstance

@Nonnull
public static ReservationVerifier getInstance()

getRecurrencePeriod

public long getRecurrencePeriod()

Specified by:

getRecurrencePeriod in class hudson.model.PeriodicWork

doRun

public void doRun()

Specified by:

doRun in class hudson.triggers.SafeTimerTask

verify

public static void verify(ConfigRepo.Snapshot config,
                          Api api)