Ansible Role: Jenkins CI

Installs Jenkins CI on RHEL/CentOS and Debian/Ubuntu servers.

Requirements

Requires curl to be installed on the server.

Role Variables

Available variables are listed below, along with default values (see defaults/main.yml):

jenkins_hostname: localhost

The system hostname; usually localhost works fine. This will be used during setup to communicate with the running Jenkins instance via HTTP requests.

jenkins_http_port: 8080

The HTTP port for Jenkins' web interface.

jenkins_jar_location: /opt/jenkins-cli.jar

The location at which the jenkins-cli.jar jarfile will be kept. This is used for communicating with Jenkins via the CLI.

jenkins_plugins: []

Jenkins plugins to be installed automatically during provisioning. (Note: This feature is currently undergoing some changes due to the jenkins-cli authentication changes in Jenkins 2.0, and may not work as expected.)

jenkins_url_prefix: ""

Used for setting a URL prefix for your Jenkins installation. The option is added as --prefix={{ jenkins_url_prefix }} to the Jenkins initialization java invocation, so you can access the installation at a path like http://www.example.com{{ jenkins_url_prefix }}. Make sure you start the prefix with a / (e.g. /jenkins).

jenkins_connection_delay: 5
jenkins_connection_retries: 60

Amount of time and number of times to wait when connecting to Jenkins after initial startup, to verify that Jenkins is running. Total time to wait = delay * retries, so by default this role will wait up to 300 seconds before timing out.

# For RedHat/CentOS (role default):
jenkins_repo_url: http://pkg.jenkins-ci.org/redhat/jenkins.repo
jenkins_repo_key_url: http://pkg.jenkins-ci.org/redhat/jenkins-ci.org.key
# For Debian (role default):
jenkins_repo_url: deb http://pkg.jenkins-ci.org/debian binary/
jenkins_repo_key_url: http://pkg.jenkins-ci.org/debian/jenkins-ci.org.key

This role will install the latest version of Jenkins by default (using the official repositories as listed above). You can override these variables (use the correct set for your platform) to install the current LTS version instead:

# For RedHat/CentOS LTS:
jenkins_repo_url: http://pkg.jenkins-ci.org/redhat-stable/jenkins.repo
jenkins_repo_key_url: http://pkg.jenkins-ci.org/redhat-stable/jenkins-ci.org.key
# For Debian/Ubuntu LTS:
jenkins_repo_url: deb http://pkg.jenkins-ci.org/debian-stable binary/
jenkins_repo_key_url: http://pkg.jenkins-ci.org/debian-stable/jenkins-ci.org.key

Dependencies

• williamyeh.java (Java version 8)

Example Playbook

- hosts: ci-server
  vars:
    jenkins_hostname: jenkins.example.com
  roles:
    - repleo.jenkins

Example playbook for running Jenkins on port 80 with reverse proxy (it is not allowed to run jenkins on port <1024)

- name: Deploy jenkins
  hosts: jenkins
  vars:
    - jenkins_hostname: jenkins
  user: root
  roles:
     - { role: repleo.nginx,
               create_nginx_conf: false,
               nginx_sites: [{
                  file_name: jenkins,
                  listen: 80,
                  server_name: localhost,
                  locations: [{
                      name: /,
                      lines: [
                        "proxy_pass http://127.0.0.1:8080",
                        "proxy_redirect off",
                        "proxy_set_header Host $host",
                        "proxy_set_header X-Real-IP $remote_addr",
                        "proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for"
                      ]
                    }]
                }
               ]
       }    
     - { role: repleo.jenkins }

License

MIT (Expat) / BSD

Author Information

Thir role is adapted for Oracle Java by Jeroen Arnoldus, Repleo

This role was created in 2014 by Jeff Geerling, author of Ansible for DevOps.