org.jenkinsci.plugins.rundeck
Class RundeckInstance

java.lang.Object
  org.jenkinsci.plugins.rundeck.RundeckInstance

All Implemented Interfaces:

Serializable

public class RundeckInstance
extends Object
implements Serializable

Represents a RunDeck instance, and allows to communicate with it in order to schedule jobs. Uses RunDeck 1.1 HTTP API to schedule jobs.

Author:

Vincent Behar

See Also:

Serialized Form

Nested Class Summary

static class	RundeckInstance.RundeckJobSchedulingException Exception used when a job scheduling failed on a RunDeck instance
static class	RundeckInstance.RundeckLoginException Exception used when the login failed on a RunDeck instance

Constructor Summary

RundeckInstance(String url, String login, String password)
Build a new RunDeck instance

Method Summary

boolean	equals(Object obj)
String	getLogin()
String	getPassword()
String	getUrl()
int	hashCode()
boolean	isAlive()
boolean	isConfigurationValid()
boolean	isLoginValid()
String	parseExecutionUrl(InputStream response) Parse the xml response from RunDeck, and if it is successful, return the execution url.
String	scheduleJobExecution(String groupPath, String jobName, Properties options) Schedule a job execution, identified by the given groupPath and jobName.
String	toString()

Methods inherited from class java.lang.Object

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

Constructor Detail

RundeckInstance

public RundeckInstance(String url,
                       String login,
                       String password)

Build a new RunDeck instance

Parameters:

url - of the RunDeck server (http://localhost:4440)

login - to use

password - associated with the login

Method Detail

isConfigurationValid

public boolean isConfigurationValid()

Returns:

true if the configuration is valid, false otherwise

isAlive

public boolean isAlive()

Returns:

true if this RunDeck instance is alive, false otherwise

isLoginValid

public boolean isLoginValid()

Returns:

true if the credentials (login/password) are valid, false otherwise

scheduleJobExecution

public String scheduleJobExecution(String groupPath,
                                   String jobName,
                                   Properties options)
                            throws RundeckInstance.RundeckLoginException,
                                   RundeckInstance.RundeckJobSchedulingException

Schedule a job execution, identified by the given groupPath and jobName.

Parameters:

groupPath - of the job (eg "main-group/sub-group") - mandatory

jobName - - mandatoru

options - for the job, optional

Returns:

the url of the RunDeck execution page

Throws:

RundeckInstance.RundeckLoginException - if the login failed

RundeckInstance.RundeckJobSchedulingException - if the scheduling failed

parseExecutionUrl

public String parseExecutionUrl(InputStream response)
                         throws RundeckInstance.RundeckJobSchedulingException

Parse the xml response from RunDeck, and if it is successful, return the execution url.

Parameters:

response -

Returns:

the RunDeck job execution relative url

Throws:

RundeckInstance.RundeckJobSchedulingException - if the response in an error

getUrl

public String getUrl()

getLogin

public String getLogin()

getPassword

public String getPassword()

toString

public String toString()

Overrides:

toString in class Object

hashCode

public int hashCode()

Overrides:

hashCode in class Object

equals

public boolean equals(Object obj)

Overrides:

equals in class Object