On Sat, Sep 23, 2017 at 8:08 AM, Mark Waite <[email protected]> wrote:
> > > On Sat, Sep 23, 2017 at 6:56 AM Jon Schewe <[email protected]> wrote: > >> Thank you for the pointers. Do you know how this documentation >> <https://jenkinsci.github.io/job-dsl-plugin/#method/javaposse.jobdsl.dsl.helpers.step.StepContext.ant> >> relates to calling ant then? To me it suggests that I don't need to write a >> function to determine the platform. >> >> > That's a good question. I believe that documentation site (javaposse) is > describing a specific Jenkins tool, "Job DSL", rather than Jenkins > Pipeline. Both are DSL's, and I believe that both use groovy as the base > language for their work, but they are different DSL's, with different > syntax details. > Ahh, I see that now. I was so focused on the fact that it talked about a DSL with Jenkins for ant that I assumed it was the same DSL. > > >> Is there a central location for pipeline documentation or does it belong >> on each of the plugins? >> >> > I believe the jenkins.io site is intended to be the central location for > pipeline documentation. > > I think we can consider the withMaven documentation > <https://jenkins.io/doc/pipeline/steps/pipeline-maven/> as an example > when documenting withAnt. > > There is a difference between the withAnt and withMaven, since the > withMaven wrapper needs a separate pipeline maven plugin, while the withAnt > wrapper seems to be delivered as part of the ant plugin. I don't think > that difference is especially significant for the documentation. > Well I don't have edit access to jenkins.io, so I've put in the ticket https://issues.jenkins-ci.org/browse/JENKINS-47076 so that the person with permissions can get it in. > Mark Waite > > >> >> On Friday, September 22, 2017 at 9:43:58 PM UTC-5, Mark Waite wrote: >> >>> Based on the unit test >>> <https://github.com/jenkinsci/ant-plugin/blob/798cf27ebba66685d2fa7446521228fae1ab975f/src/test/java/hudson/tasks/AntWrapperTest.java#L75>, >>> I believe the "withAnt" build wrapper assures that the selected ant tool is >>> available on the agent where you're running, and configures the environment >>> to use that version of ant. It does not call ant. >>> >>> Inside the withAnt() wrapper, you call ant using sh or bat as >>> appropriate. >>> >>> An example might be: >>> >>> withAnt(installation: 'ant-latest', jdk: 'jdk8') { >>> if (isUnix()) { >>> sh 'ant clean build' >>> } else { >>> bat 'ant clean build' >>> } >>> } >>> >>> I've never used the withAnt task, but I use ant very often in my >>> regression test branches. >>> >>> I have a pipeline library >>> <https://github.com/MarkEWaite/jenkins-pipeline-utils/blob/master/src/com/markwaite/Build.groovy> >>> (which >>> looks badly out of date, since it doesn't use withAnt) that defines a build >>> step for ant, and then I call it >>> <https://github.com/MarkEWaite/jenkins-bugs/blob/74db3aa963ba857d26b0b223a5aae2bdff4c727a/Jenkinsfile#L18>. >>> That build step hides the decision of which platform, and thus hides the >>> decision to use "sh" or "bat" to invoke the ant command. >>> >>> Now that we've both learned something new about withAnt, let's find a >>> way to submit a pull request to jenkins.io to provide a withAnt() >>> example. Either that, or we can insert that documentation into the Ant >>> plugin wiki page (to match what is done for the withMaven step >>> <https://wiki.jenkins.io/display/JENKINS/Pipeline+Maven+Plugin>) >>> >>> Mark Waite >>> >>> On Fri, Sep 22, 2017 at 8:25 PM Jon Schewe <[email protected]> wrote: >>> >> I'm trying to switch to using the pipeline plugin and I'm having a really >>>> hard time finding documentation. In particular I want to call an ant build >>>> script and I don't want to do it with sh/bat because the OS may change. >>>> >>>> I found some documentation at [1], however I get errors about missing >>>> properties when I try the example. >>>> >>>> I found the withAnt block in the snippet generator, but can't find the >>>> syntax for inside the block. >>>> >>>> It's not clear to me where I should put the node {} blocks either. I >>>> have seen that it's a good idea to do things on a node to ensure I know >>>> where it's running, but I'm not having a lot of luck getting the syntax >>>> right. >>>> >>>> I'm also trying to limit which node the job runs on. I found [2] and >>>> tried using "node('fll-build')" and get errors: >>>> >>>> org.codehaus.groovy.control.MultipleCompilationErrorsException: startup >>>> failed: >>>> WorkflowScript: 5: Undefined section "node" @ line 5, column 2. >>>> node('fll-build') { >>>> ^ >>>> >>>> >>>> You can see the current state of my experiments, and the history of >>>> what I've tried, at [3] >>>> >>>> 1 - https://jenkinsci.github.io/job-dsl-plugin/#method/ >>>> javaposse.jobdsl.dsl.helpers.step.StepContext.ant >>>> 2 - https://github.com/jenkinsci/pipeline-plugin/ >>>> blob/master/TUTORIAL.md#using-agents >>>> 3 - https://github.com/jpschewe/fll-sw/blob/jenkins-pipeline/ >>>> Jenkinsfile >>>> >>>> -- >>>> http://mtu.net/~jpschewe >>>> >>>> -- >>>> You received this message because you are subscribed to the Google >>>> Groups "Jenkins Users" group. >>>> >>> To unsubscribe from this group and stop receiving emails from it, send >>>> an email to [email protected]. >>> >>> >>>> To view this discussion on the web visit https://groups.google.com/d/ >>>> msgid/jenkinsci-users/CALpcnoxq5f1_0dDxXYvYu9xxoErnrTd86Gtw1_ >>>> C59pyt0M7CvA%40mail.gmail.com >>>> <https://groups.google.com/d/msgid/jenkinsci-users/CALpcnoxq5f1_0dDxXYvYu9xxoErnrTd86Gtw1_C59pyt0M7CvA%40mail.gmail.com?utm_medium=email&utm_source=footer> >>>> . >>>> For more options, visit https://groups.google.com/d/optout. >>>> >>> -- >> You received this message because you are subscribed to the Google Groups >> "Jenkins Users" group. >> To unsubscribe from this group and stop receiving emails from it, send an >> email to [email protected]. >> To view this discussion on the web visit https://groups.google.com/d/ >> msgid/jenkinsci-users/bd064708-b4e2-4d9d-bfbc- >> bc5fae3e7474%40googlegroups.com >> <https://groups.google.com/d/msgid/jenkinsci-users/bd064708-b4e2-4d9d-bfbc-bc5fae3e7474%40googlegroups.com?utm_medium=email&utm_source=footer> >> . >> For more options, visit https://groups.google.com/d/optout. >> > -- > You received this message because you are subscribed to the Google Groups > "Jenkins Users" group. > To unsubscribe from this group and stop receiving emails from it, send an > email to [email protected]. > To view this discussion on the web visit https://groups.google.com/d/ > msgid/jenkinsci-users/CAO49JtFp%2Bg-Hw3iT-kqS7rYSUJhWNa4yLva1dy5SczTEypA > oRw%40mail.gmail.com > <https://groups.google.com/d/msgid/jenkinsci-users/CAO49JtFp%2Bg-Hw3iT-kqS7rYSUJhWNa4yLva1dy5SczTEypAoRw%40mail.gmail.com?utm_medium=email&utm_source=footer> > . > > For more options, visit https://groups.google.com/d/optout. > -- http://mtu.net/~jpschewe -- You received this message because you are subscribed to the Google Groups "Jenkins Users" group. To unsubscribe from this group and stop receiving emails from it, send an email to [email protected]. To view this discussion on the web visit https://groups.google.com/d/msgid/jenkinsci-users/CALpcnowh%3DFEzh09LiuoeLQrF-iuNWpQ8pCQs%3DSHRXhwbV%3D6NiA%40mail.gmail.com. For more options, visit https://groups.google.com/d/optout.
