Ansible Role: Jenkins (Ludus)

An Ansible Role that installs Jenkins via Docker on Debian/Ubuntu hosts and optionally configures an admin user and plugins.

Warning

The default admin credentials are admin:admin. Change ludus_jenkins_admin_password for any non-ephemeral environment.

Requirements

None. Docker is installed automatically via the geerlingguy.docker dependency.

Role Variables

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

# Port Jenkins will listen on (mapped to host)
ludus_jenkins_http_port: 8080

# Jenkins agent port (mapped to host)
ludus_jenkins_agent_port: 50000

# Jenkins Docker image and tag
ludus_jenkins_docker_image: jenkins/jenkins
ludus_jenkins_docker_tag: lts-jdk21

# Jenkins container name
ludus_jenkins_container_name: jenkins

# Docker network name for Jenkins
ludus_jenkins_docker_network: jenkins

# Jenkins data volume name
ludus_jenkins_data_volume: jenkins-data

# Whether to skip the initial setup wizard
ludus_jenkins_skip_setup_wizard: true

# List of Jenkins plugins to install
ludus_jenkins_plugins:
  - git
  - workflow-aggregator
  - configuration-as-code

# Jenkins admin credentials (used when setup wizard is skipped)
ludus_jenkins_admin_user: admin
ludus_jenkins_admin_password: admin

# Additional Java arguments for Jenkins
ludus_jenkins_java_args: ""

# Jenkins home directory inside the container
ludus_jenkins_home: /var/jenkins_home

Dependencies

• geerlingguy.docker
• community.docker collection

Example Playbook

- hosts: jenkins_hosts
  roles:
    - Whispergate.ludus_jenkins_role
  vars:
    ludus_jenkins_http_port: 8080
    ludus_jenkins_admin_password: "changeme"

Example Ludus Range Config

ludus:
  - vm_name: "{{ range_id }}-jenkins"
    hostname: "{{ range_id }}-jenkins"
    template: debian-12-x64-server-template
    vlan: 10
    ip_last_octet: 20
    ram_gb: 4
    cpus: 2
    roles:
      - Whispergate.ludus_jenkins_role
    role_vars:
      ludus_jenkins_admin_password: "changeme"
      ludus_jenkins_plugins:
        - git
        - workflow-aggregator
        - configuration-as-code
        - pipeline-stage-view

License

MIT

Author Information

This role was created by Whispergate, for Ludus.