Migrate Global JJB docs to RST
[releng/global-jjb.git] / docs / jjb / lf-node-jobs.rst
1 ###########
2 NodeJS Jobs
3 ###########
4
5 Job Groups
6 ==========
7
8 {project-name}-node-jobs
9 --------------------------
10
11 Jobs for NodeJS projects using Gerrit.
12
13 :Includes:
14
15     - gerrit-node-verify
16
17 {project-name}-github-node-jobs
18 ---------------------------------
19
20 Jobs for NodeJS projects using GitHub.
21
22 :Includes:
23
24     - github-node-verify
25
26 Job Templates
27 =============
28
29 Node Verify
30 ----------
31
32 Verify job for NodeJS projects
33
34 :Template Names:
35
36     - {project-name}-node-verify-{stream}
37     - gerrit-node-verify
38     - github-node-verify
39
40 :Required parameters:
41
42     :build-node: The node to run build on.
43     :jenkins-ssh-credential: Credential to use for SSH. (Generally should
44         be configured in defaults.yaml)
45     :node-version: Version of NodeJS to install. A default is configured
46         via the job-group if a job-group is used.
47
48 :Optional parameters:
49
50     :branch: The branch to build against. (default: master)
51     :build-days-to-keep: Days to keep build logs in Jenkins. (default: 7)
52     :build-timeout: Timeout in seconds before aborting build. (default: 10)
53     :git-url: URL clone project from. (default: $GIT_URL/$PROJECT)
54     :node-dir: Path to a NodeJS project to run node test against
55         (default: '')
56     :stream: Keyword that can be used to represent a release code-name.
57         Often the same as the branch. (default: master)
58     :submodule-recursive: Whether to checkout submodules recursively.
59         (default: true)
60
61     :gerrit_verify_triggers: Override Gerrit Triggers.
62     :gerrit_trigger_file_paths: Override file paths which can be used to
63         filter which file modifications will trigger a build.