commit | 12dd647948de542655028b1dcda824256e0dc89e | [log] [tgz] |
---|---|---|
author | Andrew Grimberg <agrimberg@linuxfoundation.org> | Mon May 13 14:54:32 2019 -0700 |
committer | Andrew Grimberg <agrimberg@linuxfoundation.org> | Mon May 13 14:54:32 2019 -0700 |
tree | 65be4a0f9888207271e271b541cad70ac09f43dc | |
parent | 9557d866519b0c849e639d842da92a9222a7ab99 [diff] |
Update all references to Gerrit Gerrit is moving from gerrit.oran-osc.org to gerrit.o-ran-sc.org Change-Id: I9eeb1d609978975ad149b5408ec3924eb3eeb6c4 Signed-off-by: Andrew Grimberg <agrimberg@linuxfoundation.org>
This repo contains configuration files for Jenkins jobs for the O-RAN SC project.
Custom JJB templates are defined for projects that use Maven to compile Java code and build a Docker image. These projects should use the following jobs in the project.yaml file::
jobs: - gerrit-maven-docker-verify - gerrit-maven-docker-merge - gerrit-maven-docker-stage
These instructions explain how to test the templates using the Jenkins sandbox. This catches errors before submitting the changes as Gerrit reviews.
Install the Jenkins job builder:
pip install jenkins-job-builder
Check out the global JJB templates submodule within this repo:
git submodule update --init
Check sanity by running the Jenkins job-builder script in this directory:
jenkins-jobs test -r jjb
Login (after requesting membership in group oran-jenkins-sandbox-access) at the Jenkins sandbox:
https://jenkins.o-ran-sc.org/sandbox
Get the authentication token from the sandbox: a) click on your user name (top right) b) click Configure (left menu) c) under API Token, click Add new Token (button) d) copy the token string
Create a config file jenkins.ini using the following template and your credentials (user name and API token from above)::
[job_builder] ignore_cache=True keep_descriptions=False recursive=True [jenkins] query_plugins_info=False url=https://jenkins.o-ran-sc.org/sandbox user=YOUR-USER-NAME password=YOUR-API-TOKEN
Build and deploy a specific job using the EXACT job name.
jenkins-jobs --conf jenkins.ini update jjb your-job-name-here
Examples:
jenkins-jobs --conf jenkins.ini update jjb project-maven-docker-verify-master-mvn33-openjdk8
In the sandbox visit the job page, then click the button "Build with parameters" in left menu.
This explains how to launch a "verify" job in the Sandbox on an open review. Most "verify" jobs accept parameters to build code in a review submitted to Gerrit. You must specify the change ref spec, which is a Git branch name. Get this by inspecting Gerrit's "download" links at the top right. The branch name will be something like this:
refs/changes/78/578/2
The first number is a mystery to me; the second number is the Gerrit change number; the third number is the patch set within the change.
Enter this name for both the GERRIT_BRANCH and the GERRIT_REFSPEC parameters, then click Build.