X-Git-Url: https://gerrit.linuxfoundation.org/infra/gitweb?a=blobdiff_plain;f=docs%2Fjjb%2Flf-ci-jobs.rst;h=57e01f9c4f1a61e8879e311b494fc31d7143bf99;hb=0218d6c3299a6b1a722b8c15de1985f9ad0031d3;hp=8b1324a9ec06b6c3becd10663e80af8979384e08;hpb=7eb6004ea840df565c6df3620a71668a58f3df0a;p=releng%2Fglobal-jjb.git diff --git a/docs/jjb/lf-ci-jobs.rst b/docs/jjb/lf-ci-jobs.rst index 8b1324a9..57e01f9c 100644 --- a/docs/jjb/lf-ci-jobs.rst +++ b/docs/jjb/lf-ci-jobs.rst @@ -29,6 +29,24 @@ Recommended jobs that should be deployed CI using GitHub. - github-jjb-merge - github-jjb-verify +{project-name}-info-yaml-jobs +----------------------------- + +Jobs to verify INFO.yaml file changes. + +:Includes: + + - gerrit-info-yaml-verify + +{project-name}-github-info-yaml-jobs +------------------------------------ + +Jobs to verify INFO.yaml file changes using Github. + +:Includes: + + - github-info-yaml-verify + {project-name}-packer-jobs -------------------------- @@ -81,20 +99,30 @@ Provides jenkins_jobs.ini configuration for Jenkins sandbox. .. todo:: This needs to be consolidated into lf-infra-jjbini when JJB 2.0 is available -lf-packer-verify-file-paths ---------------------------- +lf-packer-common +---------------- -Gerrit file-paths for packer verify jobs. +Common packer configuration. lf-packer-file-paths -------------------- Gerrit file-paths for packer jobs. -lf-packer-common ----------------- +lf-packer-parameters +-------------------- -Common packer configuration. +Parameters useful for packer related tasks. + +:Parameters: + + :packer-version: Version of packer to install / use. + (shell: PACKER_VERSION) + +lf-packer-verify-file-paths +--------------------------- + +Gerrit file-paths for packer verify jobs. Job Templates ============= @@ -150,6 +178,8 @@ Full Example: .. literalinclude:: ../../.jjb-test/lf-ci-jobs/jenkins-cfg-merge-full.yaml :language: yaml +.. _jenkins-cfg-envvar: + Global Environment Variables ^^^^^^^^^^^^^^^^^^^^^^^^^^^^ @@ -180,6 +210,9 @@ OpenStack Cloud plugin version supported: * 2.30 * 2.31 * 2.32 +* 2.33 +* 2.34 +* 2.35 Cloud configuration are managed via a directory structure in ci-management as follows: @@ -362,6 +395,37 @@ Runs `jenkins-jobs test` to validate JJB syntax filter which file modifications will trigger a build. (default defined by lf_jjb_common) +.. _info-yaml-verify: + +Info YAML Verify +---------------- + +Info YAML Verify job validates that INFO.yaml file changes are kept isolated from +other file changes. Verifies INFO.yaml files follow the schema defined in +`global-jjb/info-schema`. + +:Template Names: + - {project-name}-info-yaml-verify + - gerrit-info-yaml-verify + - github-info-yaml-verify + +:Required parameters: + + :build-node: The node to run build on. + :jenkins-ssh-credential: Credential to use for SSH. (Generally should + be configured in defaults.yaml) + +:Optional parameters: + + :branch: Git branch to fetch for the build. (default: master) + :build-days-to-keep: Days to keep build logs in Jenkins. (default: 7) + :build-timeout: Timeout in seconds before aborting build. (default: 10) + :git-url: URL clone project from. (default: $GIT_URL/$PROJECT) + :stream: Keyword that can be used to represent a release code-name. + Often the same as the branch. (default: master) + :submodule-recursive: Whether to checkout submodules recursively. + (default: true) + :gerrit_verify_triggers: Override Gerrit Triggers. .. _gjjb-packer-merge: @@ -389,6 +453,7 @@ Packer Merge job runs `packer build` to build system images in the cloud. :Optional parameters: + :cron: Time when the packer image should be rebuilt (default: @monthly) :branch: Git branch to fetch for the build. (default: master) :build-days-to-keep: Days to keep build logs in Jenkins. (default: 7) :build-timeout: Timeout in seconds before aborting build. (default: 10)