Skip to main content
Version: Next

Jenkins

Jenkins is self-contained, open source automation server, used for CI/CD Pipeline . Jenkins is an automation server for supporting practically every tool as a part of the delivery pipelines.

devops

Prepare​

When referring to this document to use Jenkins, please read and ensure the following points:

  • Login to Websoft9 Console and find or install Jenkins:

    • Go to My Apps listing applications
    • Go to App Store installing target application

  • This application is installed by Websoft9 console.

  • The purpose of this application complies with the MIT open source license agreement.

  • Configure the domain name or server security group opens external network ports for application access.

Getting started​

Initial setup​

  1. When completing the installation of Jenkins in the Websoft9 console, get the applicaiton's overview and access information from My Apps

  2. Access the initialization page, Jenkins will prompt you to unlock it

  3. Access the Jenkins container and run the following command to retrieve the unlock password

    cat /var/jenkins_home/secrets/initialAdminPassword

  4. After successfully logging in, complete the following steps: install plugins, create administrators, etc

  5. Go to the Jenkins Console and start using it

Github + Jenkins automatic construction​

The following steps will help you quickly get started with Jenkins to automatically build and deploy projects on GitHub:

  1. Set up Personal access tokens in GitHub for Jenkins connection

  2. Ensure that the Github plugin is installed and enabled in Jenkins

  3. Create a job in Jenkins, configure the source code repository from GitHub, and set the triggering strategy

Configuration options​

  • Install and manage plugins: Manage Jenkin > Plugins

  • Multilingual(✅)

  • SMTP: Install the Jenkins plugin Email Extension, then configure it in Manage Jenkins > Configure System

  • Jenkins CLI

    java -jar jenkins-cli.jar [-s JENKINS_URL] [global options...] command [command options...] [arguments...]

  • REST API

    curl JENKINS_URL/job/JOB_NAME/buildWithParameters --user USER:TOKEN --data id=123 --data verbosity=high

  • Online upgrade(✅): When an update is available, the backend will prompt you, allowing you to update and upgrade online through the backend

Administer​

  • Backup and Recovery: The Backup plugin provides backup and recovery capabilities for Jenkins.

Troubleshooting​