added support for multiple credentials for SSH Agent plugin

Author: daspilker

docs/Home.md

@@ -32,6 +32,8 @@ Browse the Jenkins issue tracker to see any [open issues](https://issues.jenkins
    ([JENKINS-40797](https://issues.jenkins-ci.org/browse/JENKINS-40797))
  * Enhanced support for the [Extra Columns Plugin](https://wiki.jenkins-ci.org/display/JENKINS/Extra+Columns+Plugin)
    ([#978](https://github.com/jenkinsci/job-dsl-plugin/pull/978))
+ * Enhanced support for the [SSH Agent Plugin](https://wiki.jenkins-ci.org/display/JENKINS/SSH+Agent+Plugin)
+   ([#980](https://github.com/jenkinsci/job-dsl-plugin/pull/980))
 * 1.55 (January 03 2016)
  * Updated optional
    [Config File Provider Plugin](https://wiki.jenkins-ci.org/display/JENKINS/Config+File+Provider+Plugin) dependency to

job-dsl-core/src/main/groovy/javaposse/jobdsl/dsl/helpers/wrapper/WrapperContext.groovy

@@ -193,6 +193,25 @@ class WrapperContext extends AbstractExtensibleContext {
         }
     }
 
+    /**
+     * Provide SSH credentials to builds via a ssh-agent in Jenkins.
+     *
+     * @param credentials name of the credentials to use
+     * @since 1.56
+     */
+    @RequiresPlugin(id = 'ssh-agent', minimumVersion = '1.5')
+    void sshAgent(String... credentials) {
+        Preconditions.checkNotNull(credentials, 'credentials must not be null')
+
+        wrapperNodes << new NodeBuilder().'com.cloudbees.jenkins.plugins.sshagent.SSHAgentBuildWrapper' {
+            credentialIds {
+                credentials.each {
+                    string(it)
+                }
+            }
+        }
+    }
+
     /**
      * Renders ANSI escape sequences, including color, to console output.
      *

job-dsl-core/src/test/groovy/javaposse/jobdsl/dsl/helpers/wrapper/WrapperContextSpec.groovy

@@ -401,6 +401,19 @@ class WrapperContextSpec extends Specification {
         1 * mockJobManagement.requirePlugin('ssh-agent')
     }
 
+    def 'sshAgent with multiple credentials'() {
+        when:
+        context.sshAgent('acme', 'foo')
+
+        then:
+        context.wrapperNodes[0].name() == 'com.cloudbees.jenkins.plugins.sshagent.SSHAgentBuildWrapper'
+        context.wrapperNodes[0].children().size() == 1
+        context.wrapperNodes[0].credentialIds[0].children().size() == 2
+        context.wrapperNodes[0].credentialIds[0].string[0].value() == 'acme'
+        context.wrapperNodes[0].credentialIds[0].string[1].value() == 'foo'
+        1 * mockJobManagement.requireMinimumPluginVersion('ssh-agent', '1.5')
+    }
+
     def 'ansiColor with map'() {
         when:
         context.colorizeOutput('foo')