1 .. _lf-global-jjb-release:
7 Projects can create a releases directory and then place a release file in it.
8 Jenkins will pick this up and then promote the artifact from the staging log
9 directory (log_dir) and tag the release with the defined version.
10 if a maven_central_url is given artifact will be pushed there as well.
12 example of a projects release file
16 $ cat releases/1.0.0.yaml
18 distribution_type: 'maven'
20 project: 'zzz-test-release'
21 log_dir: 'zzz-test-release-maven-stage-master/17/'
22 maven_central_url: 'oss.sonatype.org'
24 lftools nexus release is used so there must be a lftoolsini section in jenkins
25 configfiles with a [nexus] section for auth.
31 ----------------------
33 Release verify and merge jobs are the same except for their scm, trigger, and
34 builders definition. This anchor is the common template.
46 - checkout ref from taglist.log
47 - applies the $PROJECT.bundle
48 - signs, tags and pushes
52 lftools nexus release --server $NEXUS_URL $STAGING_REPO
56 - {project-name}-releases-merge
58 :Comment Trigger: remerge
62 :build-node: The node to run build on.
63 :jenkins-ssh-credential: Credential to use for SSH. (Generally set
65 :stream: run this job against: master
69 :branch: Git branch to fetch for the build. (default: master)
70 :build-days-to-keep: Days to keep build logs in Jenkins. (default: 7)
71 :build-timeout: Timeout in minutes before aborting build. (default: 15)
72 :project-pattern: Project to trigger build against. (default: \*\*)
74 :gerrit_merge_triggers: Override Gerrit Triggers.
75 :gerrit_trigger_file_paths: Override file paths filter which checks which
76 file modifications will trigger a build.
80 pattern: 'releases/*.yaml'
86 Release verify job checks the schema and ensures that the staging-repo.txt.gz
87 is available on the job.
91 - checkout ref from taglist.log
92 - applies the $PROJECT.bundle
93 - signs and shows signature
97 - {project-name}-releases-verify
99 :Comment Trigger: recheck|reverify
101 :Required Parameters:
103 :build-node: The node to run build on.
104 :jenkins-ssh-credential: Credential to use for SSH. (Generally set
106 :stream: run this job against: master
108 :Optional Parameters:
110 :branch: Git branch to fetch for the build. (default: master)
111 :build-days-to-keep: Days to keep build logs in Jenkins. (default: 7)
112 :build-node: The node to run build on.
113 :build-timeout: Timeout in minutes before aborting build. (default: 15)
114 :doc-dir: Directory where tox will place built docs.
115 as defined in the tox.ini (default: docs/_build/html)
116 :gerrit-skip-vote: Skip voting for this job. (default: false)
117 :git-url: URL clone project from. (default: $GIT_URL/$PROJECT)
118 :project-pattern: Project to trigger build against. (default: \*\*)
120 :gerrit_verify_triggers: Override Gerrit Triggers.
121 :gerrit_trigger_file_paths: Override file paths filter which checks which
122 file modifications will trigger a build.
126 pattern: 'releases/*.yaml'