Jenkins Essentials Beginner’s Guide to Fundamentals, Installation, and Setup

1. Introduction to Jenkins

What is Jenkins?

Jenkins is an open-source automation server used to automate software development processes such as building, testing, and deploying applications. It helps developers integrate code changes continuously and ensures high software quality.

Importance of Jenkins in DevOps

Jenkins plays a vital role in DevOps by enabling Continuous Integration (CI) and Continuous Deployment (CD). It automates repetitive tasks, accelerates the software release cycle, and ensures smooth collaboration between development and operations teams.

Key Features of Jenkins

1. Open-source and Extensible: Supports hundreds of plugins.
2. Distributed Builds: Can run on multiple machines for efficient execution.
3. Easy Integration: Works with Git, Docker, Kubernetes, and more.
4. Pipeline as Code: Uses Jenkinsfile to define automation workflows.

2. Understanding CI/CD and Jenkins' Role

What is Continuous Integration (CI)?

CI is a development practice where developers frequently merge code changes into a shared repository, automatically triggering builds and tests.

What is Continuous Deployment/Delivery (CD)?

1. Continuous Delivery: Ensures every change is deployable at any time but requires manual approval.
2. Continuous Deployment: Automatically deploys every change to production after passing tests.

How Jenkins Automates CI/CD

Jenkins automates CI/CD by:

1. Pulling code from version control systems like GitHub.
2. Running automated tests.
3. Deploying applications to staging or production environments.

3. Prerequisites for Installing Jenkins

System Requirements

1. Minimum: 512MB RAM, 1GB disk space
2. Recommended: 4GB RAM, SSD, multi-core processor

Supported Operating Systems

1. Windows
2. Linux (Ubuntu, CentOS, Debian)
3. macOS

Software Dependencies

1. Java (JDK 11 or later)
2. Web Browser (for UI access)
3. Optional: Docker (for containerized installations)

4. Installing Jenkins on Different Platforms

Windows Installation

1. Download the Jenkins Windows Installer (.msi) from jenkins.io.
2. Run the installer and follow the setup wizard.
3. Start the Jenkins service and access it via http://localhost:8080.

Linux (Ubuntu/CentOS) Installation

1. Install Java: sudo apt install openjdk-11-jdk
2. Add the Jenkins repository and install Jenkins:

1. Start Jenkins: sudo systemctl start jenkins

Mac Installation

1. Install Homebrew (if not installed).
2. Run: brew install jenkins-lts
3. Start Jenkins: brew services start jenkins-lts

Docker Installation (Optional)

1. Install Docker on your system.
2. Run Jenkins using Docker:

5. Setting Up Jenkins for First Use

Starting the Jenkins Service

After installation, Jenkins runs as a service. You can access it via http://localhost:8080 in a browser.

Unlocking Jenkins and Initial Configuration

1. Locate the initial admin password from the terminal or log file (/var/lib/jenkins/secrets/initialAdminPassword).

1. Enter the password on the Jenkins UI to proceed.

Installing Recommended Plugins

Jenkins suggests installing essential plugins like Git, Pipeline, and Build Tools. Select "Install Suggested Plugins."

Creating the First Admin User

Set up an administrator account with a username and password for secure access.

6. Exploring Jenkins Dashboard

Overview of the UI

1. Dashboard: Displays all jobs and builds.
2. New Item: Create jobs and pipelines.
3. Manage Jenkins: System settings and plugin management.

Understanding Jobs, Pipelines, and Builds

1. Jobs: Define automation tasks (Freestyle, Pipeline, etc.).
2. Pipelines: Advanced scripting for multi-step workflows.
3. Builds: Execution of a job triggered manually or automatically.

Configuring Global Settings

Modify settings like system logs, security, and node configurations.

7. Creating Your First Jenkins Job

Freestyle Project vs Pipeline

1. Freestyle Project: Simple UI-based job for basic tasks.
2. Pipeline: Script-based workflow automation using Groovy.

Running a Simple Job

1. Click New Item > Select Freestyle Project.
2. Configure Source Code Management (Git, SVN).
3. Add a Build Step (e.g., Run Shell Script).
4. Save and trigger the build.

Viewing Build Logs and Results

1. Click on the job and check the Console Output for logs.
2. View build status: Success , Failure , Unstable .

8. Troubleshooting Common Issues

Installation Errors and Fixes

1. Jenkins Not Starting: Check logs using journalctl -u jenkins.
2. Java Version Issue: Ensure Java 11+ is installed.

Plugin Conflicts

1. Solution: Update plugins from Manage Jenkins > Plugin Manager.
2. Rollback Option: Disable problematic plugins.

Port and Firewall Issues

1. Port 8080 Already in Use? Change it via JENKINS_PORT=9090.
2. Firewall Blocking Jenkins? Allow access:

Conclusion and Next Steps

1. You’ve learned Jenkins fundamentals, installation, and setup.
2. Next, explore advanced features like Jenkins pipelines, integration with GitHub, and deployment strategies.
3. Keep experimenting with Jenkins to automate your software delivery process!