docs/jjb/lf-ci-jobs.rst

   1 #######
   2 CI Jobs
   3 #######
   4
   5 Job Groups
   6 ==========
   7
   8 .. include:: ../job-groups.rst
   9
  10 Below is a list of CI job groups:
  11
  12 .. literalinclude:: ../../jjb/lf-ci-job-groups.yaml
  13    :language: yaml
  14
  15
  16 Macros
  17 ======
  18
  19 lf-infra-jjb-parameters
  20 -----------------------
  21
  22 :Required Parameters:
  23
  24     :jjb-cache: Location of Jenkins Job Builder (JJB) cache used for jjb
  25         jobs.
  26     :jjb-version: Version of Jenkins Job Builder (JJB) to install and use in
  27         the jjb jobs.
  28
  29 lf-jenkins-cfg-clouds
  30 ---------------------
  31
  32 Deploys Jenkins Cloud configuration read from the ``jenkins-clouds`` directory
  33 in ci-management repositories.
  34
  35 .. note::
  36
  37    Requires the jjbini file in Jenkins CFP to contain JJB 2.0 style
  38    config definitions for "production" and "sandbox" systems.
  39
  40 :Required Parameters:
  41
  42     :jenkins-silos: Space-separated list of Jenkins silos to update
  43         configuration for as defined in ~/.config/jenkins_jobs/jenkins_jobs.ini
  44
  45 lf-jenkins-cfg-global-vars
  46 --------------------------
  47
  48 Manages the Global Jenkins variables. This macro will clear all exist macros
  49 in Jenkins and replaces them with the ones defined by the
  50 ci-management/jenkins-config/global-vars-SILO.sh script.
  51
  52 .. note::
  53
  54    Requires the jjbini file in Jenkins CFP to contain JJB 2.0 style
  55    config definitions for "production" and "sandbox" systems.
  56
  57 :Required parameters:
  58
  59     :jenkins-silos: Space-separated list of Jenkins silos to update
  60         configuration for as defined in ~/.config/jenkins_jobs/jenkins_jobs.ini
  61
  62 lf-infra-jjbini
  63 ---------------
  64
  65 Provides jenkins_jobs.ini configuration for Jenkins.
  66
  67 lf-infra-jjbini-sandbox
  68 -----------------------
  69
  70 Provides jenkins_jobs.ini configuration for Jenkins sandbox.
  71
  72 .. todo:: This needs to be consolidated into lf-infra-jjbini when JJB 2.0 is available
  73
  74 lf-packer-common
  75 ----------------
  76
  77 Common packer configuration.
  78
  79 lf-packer-file-paths
  80 --------------------
  81
  82 Gerrit file-paths for packer jobs.
  83
  84 lf-packer-parameters
  85 --------------------
  86
  87 Parameters useful for packer related tasks.
  88
  89 :Parameters:
  90
  91     :packer-version: Version of packer to install / use.
  92         (shell: PACKER_VERSION)
  93
  94 lf-packer-verify-file-paths
  95 ---------------------------
  96
  97 Gerrit file-paths for packer verify jobs.
  98
  99 lf-puppet-parameters
 100 --------------------
 101
 102 Parameters useful for Puppet related tasks.
 103
 104 :Parameters:
 105
 106     :puppet-lint-version: Version of puppet-lint to install / use.
 107         (shell: PUPPET_LINT_VERSION)
 108
 109 Job Templates
 110 =============
 111
 112 .. _gerrit-branch-lock:
 113
 114 Gerrit Branch Lock
 115 ------------------
 116
 117 Job submits a patch to lock or unlock a project's branch.
 118
 119 :Template Names:
 120     - {project-name}-gerrit-branch-lock-{stream}
 121     - gerrit-branch-lock
 122
 123 :Comment Trigger:
 124
 125     * lock branch
 126     * unlock branch
 127
 128 :Required parameters:
 129
 130     :build-node: The node to run build on.
 131     :jenkins-ssh-credential: Credential to use for SSH. (Generally
 132         should be configured in defaults.yaml)
 133
 134 :Optional parameters:
 135
 136     :branch: Git branch to build against. (default: master)
 137     :git-url: URL to clone project from. (default: $GIT_URL/$GERRIT_PROJECT)
 138     :stream: Keyword that can be used to represent a release code-name.
 139         Often the same as the branch. (default: master)
 140     :submodule-timeout: Timeout (in minutes) for checkout operation.
 141         (default: 10)
 142     :gerrit_merge_triggers: Override Gerrit Triggers.
 143
 144 .. _lf-global-jjb-jenkins-cfg-merge:
 145
 146 Jenkins Configuration Merge
 147 ---------------------------
 148
 149 Jenkins job to manage Global Jenkins configuration.
 150
 151 .. note::
 152
 153    Requires the jjbini file in Jenkins CFP to contain JJB 2.0 style
 154    config definitions for "production" and "sandbox" systems.
 155
 156 :Template names:
 157
 158     - {project-name}-jenkins-cfg-merge
 159     - gerrit-jenkins-cfg-merge
 160     - github-jenkins-cfg-merge
 161
 162 :Optional parameters:
 163
 164     :branch: Git branch to build against. (default: master)
 165     :cron: How often to run the job on a cron schedule. (default: @daily)
 166     :git-url: URL to clone project from. (default: $GIT_URL/$GERRIT_PROJECT)
 167     :jenkins-silos: Space separated list of Jenkins silos to update
 168         configuration for as defined in ~/.config/jenkins_jobs/jenkins_jobs.ini
 169         (default: production sandbox)
 170
 171 Typically this template is automatically pulled in by the
 172 "{project-name}-ci-jobs" job-group and does not need to be explicitly called if
 173 the job group is being used.
 174
 175 Minimal Example:
 176
 177 .. literalinclude:: ../../.jjb-test/lf-ci-jobs/jenkins-cfg-merge-minimal.yaml
 178    :language: yaml
 179
 180 Full Example:
 181
 182 .. literalinclude:: ../../.jjb-test/lf-ci-jobs/jenkins-cfg-merge-full.yaml
 183    :language: yaml
 184
 185 .. _jenkins-cfg-envvar:
 186
 187 Global Environment Variables
 188 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 189
 190 Global Environment Variables are managed via the
 191 ``jenkins-config/global-vars-SILO.sh`` file in ci-management. Replace SILO with
 192 the name of the Jenkins silo the variable configuration is for.
 193
 194 The format for this file is ``KEY=value`` for example::
 195
 196     GERRIT_URL=https://git.opendaylight.org/gerrit
 197     GIT_BASE=git://devvexx.opendaylight.org/mirror/$PROJECT
 198     GIT_URL=git://devvexx.opendaylight.org/mirror
 199     JENKINS_HOSTNAME=vex-yul-odl-jenkins-2
 200     LOGS_SERVER=https://logs.opendaylight.org
 201     NEXUS_URL=https://nexus.opendaylight.org
 202     ODLNEXUSPROXY=https://nexus.opendaylight.org
 203     SILO=sandbox
 204     SONAR_URL=https://sonar.opendaylight.org
 205
 206 Cloud Configuration
 207 ^^^^^^^^^^^^^^^^^^^
 208
 209 This configuration requires the OpenStack Cloud plugin in Jenkins and is
 210 currently the only cloud plugin supported.
 211
 212 OpenStack Cloud plugin version supported:
 213
 214 * 2.30 - 2.34
 215 * 2.35 - 2.37
 216
 217 Cloud configuration are managed via a directory structure in ci-management as
 218 follows:
 219
 220 - jenkins-config/clouds/openstack/
 221 - jenkins-config/clouds/openstack/cattle/cloud.cfg
 222 - jenkins-config/clouds/openstack/cattle/centos7-builder-2c-2g.cfg
 223 - jenkins-config/clouds/openstack/cattle/centos7-builder-4c-4g.cfg
 224 - jenkins-config/clouds/openstack/cattle/centos7-docker-4c-4g.cfg
 225
 226 The directory name inside of the "openstack" directory is used as the name of
 227 the cloud configuration. In this case "cattle" is being used as the cloud name.
 228
 229 The ``cloud.cfg`` file is a special file used to configure the main cloud
 230 configuration in the format ``KEY=value``.
 231
 232 :Cloud Parameters:
 233
 234     :CLOUD_URL: API endpoint URL for Keystone.
 235         (default: "")
 236     :CLOUD_IGNORE_SSL: Ignore unverified SSL certificates. (default: false)
 237     :CLOUD_ZONE: OpenStack region to use. (default: "")
 238     :CLOUD_CREDENTIAL_ID: Credential to use for authentication to OpenStack.
 239         (default: "os-cloud")
 240     :INSTANCE_CAP: Total number of instances the cloud will allow spin up.
 241         (default: null)
 242     :SANDBOX_CAP: Total number of instances the cloud will allow to
 243         spin up. This applies to "sandbox" systems and overrides the
 244         INSTANCE_CAP setting. (default: null)
 245
 246 :Template Parameters:
 247
 248     .. note::
 249
 250        In the case of template definitions of a parameter below is not passed
 251        the one defined in default clouds will be inherited.
 252
 253     :IMAGE_NAME: The image name to use for this template.
 254         (required)
 255     :HARDWARE_ID: OpenStack flavor to use. (required)
 256
 257     :LABELS: Labels to assign to the vm. (default: FILE_NAME)
 258     :NETWORK_ID: OpenStack network to use. (default: "")
 259     :USER_DATA_ID: User Data to pass into the instance.
 260         (default: jenkins-init-script)
 261     :INSTANCE_CAP: Total number of instances of this type that can be launched
 262         at one time. When defined in clouds.cfg it defines the total for the
 263         entire cloud. (default: null)
 264     :SANDBOX_CAP: Total number of instances of this type that can be launched
 265         at one time. When defined in clouds.cfg it defines the total for the
 266         entire cloud. This applies to "sandbox" systems and overrides the
 267         INSTANCE_CAP setting. (default: null)
 268     :FLOATING_IP_POOL: Floating ip pool to use. (default: "")
 269     :SECURITY_GROUPS: Security group to use. (default: "default")
 270     :AVAILABILITY_ZONE: OpenStack availability zone to use. (default: "")
 271     :START_TIMEOUT: Number of milliseconds to wait for the agent to be
 272         provisioned and connected. (default: 600000)
 273     :KEY_PAIR_NAME: SSH Public Key Pair to use for authentication.
 274         (default: jenkins)
 275     :NUM_EXECUTORS: Number of executors to enable for the instance.
 276         (default: 1)
 277     :JVM_OPTIONS: JVM Options to pass to Java. (default: "")
 278     :FS_ROOT: File system root for the workspace. (default: "/w")
 279     :RETENTION_TIME: Number of minutes to wait for an idle slave to be used
 280         again before it's removed. If set to -1, the slave will be kept
 281         forever. (default: 0)
 282     :CONNECTION_TYPE: The connection type for Jenkins to connect to the build
 283         minion. Valid options: JNLP, SSH. (default: "SSH")
 284
 285 For a live example see the OpenDaylight project jenkins-config directory.
 286 https://github.com/opendaylight/releng-builder/tree/master/jenkins-config
 287
 288 Troubleshooting
 289 ^^^^^^^^^^^^^^^
 290
 291 :Cloud Configuration:
 292
 293     The directory ``groovy-inserts`` contains the groovy script output that is
 294     used to push to Jenkins. In the event of a job failure this file can be
 295     inspected.
 296
 297  .. _lf-global-jjb-jenkins-cfg-verify:
 298
 299 Jenkins Configuration Verify
 300 ----------------------------
 301
 302 Jenkins job to verify the Global Jenkins configuration.
 303
 304 Requires the ``clouds-yaml`` file to be setup on the Jenkins host.
 305
 306 :Template names:
 307
 308     - {project-name}-jenkins-cfg-verify
 309     - gerrit-jenkins-cfg-verify
 310     - github-jenkins-cfg-verify
 311
 312 :Optional parameters:
 313
 314     :branch: Git branch to build against. (default: master)
 315     :git-url: URL to clone project from. (default: $GIT_URL/$GERRIT_PROJECT)
 316
 317 This job is not part of the "{project-name}-ci-jobs" group. It must be called
 318 explicitly.
 319
 320 Example:
 321
 322 .. literalinclude:: ../../.jjb-test/lf-ci-jobs/jenkins-cfg-verify.yaml
 323    :language: yaml
 324
 325
 326 .. _jenkins-sandbox-cleanup:
 327
 328 Jenkins Sandbox Cleanup
 329 -----------------------
 330
 331 Cleanup Jenkins Sandbox of jobs and views periodically.
 332
 333 :Template names:
 334
 335     - {project-name}-jenkins-sandbox-cleanup
 336     - gerrit-jenkins-sandbox-cleanup
 337     - github-jenkins-sandbox-cleanup
 338
 339 :Comment Trigger: NONE
 340
 341 :Required parameters:
 342
 343     :build-node: The node to run build on.
 344     :jenkins-ssh-credential: Credential to use for SSH. (Generally
 345         should be configured in defaults.yaml)
 346
 347 :Optional parameters:
 348
 349     :cron: Schedule to run job. (default: '0 8 * * 6')
 350
 351
 352 .. _jjb-deploy:
 353
 354 JJB Deploy Job
 355 --------------
 356
 357 Deploy jobs to jenkins-sandbox system via code review comment.
 358
 359 This job checks out the current code review patch and then runs a
 360 ``jenkins-jobs update`` to push a patch defined by the comment.
 361
 362 :Template names:
 363
 364     - {project-name}-jjb-deploy-job
 365     - gerrit-jjb-deploy-job
 366     - github-jjb-deploy-job
 367
 368 :Comment Trigger: jjb-deploy JOB_NAME
 369
 370     .. note::
 371
 372        JOB_NAME can include the * wildcard character to push multiple jobs
 373        matching the pattern. For example ``jjb-deploy builder-jjb-*`` will push
 374        all builder-jjb-* jobs to the sandbox system.
 375
 376 :Required parameters:
 377
 378     :build-node: The node to run build on.
 379     :jenkins-ssh-credential: Credential to use for SSH. (Generally
 380         should be configured in defaults.yaml)
 381
 382 :Optional parameters:
 383
 384     :git-url: URL clone project from. (default: $GIT_URL/$PROJECT)
 385     :gerrit_jjb_deploy_job_triggers: Override Gerrit Triggers.
 386
 387
 388 .. _jjb-merge:
 389
 390 JJB Merge
 391 ---------
 392
 393 Runs `jenkins-jobs update` to update production job configuration
 394
 395 :Template Names:
 396     - {project-name}-jjb-merge
 397     - gerrit-jjb-merge
 398     - github-jjb-merge
 399
 400 :Comment Trigger: remerge
 401
 402 :Required parameters:
 403
 404     :build-node: The node to run build on.
 405     :jenkins-ssh-credential: Credential to use for SSH. (Generally should
 406         be configured in defaults.yaml)
 407
 408 :Optional parameters:
 409
 410     :branch: Git branch to fetch for the build. (default: master)
 411     :build-days-to-keep: Days to keep build logs in Jenkins. (default: 7)
 412     :build-timeout: Timeout in minutes before aborting build. (default: 10)
 413     :git-url: URL clone project from. (default: $GIT_URL/$PROJECT)
 414     :jjb-cache: JJB cache location. (default: $HOME/.cache/jenkins_jobs)
 415     :jjb-version: JJB version to install. (default: see job-template)
 416     :stream: Keyword that can be used to represent a release code-name.
 417         Often the same as the branch. (default: master)
 418     :submodule-recursive: Whether to checkout submodules recursively.
 419         (default: true)
 420     :submodule-timeout: Timeout (in minutes) for checkout operation.
 421         (default: 10)
 422
 423     :gerrit_merge_triggers: Override Gerrit Triggers.
 424     :gerrit_trigger_file_paths: Override file paths which can be used to
 425         filter which file modifications will trigger a build.
 426         (default defined by lf_jjb_common)
 427
 428
 429 .. _jjb-verify:
 430
 431 JJB Verify
 432 ----------
 433
 434 Runs `jenkins-jobs test` to validate JJB syntax
 435
 436 :Template Names:
 437     - {project-name}-jjb-verify
 438     - gerrit-jjb-verify
 439     - github-jjb-verify
 440
 441 :Comment Trigger: recheck|reverify
 442
 443 :Required parameters:
 444
 445     :build-node: The node to run build on.
 446     :jenkins-ssh-credential: Credential to use for SSH. (Generally should
 447         be configured in defaults.yaml)
 448
 449 :Optional parameters:
 450
 451     :branch: Git branch to fetch for the build. (default: master)
 452     :build-concurrent: Whether or not to allow this job to run multiple jobs
 453         simultaneously. (default: true)
 454     :build-days-to-keep: Days to keep build logs in Jenkins. (default: 7)
 455     :build-timeout: Timeout in minutes before aborting build. (default: 10)
 456     :git-url: URL clone project from. (default: $GIT_URL/$PROJECT)
 457     :jjb-cache: JJB cache location. (default: $HOME/.cache/jenkins_jobs)
 458     :jjb-version: JJB version to install. (default: see job-template)
 459     :stream: Keyword that can be used to represent a release code-name.
 460         Often the same as the branch. (default: master)
 461     :submodule-recursive: Whether to checkout submodules recursively.
 462         (default: true)
 463     :submodule-timeout: Timeout (in minutes) for checkout operation.
 464         (default: 10)
 465
 466     :gerrit_verify_triggers: Override Gerrit Triggers.
 467     :gerrit_trigger_file_paths: Override file paths which can be used to
 468         filter which file modifications will trigger a build.
 469         (default defined by lf_jjb_common)
 470
 471 .. _jjb-verify-upstream-gjjb:
 472
 473 JJB Verify Upstream Global JJB
 474 ------------------------------
 475
 476 Runs ``jenkins-jobs test`` to validate JJB syntax for upstream global-jjb
 477 patches. This job is useful to notify upstream that they may be breaking
 478 project level jobs.
 479
 480 :Template Names:
 481     - {project-name}-jjb-verify-upstream-gjjb
 482     - gerrit-jjb-verify-upstream-gjjb
 483
 484 :Comment Trigger: recheck|reverify
 485
 486 :Required parameters:
 487
 488     :build-node: The node to run build on.
 489     :jenkins-ssh-credential: Credential to use for SSH. (Generally should
 490         be configured in defaults.yaml)
 491
 492 :Optional parameters:
 493
 494     :branch: Git branch to fetch for the build. (default: master)
 495     :build-days-to-keep: Days to keep build logs in Jenkins. (default: 7)
 496     :build-timeout: Timeout in minutes before aborting build. (default: 10)
 497     :git-url: URL clone project from. (default: $GIT_URL/$PROJECT)
 498     :jjb-cache: JJB cache location. (default: $HOME/.cache/jenkins_jobs)
 499     :jjb-version: JJB version to install. (default: see job-template)
 500     :stream: Keyword that can be used to represent a release code-name.
 501         Often the same as the branch. (default: master)
 502
 503 .. _info-yaml-verify:
 504
 505 Info YAML Verify
 506 ----------------
 507
 508 Info YAML Verify job validates that INFO.yaml file changes are kept isolated from
 509 other file changes. Verifies INFO.yaml files follow the schema defined in
 510 `global-jjb/info-schema`.
 511
 512 :Template Names:
 513     - {project-name}-info-yaml-verify
 514     - gerrit-info-yaml-verify
 515     - github-info-yaml-verify
 516
 517 :Required parameters:
 518
 519     :build-node: The node to run build on.
 520     :jenkins-ssh-credential: Credential to use for SSH. (Generally should
 521         be configured in defaults.yaml)
 522
 523 :Optional parameters:
 524
 525     :branch: Git branch to fetch for the build. (default: master)
 526     :build-days-to-keep: Days to keep build logs in Jenkins. (default: 7)
 527     :build-timeout: Timeout in minutes before aborting build. (default: 10)
 528     :git-url: URL clone project from. (default: $GIT_URL/$PROJECT)
 529     :stream: Keyword that can be used to represent a release code-name.
 530         Often the same as the branch. (default: master)
 531     :submodule-recursive: Whether to checkout submodules recursively.
 532         (default: true)
 533     :submodule-timeout: Timeout (in minutes) for checkout operation.
 534         (default: 10)
 535
 536     :gerrit_verify_triggers: Override Gerrit Triggers.
 537
 538 .. _license-checker:
 539
 540 License Checker
 541 ---------------
 542
 543 Job to scan projects for files missing license headers.
 544
 545 :Template Names:
 546     - {project-name}-license-check
 547     - gerrit-license-check
 548     - github-license-check
 549
 550 :Optional parameters:
 551
 552     :build-timeout: Timeout in minutes before aborting build. (default: 15)
 553     :file-patterns: Space-separated list of file patterns to scan.
 554         (default: \*.go \*.groovy \*.java \*.py \*.sh)
 555     :spdx-disable: Disable the SPDX-Identifier checker. (default: false)
 556     :lhc-version: Version of LHC to use. (default: 0.2.0)
 557     :license-exclude-paths: Comma-separated list of paths to exclude from the
 558         license checker. The paths used here will be matched using a contains
 559         rule so it is best to be as precise with the path as possible.
 560         For example a path of '/src/generated/' will be searched as
 561         '**/src/generated/**'.
 562         Example: org/opendaylight/yang/gen,protobuff/messages
 563         (default: '')
 564     :licenses-allowed: Comma-separated list of allowed licenses.
 565         (default: Apache-2.0,EPL-1.0,MIT)
 566     :project-pattern: The ANT based pattern for Gerrit Trigger to choose which
 567         projects to trigger job against. (default: '**')
 568
 569 .. _gjjb-openstack-cron:
 570
 571 OpenStack Cron
 572 --------------
 573
 574 Cron job that runs regularly to perform periodic tasks against OpenStack.
 575
 576 This job requires a Config File Provider file named ``clouds-yaml`` available
 577 containing the credentials for the cloud.
 578
 579 :Template Names:
 580     - {project-name}-openstack-cron
 581     - gerrit-openstack-cron
 582     - github-openstack-cron
 583
 584 :Required parameters:
 585
 586     :build-node: The node to run build on.
 587     :jenkins-ssh-credential: Credential to use for SSH. (Generally should
 588         be configured in defaults.yaml)
 589     :jenkins-urls: URLs to Jenkins systems to check for active builds.
 590
 591 :Optional parameters:
 592
 593     :branch: Git branch to fetch for the build. (default: master)
 594     :build-days-to-keep: Days to keep build logs in Jenkins. (default: 7)
 595     :build-timeout: Timeout in minutes before aborting build. (default: 90)
 596     :cron: Time when the packer image should be rebuilt (default: @hourly)
 597     :git-url: URL clone project from. (default: $GIT_URL/$PROJECT)
 598     :openstack-cloud: OS_CLOUD setting to pass to openstack client.
 599         (default: vex)
 600     :openstack-image-cleanup: Whether or not to run the image cleanup script.
 601         (default: true)
 602     :openstack-image-cleanup-age: Age in days of image before marking it for
 603         removal. (default: 30)
 604     :openstack-image-protect: Whether or not to run the image protect script.
 605         (default: true)
 606     :openstack-server-cleanup: Whether or not to run the server cleanup script.
 607         (default: true)
 608     :openstack-stack-cleanup: Whether or not to run the stack cleanup script.
 609         (default: true)
 610     :openstack-volume-cleanup: Whether or not to run the volume cleanup script.
 611         (default: true)
 612     :stream: Keyword that can be used to represent a release code-name.
 613         Often the same as the branch. (default: master)
 614     :submodule-recursive: Whether to checkout submodules recursively.
 615         (default: true)
 616     :submodule-timeout: Timeout (in minutes) for checkout operation.
 617         (default: 10)
 618
 619 Minimal Example:
 620
 621 .. literalinclude:: ../../.jjb-test/lf-ci-jobs/openstack-cron-minimal.yaml
 622
 623 Full Example:
 624
 625 .. literalinclude:: ../../.jjb-test/lf-ci-jobs/openstack-cron-full.yaml
 626
 627
 628 .. _gjjb-packer-merge:
 629
 630 Packer Merge
 631 ------------
 632
 633 Packer Merge job runs `packer build` to build system images in the cloud.
 634
 635 :Template Names:
 636     - {project-name}-packer-merge-{platforms}-{templates}
 637     - gerrit-packer-merge
 638     - github-packer-merge
 639
 640 :Comment Trigger: remerge
 641
 642 :Required parameters:
 643
 644     :build-node: The node to run build on.
 645     :jenkins-ssh-credential: Credential to use for SSH. (Generally should
 646         be configured in defaults.yaml)
 647     :mvn-settings: The name of settings file containing credentials for
 648         the project.
 649     :platforms: Platform or distribution to build. Typically json file
 650         found in the packer/vars directory. (Example: centos)
 651     :template: System template to build. Typically shell script found in
 652         the packer/provision directory. (Example: java-builder)
 653
 654 :Optional parameters:
 655
 656     :cron: Time when the packer image should be rebuilt (default: @monthly)
 657     :branch: Git branch to fetch for the build. (default: master)
 658     :build-days-to-keep: Days to keep build logs in Jenkins. (default: 7)
 659     :build-timeout: Timeout in minutes before aborting build. (default: 90)
 660     :git-url: URL clone project from. (default: $GIT_URL/$PROJECT)
 661     :openstack: Packer template uses an OpenStack builder (default: true).
 662     :openstack-cloud: Sets OS_CLOUD variable to the value of this parameter.
 663         (default: vex).
 664     :packer-cloud-settings: Name of settings file containing credentials
 665         for the cloud that packer will build on. (default: packer-cloud-env)
 666     :packer-version: Version of packer to install / use in build. (default: 1.0.2)
 667     :stream: Keyword that can be used to represent a release code-name.
 668         Often the same as the branch. (default: master)
 669     :submodule-recursive: Whether to checkout submodules recursively.
 670         (default: true)
 671     :submodule-timeout: Timeout (in minutes) for checkout operation.
 672         (default: 10)
 673
 674     :gerrit_verify_triggers: Override Gerrit Triggers.
 675
 676 Test an in-progress patch
 677 ^^^^^^^^^^^^^^^^^^^^^^^^^
 678
 679 To test an in-progress patch from a GitHub Pull Request. Upload this
 680 job to the :doc:`Jenkins Sandbox <lfdocs:jenkins-sandbox>`. Then when manually
 681 building the job replace the GERRIT_REFSPEC parameter with the GitHub Pull
 682 Request number of the patch you would like to test.
 683
 684 Example GitHub:
 685
 686 .. code-block:: none
 687
 688    GERRIT_REFSPEC: origin/pr/49/merge
 689
 690 .. _gjjb-packer-verify:
 691
 692 Packer Verify
 693 -------------
 694
 695 Packer Verify job runs `packer validate` to verify packer configuration.
 696
 697 :Template Names:
 698     - {project-name}-packer-verify
 699     - gerrit-packer-verify
 700     - github-packer-verify
 701
 702 :Comment Trigger: recheck|reverify
 703
 704 :Required parameters:
 705
 706     :build-node: The node to run build on.
 707     :jenkins-ssh-credential: Credential to use for SSH. (Generally should
 708         be configured in defaults.yaml)
 709     :mvn-settings: The name of settings file containing credentials for
 710         the project.
 711
 712 :Optional parameters:
 713
 714     :branch: Git branch to fetch for the build. (default: master)
 715     :build-days-to-keep: Days to keep build logs in Jenkins. (default: 7)
 716     :build-timeout: Timeout in minutes before aborting build. (default: 10)
 717     :git-url: URL clone project from. (default: $GIT_URL/$PROJECT)
 718     :openstack: Packer template uses an OpenStack builder (default: true).
 719     :openstack-cloud: Sets OS_CLOUD variable to the value of this parameter.
 720         (default: vex).
 721     :packer-cloud-settings: Name of settings file containing credentials
 722         for the cloud that packer will build on. (default: packer-cloud-env)
 723     :packer-version: Version of packer to install / use in build. (default: 1.0.2)
 724     :stream: Keyword that can be used to represent a release code-name.
 725         Often the same as the branch. (default: master)
 726     :submodule-recursive: Whether to checkout submodules recursively.
 727         (default: true)
 728     :submodule-timeout: Timeout (in minutes) for checkout operation.
 729         (default: 10)
 730
 731     :gerrit_verify_triggers: Override Gerrit Triggers.
 732     :gerrit_trigger_file_paths: Override file paths which can be used to
 733         filter which file modifications will trigger a build.
 734
 735
 736 Puppet Verify
 737 -------------
 738
 739 Runs puppet-lint in the ``puppet-dir`` directory. puppet-lint runs recursively,
 740 so the base directory is usually the best place to run from.
 741
 742 :Template Names:
 743
 744     - {project-name}-puppet-verify
 745     - gerrit-puppet-verify
 746     - github-puppet-verify
 747
 748 :Comment Trigger: recheck|reverify
 749
 750 :Required Parameters:
 751
 752     :build-node: The node to run build on.
 753     :jenkins-ssh-credential: Credential to use for SSH. (Generally set
 754         in defaults.yaml)
 755
 756 :Optional Parameters:
 757
 758     :branch: The branch to build against. (default: master)
 759     :build-days-to-keep: Days to keep build logs in Jenkins. (default: 7)
 760     :build-timeout: Timeout in minutes before aborting build. (default: 15)
 761     :gerrit_trigger_file_paths: Override file paths which used to filter which
 762         file modifications will trigger a build. Refer to JJB documentation for
 763         "file-path" details.
 764         https://docs.openstack.org/infra/jenkins-job-builder/triggers.html#triggers.gerrit
 765     :git-url: URL clone project from. (default: $GIT_URL/$GERRIT_PROJECT)
 766     :puppet-dir: Directory containing the project's puppet module(s) relative
 767         to the workspace.
 768         (default: '')
 769     :puppet-lint-version: Version of puppet-lint to use for testing.
 770         (default: 2.3.6)
 771     :stream: Keyword representing a release code-name.
 772         Often the same as the branch. (default: master)
 773     :submodule-recursive: Whether to checkout submodules recursively.
 774         (default: true)
 775     :submodule-timeout: Timeout (in minutes) for checkout operation.
 776         (default: 10)