Package org.jenkinsci.plugins.proxmox

Class ProxmoxAgent

java.lang.Object

hudson.model.AbstractModelObject

hudson.model.Node

hudson.model.Slave

hudson.slaves.AbstractCloudSlave

org.jenkinsci.plugins.proxmox.ProxmoxAgent

All Implemented Interfaces:

ExtensionPoint, Describable<Node>, ModelObject, PersistenceRoot, ReconfigurableDescribable<Node>, Saveable, SearchableModelObject, SearchItem, AccessControlled, Serializable, OnMaster, org.jenkinsci.plugins.cloudstats.TrackedItem

public class ProxmoxAgent
extends AbstractCloudSlave
implements org.jenkinsci.plugins.cloudstats.TrackedItem

See Also:

• Serialized Form

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	ProxmoxAgent.DescriptorImpl

Nested classes/interfaces inherited from class hudson.model.Slave

Slave.JnlpJar, Slave.SlaveDescriptor

Nested classes/interfaces inherited from class hudson.model.Node

Node.Mode

Nested classes/interfaces inherited from interface hudson.ExtensionPoint

ExtensionPoint.LegacyInstancesAreScopedToHudson

Field Summary

Fields inherited from class hudson.model.Slave

name, remoteFS

Fields inherited from class hudson.model.Node

holdOffLaunchUntilSave, SKIP_BUILD_CHECK_ON_FLYWEIGHTS

Fields inherited from interface hudson.model.Saveable

NOOP

Constructor Summary

Constructors

Constructor	Description
ProxmoxAgent(String name, String remoteFs, int numExecutors, Node.Mode mode, String labelString, ProxmoxLauncher launcher, String cloudName, String templateName, String proxmoxNode, int vmId, int idleTerminationMinutes, int maxTotalUses, org.jenkinsci.plugins.cloudstats.ProvisioningActivity.Id provisioningId)

Method Summary

Modifier and Type	Method	Description
protected void	_terminate(TaskListener listener)
AbstractCloudComputer<?>	createComputer()
ProxmoxCloud	getCloud()
String	getCloudName()
long	getCreatedAt()
org.jenkinsci.plugins.cloudstats.ProvisioningActivity.Id	getId()	The cloud-stats provisioning activity this agent belongs to, or null if it was created before the integration (untracked).
int	getIdleTerminationMinutes()
int	getInstanceCap()	Template-level instance cap, shown read-only on the agent config page.
int	getMaxTotalUses()
long	getOfflineSince()	When this agent's computer went offline, in epoch millis, or -1 if it is online or still connecting (i.e.
String	getProxmoxNode()
String	getTemplateName()
int	getTotalUses()
int	getVmId()
void	incrementUses()
boolean	isOfflineDead(long nowMs, long graceMs)	Whether this agent's computer has been offline beyond the given grace window.
Node	reconfigure(org.kohsuke.stapler.StaplerRequest2 req, net.sf.json.JSONObject form)

Methods inherited from class hudson.slaves.AbstractCloudSlave

terminate

Methods inherited from class hudson.model.Slave

createLauncher, drainLabelsToTrim, equals, getClockDifferenceCallable, getComputer, getDescriptor, getLabelAtomSet, getLabelString, getLauncher, getMode, getNodeDescription, getNodeName, getNodeProperties, getNumExecutors, getRemoteFS, getRetentionStrategy, getRootPath, getUserId, getWorkspaceFor, getWorkspaceRoot, hashCode, readResolve, save, setLabelString, setLauncher, setMode, setNodeDescription, setNodeName, setNodeProperties, setNumExecutors, setRetentionStrategy, setUserId, toString

Methods inherited from class hudson.model.Node

canTake, canTake, createPath, getACL, getAssignedLabels, getChannel, getClockDifference, getConfigFile, getDisplayName, getFileSystemProvisioner, getLabelCloud, getNodeProperty, getNodeProperty, getNodePropertyDescriptors, getRootDir, getSearchUrl, getSelfLabel, getTemporaryOfflineCause, isAcceptingTasks, isHoldOffLaunchUntilSave, onLoad, reconfigure, toComputer

Methods inherited from class hudson.model.AbstractModelObject

getSearch, getSearchIndex, getSearchName, makeSearchIndex, requirePOST, sendError, sendError, sendError, sendError, sendError, sendError, sendError, sendError

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface hudson.security.AccessControlled

checkAnyPermission, checkPermission, hasAnyPermission, hasPermission, hasPermission, hasPermission2

Methods inherited from interface hudson.search.SearchItem

getSearchGroup, getSearchIcon

Constructor Details

ProxmoxAgent

public ProxmoxAgent(String name,
 String remoteFs,
 int numExecutors,
 Node.Mode mode,
 String labelString,
 ProxmoxLauncher launcher,
 String cloudName,
 String templateName,
 String proxmoxNode,
 int vmId,
 int idleTerminationMinutes,
 int maxTotalUses,
 org.jenkinsci.plugins.cloudstats.ProvisioningActivity.Id provisioningId)
             throws Descriptor.FormException,
IOException

Throws:

Descriptor.FormException

IOException

Method Details

createComputer

public AbstractCloudComputer<?> createComputer()

Specified by:

createComputer in class AbstractCloudSlave

getId

public org.jenkinsci.plugins.cloudstats.ProvisioningActivity.Id getId()

The cloud-stats provisioning activity this agent belongs to, or null if it was created before the integration (untracked). cloud-stats correlates this id across the planned node, the node, and the computer to follow the agent through its provisioning phases.

Specified by:

getId in interface org.jenkinsci.plugins.cloudstats.TrackedItem

_terminate

protected void _terminate(TaskListener listener)
                   throws IOException,
InterruptedException

Specified by:

_terminate in class AbstractCloudSlave

Throws:

IOException

InterruptedException

reconfigure

public Node reconfigure(org.kohsuke.stapler.StaplerRequest2 req,
 net.sf.json.JSONObject form)
                 throws Descriptor.FormException

Specified by:

reconfigure in interface ReconfigurableDescribable<Node>

Overrides:

reconfigure in class Node

Throws:

Descriptor.FormException

getCloud

public ProxmoxCloud getCloud()

getCloudName

public String getCloudName()

getTemplateName

public String getTemplateName()

getProxmoxNode

public String getProxmoxNode()

getVmId

public int getVmId()

getIdleTerminationMinutes

public int getIdleTerminationMinutes()

getMaxTotalUses

public int getMaxTotalUses()

getInstanceCap

public int getInstanceCap()

Template-level instance cap, shown read-only on the agent config page. Reads through to the owning template; returns 0 (no limit) if the cloud or template no longer exists.

getCreatedAt

public long getCreatedAt()

getOfflineSince

public long getOfflineSince()

When this agent's computer went offline, in epoch millis, or -1 if it is online or still connecting (i.e. functional or mid-launch). A node with no computer yet (a phantom whose VM is gone, or one removed mid-provision) is treated as offline since it was created.

Drives both the offline-with-running-VM reconcile (issue #16) and keeping dead nodes from holding instance-cap slots (issue #17): a brief blip is tolerated, an extended outage is not. The disconnect timestamp comes from the OfflineCause; when unavailable (e.g. never connected) it falls back to getCreatedAt().

isOfflineDead

public boolean isOfflineDead(long nowMs,
 long graceMs)

Whether this agent's computer has been offline beyond the given grace window.

getTotalUses

public int getTotalUses()

incrementUses

public void incrementUses()