com.cloudbees.jenkins.plugins.sshagent

Class SSHAgentBuildWrapper

java.lang.Object

hudson.model.AbstractDescribableImpl<hudson.tasks.BuildWrapper>

hudson.tasks.BuildWrapper

com.cloudbees.jenkins.plugins.sshagent.SSHAgentBuildWrapper

All Implemented Interfaces:

hudson.ExtensionPoint, hudson.model.Describable<hudson.tasks.BuildWrapper>

public class SSHAgentBuildWrapper
extends hudson.tasks.BuildWrapper

A build wrapper that provides an SSH agent using supplied credentials

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	SSHAgentBuildWrapper.CredentialHolder A value object to make it possible to pass back multiple credentials via the UI.
static class	SSHAgentBuildWrapper.DescriptorImpl Our descriptor.

Nested classes/interfaces inherited from class hudson.tasks.BuildWrapper

hudson.tasks.BuildWrapper.Environment

Nested classes/interfaces inherited from interface hudson.ExtensionPoint

hudson.ExtensionPoint.LegacyInstancesAreScopedToHudson

Constructor Summary

Constructors

Constructor and Description
SSHAgentBuildWrapper(List<String> credentialIds, boolean ignoreMissing) Constructs a new instance.
SSHAgentBuildWrapper(SSHAgentBuildWrapper.CredentialHolder[] credentialHolders, boolean ignoreMissing) Constructs a new instance.
SSHAgentBuildWrapper(String user) Deprecated. use SSHAgentBuildWrapper(java.util.List,boolean)

Method Summary

Modifier and Type	Method and Description
static String	description(com.cloudbees.plugins.credentials.common.StandardUsernameCredentials c) Helper method that returns a safe description of a StandardUsernameCredentials.
SSHAgentBuildWrapper.CredentialHolder[]	getCredentialHolders() Returns the value objects used to hold the credential ids.
List<String>	getCredentialIds() Gets the IdCredentials.getId()s of the credentials to use.
String	getUser() Deprecated.
boolean	isIgnoreMissing() When true then any missing credentials will be ignored.
void	preCheckout(hudson.model.AbstractBuild build, hudson.Launcher launcher, hudson.model.BuildListener listener)
hudson.tasks.BuildWrapper.Environment	setUp(hudson.model.AbstractBuild build, hudson.Launcher launcher, hudson.model.BuildListener listener)

Methods inherited from class hudson.tasks.BuildWrapper

all, decorateLauncher, decorateLogger, getProjectAction, getProjectActions, makeBuildVariables, makeSensitiveBuildVariables, setUp

Methods inherited from class hudson.model.AbstractDescribableImpl

getDescriptor

Methods inherited from class java.lang.Object

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

Constructor Detail

SSHAgentBuildWrapper

@Deprecated
public SSHAgentBuildWrapper(String user)

Deprecated. use SSHAgentBuildWrapper(java.util.List,boolean)

Constructs a new instance.

Parameters:

user - the IdCredentials.getId() of the credentials to use.

SSHAgentBuildWrapper

@DataBoundConstructor
public SSHAgentBuildWrapper(SSHAgentBuildWrapper.CredentialHolder[] credentialHolders,
                                                  boolean ignoreMissing)

Constructs a new instance.

Parameters:

credentialHolders - the SSHAgentBuildWrapper.CredentialHolders of the credentials to use.

ignoreMissing - true missing credentials will not cause a build failure.

Since:

1.5

SSHAgentBuildWrapper

public SSHAgentBuildWrapper(List<String> credentialIds,
                            boolean ignoreMissing)

Constructs a new instance.

Parameters:

credentialIds - the IdCredentials.getId()s of the credentials to use.

ignoreMissing - true missing credentials will not cause a build failure.

Since:

1.5

Method Detail

getUser

@Deprecated
public String getUser()

Deprecated.

Gets the IdCredentials.getId() of the credentials to use.

Returns:

the IdCredentials.getId() of the credentials to use.

getCredentialIds

public List<String> getCredentialIds()

Gets the IdCredentials.getId()s of the credentials to use.

Returns:

the IdCredentials.getId()s of the credentials to use.

Since:

1.5

isIgnoreMissing

public boolean isIgnoreMissing()

When true then any missing credentials will be ignored. When false then the build will be failed if any of the required credentials cannot be resolved.

Returns:

true missing credentials will not cause a build failure.

getCredentialHolders

public SSHAgentBuildWrapper.CredentialHolder[] getCredentialHolders()

Returns the value objects used to hold the credential ids.

Returns:

the value objects used to hold the credential ids.

Since:

1.5

preCheckout

public void preCheckout(hudson.model.AbstractBuild build,
                        hudson.Launcher launcher,
                        hudson.model.BuildListener listener)
                 throws IOException,
                        InterruptedException

Overrides:

preCheckout in class hudson.tasks.BuildWrapper

Throws:

IOException

InterruptedException

setUp

public hudson.tasks.BuildWrapper.Environment setUp(hudson.model.AbstractBuild build,
                                                   hudson.Launcher launcher,
                                                   hudson.model.BuildListener listener)
                                            throws IOException,
                                                   InterruptedException

Overrides:

setUp in class hudson.tasks.BuildWrapper

Throws:

IOException

InterruptedException

description

@Nonnull
public static String description(@Nonnull
                                          com.cloudbees.plugins.credentials.common.StandardUsernameCredentials c)

Helper method that returns a safe description of a StandardUsernameCredentials.

Parameters:

c - the credentials.

Returns:

the description.