This repo contains step-by-step instructions how to install Jenkins and sample Pipelines for CI/CD (Continuous Integration and Continuous Delivery/Deployment).
- Execute for Docker:
docker run -p 8080:8080 -p 50000:50000 -v jenkins_home:/var/jenkins_home jenkins/jenkins:lts-jdk11 - Execute for Linux Snaps:
sudo snap install --classic jenkins - Otherwise, download and install it from: https://jenkins.io/download (available for Arch Linux, FreeBSD, Gentoo, macOS, OpenBSD, OpenIndiana Hipster, openSUSE, Red Hat/Fedora/Alma/Rocky/CentOS, Ubuntu/Debian, Windows)
- NOTE: Pipelines are supported in Jenkins version 2.337 or newer.
- Launch your Web browser and enter the URL: http://HOSTNAME:8080 (replace HOSTNAME by the computer name where Jenkins has been installed).
- Execute
sudo cat /PATH/TO/initialAdminPassword(replace /PATH/TO) to view the initial password saved by Jenkins during the installation. - Enter the initial password to unlock Jenkins.
- Click on 'Select plugins to install'
- Add these plugins: 'Build Name and Description Setter'
- Click Install and wait until the installation has finished.
- Enter the username, password (twice), and the full name.
- Afterward, enter your Jenkins URL and log in.
- In the dashboard click on: + Create element (on left side).
- Enter a job name (e.g. "sample-pipeline") and select Pipeline, then press the OK button.
- The job configuration is displayed now - scroll down and select the Pipeline script.
- As script copy&paste the content of the Jenkinsfiles/sample.txt.
- Click the Save button.
- Click on Dashboard (on left side).
- In your job list press the green Play button (on right side).
- The Stage View visualizes the whole build process in a neat table.
You're all set. Welcome to the Jenkins ecosystem! More background information can be found here:
- Homepage at: https://www.jenkins.io
- User Documentation at: https://www.jenkins.io/doc
- Handbook at: https://www.jenkins.io/doc/book
- Use the Jenkins app on your smartphone to trigger and watch builds anytime anywhere. It's available for free at: https://play.google.com/store/apps/details?id=com.mobilabsolutions.jenkins.app
- Add more user accounts: click Manage Jenkins > Users to create and manage user accounts.
- Add more plugins: visit the Jenkins Plugins Index at: https://plugins.jenkins.io and discover 1900+ plugins.
- Add more machines for a build farm. More information at: https://www.jenkins.io/doc/book/using/using-agents
- Add more jobs: see the sample Pipeline scripts in subfolder 📂Jenkinsfiles to build GitHub projects.
- Back up Jenkins: just zip the Jenkins home folder (at: ~/.jenkins or at: /var/snap/jenkins) and copy it to another disk.
Anything missing or needs to be improved? Don't be shy, just send your email feedback to: markus.fleschutz [at] gmail.com
This open source project is licensed under the CC0 license. All trademarks are the property of their respective owners.