Integrate Jenkins and Create a Build

ZenTao open source series adds the function of integrating Jenkins.

 

You can integrate Jenkins and create a build. Trigger builds through Jenkins' pipeline to provide continuous integration services.

1. Install and configure Jenkins

1.1 Install Jenkins server

Install documentation: https://www.jenkins.io/doc/book/installing/

Note: It might take a while to install Jenkins and some plugins need to be installed.

1.2 Configure Jenkins

Log in to Jenkins, create an item, and build a freestyle project. 

1.3 Execute Shell

GIT
	===Jenkins export command===
	echo "PARAM_TAG = $PARAM_TAG";
	echo "PARAM_REVISION = $PARAM_REVISION";
	[ -z ${PARAM_TAG} ] || git checkout "${PARAM_TAG}"
	[ -z ${PARAM_REVISION} ] || git checkout "${PARAM_REVISION}"
	cat README
	===Note===
		Parameter
		PARAM_TAG：tag name
		PARAM_REVISION：revison number
		Initialize
		git clone https://gitee.com/aaronchen2k/ci_test.git
		Export tag
		export PARAM_TAG=tag111
		[ -z ${PARAM_TAG} ] || git checkout "${PARAM_TAG}"
		Export revision
		export PARAM_REVISION=6c3a7bf931855842e261c7991bb143c1e0c3fb19
		[ -z ${PARAM_REVISION} ] || git checkout "${PARAM_REVISION}"
SVN
	===Jenkins command after export===
	echo "PARAM_TAG = $PARAM_TAG";
	echo "PARAM_REVISION = $PARAM_REVISION";
	svn upgrade
	[ -z ${PARAM_TAG} ] || svn switch --ignore-ancestry "${PARAM_TAG}" 
	[ -z ${PARAM_REVISION} ] || svn up -r "${PARAM_REVISION}" 
	cat README
	===Note===
		Parameter
		PARAM_TAG：tag url
		PARAM_REVISION：revison number
		Initialize
		svn checkout --username aaronchen2k --password P2ssw0rd svn://svnbucket.com/aaronchen2k/ci_test_svn/trunk/ .
		Export tag
	    export PARAM_TAG=svn://svnbucket.com/aaronchen2k/ci_test_svn/tags/tag111
	    [ -z ${PARAM_REVISION} ] || svn upgrade
		[ -z ${PARAM_TAG} ] || svn switch --ignore-ancestry "${PARAM_TAG}" 
		Export revision
		export PARAM_REVISION=9
		[ -z ${PARAM_REVISION} ] || svn upgrade
		[ -z ${PARAM_REVISION} ] || svn up -r "${PARAM_REVISION}"

Note: Don't tick the box of "Prevent Cross-Site Request Forgery"

If the Jenkins version is high (To disable CSRF: Add the relevant unprotected parameter configuration before starting Jenkins)

-Dhudson.security.csrf.GlobalCrumbIssuerConfiguration=false

References

https://unix.stackexchange.com/questions/444177/how-to-disable-the-csrf-protection-in-jenkins-by-default

http://www.likecs.com/show-105574.html

a. If Jenkins is running under Tomcat, you only need to add configuration to the tomcat startup script; if it is deployed in the form of a jar package, you only need to add configuration parameters at startup.

b. If docker is deployed, you need to configure the java environment variable

FROM jenkins/jenkins:latest
ENV JAVA_OPTS -Djava.net.preferIPv4Stack=true -Dhudson.security.csrf.GlobalCrumbIssuerConfiguration=false

2. Maintain Jenkins server

2.1 Create Jenkins Server

Create Jenkins Server Page:

 

URL: Fill in the server address of Jenkins, the default port is 8080.

 

Username and password are required for building tasks.

 

Please disable the "Prevent Cross-Site Request Forgery" option in the Jenkins global security settings when using the password.

2.2 2. Edit and delete the Jenkins server

You can review the Jenkins Server on the list page if they are created successfully.

 

You can edit and delete the Jenkins Server through the buttons on the right. 

Jenkins that has created an associated build task can't be deleted. You need to cancel and delete the associated build tasks before deleting it.

3. Compile and create a job

3.1 Create a job

Click the "Create Job" button on the top right corner. 

Create Job Page:

 

Engine: Jenkins

 

Jenkins Server: The Jenkins Server will be shown in the list.

 

Pipeline: The pipeline in the selected Jenkins server. 

Note: If the Jenkins pipeline is empty after the Jenkins server is selected (provided that there are tasks in Jenkins), go to the Jenkins global settings and tick the box of "Anonymous users have readable permissions".

Trigger:

Tag: Execute when a new tag is available in the GIT repository. 

Code Commit: Execute when a word in a comment matches the keyword set here.

Schedule: Execute at the set date and time. 

SVN Tag Watch Path: Execute when there are directory changes in the SVN monitoring directory.

You can review the tasks on the list page if they are created successfully.

 

You can review the history, edit, execute, and delete the tasks through the buttons on the right. 

3.2 Schedule

It is necessary to ensure that the scheduled task is turned on to build it successfully and ensure that the three scheduled tasks below are normal. 

3.3 Execute the job manually

Click the "Execute Job" button on the right. 

3.4 Review the history and log

You can view the engine, repository, trigger, status, time, and log in the history list. 

Click Log to view details.