pro_vision.jenkins_pv_pipeline_library

This role is a utility roles to setup jenkins instances for the usage of the pro!vision jenkins-pv-pipeline-library.

This role installs all necessary plugins in specific versions which ensures that the shared pipeline library is always running with the latest compatible plugins.

Versioning

The Version number will follow the following versioning schema:

[JenkinsVersion]-[ReleaseCount]

So for example:

• 2.107.2-1 - first release for Jenkins 2.107.2
• 2.107.2-2 - second release for Jenkins 2.107.2
• 2.107.2-N - nth release for Jenkins 2.107.2
• 2.138.1-1 - first release for Jenkins 2.107.3

Requirements

This role requires Ansible 2.4 or higher and a running Jenkins on the target instance.

Role Variables

jenkins_pv_pipeline_library_jenkins_process_user: jenkins

Linux jenkins user.

jenkins_pv_pipeline_library_jenkins_process_group: "{{ jenkins_pv_pipeline_library_jenkins_process_user }}"

Linux group of jenkins user.

jenkins_pv_pipeline_library_admin_username: admin

Jenkins admin username.

jenkins_pv_pipeline_library_admin_password: admin

Jenkins admin password.

jenkins_pv_pipeline_library_jenkins_home: /var/lib/jenkins

Path to the jenkins directory.

jenkins_pv_pipeline_library_jenkins_hostname: localhost

Hostname of the jenkins instance.

jenkins_pv_pipeline_library_jenkins_port: 8080

HTTP port of the jenkins instance.

jenkins_pv_pipeline_library_jenkins_url_prefix: ""

Url prefix of the jenkins instance, e.g. when running in tomcat.

jenkins_pv_pipeline_library_jenkins_update_dir: "{{ jenkins_pv_pipeline_library_jenkins_home }}/updates"

Path to the jenkins update directory.

jenkins_pv_pipeline_library_jenkins_base_url: "http://{{ jenkins_facts_jenkins_hostname }}:{{ jenkins_facts_jenkins_port }}{{ jenkins_facts_jenkins_url_prefix }}"

The base url of the jenkins instance.

jenkins_pv_pipeline_library_updates_expiration: 86400

Maximum seconds since the last jenkins plugin update check.

jenkins_pv_pipeline_library_updates_timeout: 60

Timeout for jenkins update operation.

jenkins_pv_pipeline_library_debug: false

When set to enable the role will log some debug information.

jenkins_pv_pipeline_library_plugins_present: [...]

Plugins and their versions that must be present for jenkins-pv-pipeline-library.

💡 Since this list is long please refer to defaults

jenkins_pv_pipeline_library_plugins_absent: []

Plugins that must be absent for jenkins-pv-pipeline-library.

Dependencies

This role depends on the wcm_io_devops.jenkins_plugins role to install/uninstall the plugins needed by the jenkins-pipeline-library

As transitive dependency this role uses the wcm_io_devops.jenkins_facts role to retrieve the list of installed plugins from the Jenkins instance.

Example Playbook

Prepares the Jenkins instance for the use of the jenkins-pv-pipeline-library.

- hosts: jenkins
  roles:
    - role: pro_vision.jenkins_pv_pipeline_library

License

Apache 2.0