pro_vision.jenkins_pv

This role helps install, update, and remove Plugins on pro!vision Jenkins instances.

It includes Plugins that are not included in:

• wcm_io_devops.jenkins_pipeline_library
• pro_vision.jenkins_pv_pipeline_library

Versioning

The version number uses this format:

[JenkinsVersion]-[ReleaseCount]

For example:

• 2.138.1-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.138.1

Requirements

This role needs Ansible version 2.4 or higher and a working Jenkins on the target system.

Role Variables

Here are the available variables and their default values:

jenkins_pv_admin_username: admin

Jenkins admin username.

jenkins_pv_admin_password: admin

Jenkins admin password.

jenkins_pv_jenkins_home: /var/lib/jenkins

Path to the Jenkins directory.

jenkins_pv_jenkins_hostname: localhost

Hostname of the Jenkins instance.

jenkins_pv_jenkins_port: 8080

HTTP port of the Jenkins instance.

jenkins_pv_jenkins_url_prefix: ""

URL prefix of the Jenkins instance, for example, when running in Tomcat.

jenkins_pv_jenkins_base_url: "http://{{ jenkins_pv_jenkins_hostname }}:{{ jenkins_pv_jenkins_port }}{{ jenkins_pv_jenkins_url_prefix }}"

The base URL of the Jenkins instance.

jenkins_pv_updates_expiration: 86400

Maximum time in seconds since the last Jenkins plugin update check.

jenkins_pv_updates_timeout: 60

Timeout for Jenkins update operations.

jenkins_pv_debug: false

When enabled, the role will log some debug information.

jenkins_pv_plugins_present: [...]

List of Plugins and their versions that need to be present on a pro!vision Jenkins instance.

:bulb: This list is long, so please check the defaults

Plugins and their versions required on pro!vision Jenkins instances.

jenkins_pv_plugins_absent: []

Plugins that should not be on pro!vision Jenkins instances.

Dependencies

This role relies on the wcm_io_devops.jenkins_plugins role to install or remove the Plugins needed by the jenkins-pipeline-library

It also uses the wcm_io_devops.jenkins_facts role to get the list of installed plugins from the Jenkins instance.

License

Apache 2.0