1 .. _lf-global-jjb-rtd-jobs:
10 {project-name}-rtd-jobs
11 -----------------------
13 Jobs to deploy for a project producing ReadTheDocs using Gerrit.
20 {project-name}-github-rtd-jobs
21 ------------------------------
23 Jobs to deploy for a project producing ReadTheDocs using GitHub.
37 RTD verify and merge jobs are the same except for their scm, trigger, and
38 builders definition. This anchor is the common template.
47 Merge job which triggers a POST of the docs project to readthedocs.
49 To use this job first configure the ``Generic API incoming webhook`` in
50 ReadTheDocs. To do that follow these steps:
52 #. Browse to https://readthedocs.org/dashboard/PROJECT/integrations/
53 #. Click on ``Generic API incoming webhook``
57 If not available click on ``Add integration`` and add the
58 ``Generic API incoming webhook``.
60 #. Copy the custom webhook URL, this is your ``rtd-build-url``
62 For example: https://readthedocs.org/api/v2/webhook/opendaylight/32321/
64 #. Copy the token, this is your ``rtd-token``
67 - {project-name}-rtd-merge-{stream}
73 :build-node: The node to run build on.
74 :jenkins-ssh-credential: Credential to use for SSH. (Generally set
76 :rtd-build-url: This is the generic webhook url from readthedocs.org. Refer
77 to the above instructions to generate one.
78 (Check Admin > Integrations > Generic API incoming webhook)
79 :rtd-token: The unique token for the project Generic webhook. Refer
80 to the above instructions to generate one.
81 (Check Admin > Integrations > Generic API incoming webhook)
85 :branch: Git branch to fetch for the build. (default: master)
86 :build-days-to-keep: Days to keep build logs in Jenkins. (default: 7)
87 :build-timeout: Timeout in minutes before aborting build. (default: 15)
88 :git-url: base URL of git project. (default: https://github.com)
89 :project-pattern: Project to trigger build against. (default: \*\*)
90 :stream: Keyword representing a release code-name.
91 Often the same as the branch. (default: master)
92 :submodule-recursive: Whether to checkout submodules recursively.
95 :gerrit_merge_triggers: Override Gerrit Triggers.
96 :gerrit_trigger_file_paths: Override file paths filter which checks which
97 file modifications will trigger a build.
103 pattern: '**/conf.py'
109 Verify job which runs a tox build of the docs project
112 - {project-name}-rtd-verify-{stream}
116 :Required Parameters:
118 :build-node: The node to run build on.
119 :jenkins-ssh-credential: Credential to use for SSH. (Generally set
122 :Optional Parameters:
124 :branch: Git branch to fetch for the build. (default: master)
125 :build-days-to-keep: Days to keep build logs in Jenkins. (default: 7)
126 :build-node: The node to run build on.
127 :build-timeout: Timeout in minutes before aborting build. (default: 15)
128 :doc-dir: Directory where tox will place built docs.
129 as defined in the tox.ini (default: docs/_build/html)
130 :git-url: URL clone project from. (default: $GIT_URL/$PROJECT)
131 :project-pattern: Project to trigger build against. (default: \*\*)
132 :stream: Keyword representing a release code-name.
133 Often the same as the branch. (default: master)
134 :submodule-recursive: Whether to checkout submodules recursively.
137 :gerrit_verify_triggers: Override Gerrit Triggers.
138 :gerrit_trigger_file_paths: Override file paths filter which checks which
139 file modifications will trigger a build.
145 pattern: '**/conf.py'