11 Sonar job which runs cmake && make then publishes to Sonar.
13 This job purposely runs on the master branch as there are configuration needed
14 to support multi-branch.
18 - {project-name}-cmake-sonar
22 :Comment Trigger: run-sonar
26 :build-node: The node to run build on.
27 :jenkins-ssh-credential: Credential to use for SSH. (Configure in
29 :sonar-scanner-version: Version of sonar-scanner to install.
30 :sonarcloud-project-key: SonarCloud project key.
31 :sonarcloud-project-organization: SonarCloud project organization.
32 :sonarcloud-api-token: SonarCloud API Token.
36 :build-days-to-keep: Days to keep build logs in Jenkins. (default: 7)
37 :build-timeout: Timeout in minutes before aborting build. (default: 60)
38 :cmake-opts: Parameters to pass to cmake. (default: '')
39 :cron: Cron schedule when to trigger the job. This parameter also
40 supports multiline input via YAML pipe | character in cases where
41 one may want to provide more than 1 cron timer. (default: '@daily')
42 :git-url: URL clone project from. (default: $GIT_URL/$PROJECT)
43 :install-prefix: CMAKE_INSTALL_PREFIX to use for install.
44 (default: $BUILD_DIR/output)
53 :make-opts: Parameters to pass to make. (default: '')
54 :pre-build: Shell script to run before performing build. Useful for
55 setting up dependencies. (default: '')
56 :submodule-recursive: Whether to checkout submodules recursively.
58 :submodule-timeout: Timeout (in minutes) for checkout operation.
60 :submodule-disable: Disable submodule checkout operation.
63 :gerrit_sonar_triggers: Override Gerrit Triggers.
68 Stage job which runs cmake && make && make install and then packages the
69 project into a tar.xz tarball to produce a release candidate.
73 - {project-name}-cmake-stage-{stream}
77 :Comment Trigger: stage-release
81 :build-node: The node to run build on.
82 :jenkins-ssh-credential: Credential to use for SSH.
83 (Configure in defaults.yaml)
84 :nexus-group-id: The Maven style Group ID for the namespace of the project
86 :staging-profile-id: The unique Nexus Staging Profile ID for the project.
87 Contact your infra admin if you do not know it.
91 :branch: Git branch to fetch for the build. (default: master)
92 :build-days-to-keep: Days to keep build logs in Jenkins. (default: 7)
93 :build-dir: Directory to build the project in. (default: $WORKSPACE/target)
94 :build-timeout: Timeout in minutes before aborting build. (default: 60)
95 :cmake-opts: Parameters to pass to cmake. (default: '')
96 :git-url: URL clone project from. (default: $GIT_URL/$PROJECT)
97 :install-prefix: CMAKE_INSTALL_PREFIX to use for install.
98 (default: $BUILD_DIR/output)
107 :make-opts: Parameters to pass to make. (default: '')
108 :pre-build: Shell script to run before performing build. Useful for
109 setting up dependencies. (default: '')
110 :stream: Keyword that to represent a release code-name.
111 Often the same as the branch. (default: master)
112 :submodule-recursive: Whether to checkout submodules recursively.
114 :submodule-timeout: Timeout (in minutes) for checkout operation.
116 :submodule-disable: Disable submodule checkout operation.
118 :version: (default: '') Project version to stage release as. There are 2
119 methods for using this value:
121 1) Defined explicitly here.
122 2) Leave this value blank and set /tmp/artifact_version
124 Use method 2 in conjunction with 'pre-build' configuration to
125 generate the artifact_version automatically from files in the
126 project's repository. For example with pre-build script:
131 MAJOR_VERSION="$(grep 'set(OCIO_VERSION_MAJOR' CMakeLists.txt | awk '{{print $NF}}' | awk -F')' '{{print $1}}')"
132 MINOR_VERSION="$(grep 'set(OCIO_VERSION_MINOR' CMakeLists.txt | awk '{{print $NF}}' | awk -F')' '{{print $1}}')"
133 PATCH_VERSION="$(grep 'set(OCIO_VERSION_PATCH' CMakeLists.txt | awk '{{print $NF}}' | awk -F')' '{{print $1}}')"
134 echo "${{MAJOR_VERSION}}.${{MINOR_VERSION}}.${{PATCH_VERSION}}" > /tmp/artifact_version
139 Verify job which runs cmake && make && make install to test a project build..
143 - {project-name}-cmake-verify-{stream}
144 - gerrit-cmake-verify
145 - github-cmake-verify
147 :Comment Trigger: recheck|reverify
149 :Required parameters:
151 :build-node: The node to run build on.
152 :jenkins-ssh-credential: Credential to use for SSH.
153 (Configure in defaults.yaml)
155 :Optional parameters:
157 :branch: Git branch to fetch for the build. (default: master)
158 :build-days-to-keep: Days to keep build logs in Jenkins. (default: 7)
159 :build-dir: Directory to build the project in. (default: $WORKSPACE/target)
160 :build-timeout: Timeout in minutes before aborting build. (default: 60)
161 :cmake-opts: Parameters to pass to cmake. (default: '')
162 :git-url: URL clone project from. (default: $GIT_URL/$PROJECT)
163 :install-prefix: CMAKE_INSTALL_PREFIX to use for install.
164 (default: $BUILD_DIR/output)
173 :make-opts: Parameters to pass to make. (default: '')
174 :pre-build: Shell script to run before performing build. Useful for
175 setting up dependencies. (default: '')
176 :stream: Keyword that to represent a release code-name.
177 Often the same as the branch. (default: master)
178 :submodule-recursive: Whether to checkout submodules recursively.
180 :submodule-timeout: Timeout (in minutes) for checkout operation.
182 :submodule-disable: Disable submodule checkout operation.
185 :gerrit_verify_triggers: Override Gerrit Triggers.
186 :gerrit_trigger_file_paths: Override file paths which to filter which file
187 modifications will trigger a build.