Jenkins 2 Installation Guide

Overview

This guide provides instructions for installing Jenkins 2 on various operating systems, including Ubuntu, CentOS 7, and RHEL 7. The installation process includes minimal configuration, such as setting up SMTP and installing necessary plugins.

What This Role Does

• Installs Jenkins 2 on supported operating systems
• Configures basic settings, including SMTP and plugins

Key Tasks

• Jenkins installation
• Plugin installation
• Plugin configuration using JCasC (Jenkins Configuration as Code)
  • SMTP settings configuration via JCasC
  • Adding credentials via JCasC
• Plugin configuration using Groovy scripts
  • SMTP settings configuration via Groovy scripts
  • Adding credentials via Groovy scripts
• Generates SSH keys and copies them to slave servers

Requirements

• Minimum Ansible version: 2.7
• Java 8 required
• Supported OS:
  • CentOS 8
  • RHEL 8
  • Amazon Linux 2
  • Ubuntu 18
  • Debian 9

Configuration Variables

Jenkins Configuration

• jenkins2_user: OS user for Jenkins (default: jenkins)
• jenkins2_package_version: Jenkins package name (default: jenkins)
• jenkins2_release_line: Version to install (default: stable)
• Other variables control settings for SMTP, plugins, directories, and more.

Security and Authorization

• Configure Jenkins security settings, including user authentication and authorization strategies.

SSH Key Generation

• Options to generate SSH key pairs under the Jenkins user.

Custom File Management

• Specify any custom files to copy to the Jenkins server.

Pipeline Libraries

• Configure Global Pipeline Libraries with relevant settings.

Example Inventory

[jenkins]
server.example.com

[jenkins_ssh_slaves]
slave1.example.com
slave2.example.com

Example Playbook

- name: Install and Configure Jenkins
  hosts: jenkins
  vars:
    jenkins2_ssh_keys_generate: true
    jenkins2_ssh_keys_slave_hosts:
      - {host: 'slave1.example.com', users: ['root', 'jenkins']}
      - {host: 'slave2.example.com', users: ['root', 'jenkins']}
  roles:
    - role: lean_delivery.java
      java_distribution: openjdk
      java_major_version: 11
      transport: repositories
    - role: lean_delivery.jenkins

License

This guide is distributed under the Apache License.

Author Contact

Lean Delivery Team - [email protected]