{{TableOfContents}}
Here is information about Jenkins CLI.

You can operate Jenkins from the command line, using a Java program
call jenkins-cli.

For information about this, see the page:
http://localhost:8080/fuego/cli.

= jcmd wrapper =
I downloaded jenkins-cli.jar, and put it in my $HOME/bin directory, and then
made a wrapper command for it called 'jcmd'.

Here is the content of the wrapper program:
{{{#!YellowBlock
#!/bin/sh

java -jar /home/tbird20d/bin/jenkins-cli.jar -s http://127.0.0.1:8080/fuego $@
}}}

Now, I can do: "jcmd help", "jcmd <command> <args>", etc.


= Terminology map =
On the Jenkins cli, the following terms are used:
 * job = fuego test
 * build = test run
 * node = fuego target or board



= Operations =
== Get help for Jenkins CLI ==
Get a list of Jenkins CLI commands:
{{{#!YellowBlock
$ jcmd help
}}}

Get usage help for the build command:
{{{#!YellowBlock
$ jcmd build help
}}}

== Get a list of tests ==
In Jenkins terminology, a fuego test is a "job".  Get the list of available
tests with:
{{{#!YellowBlock
$ jcmd list-jobs
}}}

== Launch a single test ==
You can use the 'build' command to launch an individual test.  You must specify the target board, by specifying the value for "Device", to the test.

This example runs the test Functional.hello_world on the qemu-test-arm target, waits for it to complete, and displays the console log.

{{{#!YellowBlock
$ jcmd build Functional.hello_world -p Device=qemu-test-arm -s -v
}}}