{"id":19672338,"url":"https://github.com/wcm-io-devops/ansible-jenkins-plugins","last_synced_at":"2025-04-29T01:30:42.525Z","repository":{"id":54737651,"uuid":"134746800","full_name":"wcm-io-devops/ansible-jenkins-plugins","owner":"wcm-io-devops","description":"Ansible role for maintaining plugins on Jenkins instances","archived":false,"fork":false,"pushed_at":"2023-09-22T10:16:55.000Z","size":39,"stargazers_count":5,"open_issues_count":0,"forks_count":12,"subscribers_count":9,"default_branch":"master","last_synced_at":"2025-04-05T12:11:27.136Z","etag":null,"topics":["ansible","ansible-role","jenkins"],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/wcm-io-devops.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2018-05-24T17:15:16.000Z","updated_at":"2024-01-09T15:24:46.000Z","dependencies_parsed_at":"2024-11-11T17:11:56.344Z","dependency_job_id":"31aef9cf-9171-4de2-afb4-a63a64a8cabc","html_url":"https://github.com/wcm-io-devops/ansible-jenkins-plugins","commit_stats":null,"previous_names":[],"tags_count":12,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wcm-io-devops%2Fansible-jenkins-plugins","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wcm-io-devops%2Fansible-jenkins-plugins/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wcm-io-devops%2Fansible-jenkins-plugins/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wcm-io-devops%2Fansible-jenkins-plugins/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/wcm-io-devops","download_url":"https://codeload.github.com/wcm-io-devops/ansible-jenkins-plugins/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":251415599,"owners_count":21585861,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ansible","ansible-role","jenkins"],"created_at":"2024-11-11T17:11:48.005Z","updated_at":"2025-04-29T01:30:42.241Z","avatar_url":"https://github.com/wcm-io-devops.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"[![CI](https://github.com/wcm-io-devops/ansible-jenkins-plugins/workflows/CI/badge.svg?branch=master\u0026event=push)](https://github.com/wcm-io-devops/ansible-jenkins-plugins/actions?query=workflow%3ACI)\n\n# wcm_io_devops.jenkins_plugins\n\nThis role manages the installation, update and uninstallation of Jenkins\nPlugins in a faster way than simply using the `jenkins_plugin`.\n\nIt uses the action plugin `jenkins_plugin_helper` supplied with this\nrole to calculate the necessary install/uninstall actions to avoid\nunnecessary timeconsuming executions of the `jenkins_plugin` module.\n\n## Requirements\n\nThis role requires Ansible 2.7 or higher and a running Jenkins on the\ntarget instance.\n\n## Role Variables\n\nAvailable variables are listed below, along with their default values:\n\n    jenkins_plugins_present: []\n    # format:\n    #  - name: [plugin-short-name]\n    #    version: \"[plugin-version]\"\n\nList of plugins that should be present/installed.\n\n:bulb: The use of quotation marks is strictly recommended! Otherwise\nversions like `2.4.0` would be converted into `2.4` which might result\nin failures.\n\n    jenkins_plugins_absent: []\n    # format:\n    #  - name: [plugin-short-name]\n\nList of plugins that should be absent/uninstalled.\n\n    jenkins_plugins_admin_username: admin\n\nJenkins admin password.\n\n    jenkins_plugins_admin_password: admin\n\nJenkins admin username.\n\n    jenkins_plugins_jenkins_home: /var/lib/jenkins\n\nPath to the jenkins directory.\n\n    jenkins_plugins_jenkins_hostname: localhost\n\nHostname of the jenkins instance.\n\n    jenkins_plugins_jenkins_port: 8080\n\nHTTP port of the jenkins instance.\n\n    jenkins_plugins_jenkins_url_prefix: \"\"\n\nUrl prefix of the jenkins instance, e.g. when running in tomcat.\n\n    jenkins_plugins_jenkins_update_dir: \"{{ jenkins_plugins_jenkins_home }}/updates\"\n\nPath to the jenkins update directory.\n\n    jenkins_plugins_jenkins_base_url: \"http://{{ jenkins_plugins_jenkins_hostname }}:{{ jenkins_plugins_jenkins_port }}{{ jenkins_plugins_jenkins_url_prefix }}\"\n\nThe base url of the jenkins instance.\n\n    jenkins_plugins_updates_expiration: 86400\n\nMaximum seconds since the last jenkins plugin update check.\n\n    jenkins_plugins_updates_timeout: 60\n\nTimeout for jenkins update operation.\n\n    jenkins_plugins_updates_base_url: https://updates.jenkins.io\n\nBase URL to jenkins update site.\n\n    jenkins_plugins_updates_update_site_url: \"{{ jenkins_plugins_updates_base_url }}/update-center.json\"\n\nComplete URL to update-center.json.\n\n    jenkins_plugins_download_base_url: \"{{ jenkins_plugins_updates_base_url }}\"\n\nDownload base URL for the jenkins plugins (you can point this to a local mirror to speed up plugin installation).\n\n    jenkins_plugins_failedplugins_check: true\n\nControls if the role will fail when plugins are in failed state after installation.\n\n    jenkins_plugins_debug: false\n\nWhen set to enable the role will log some debug information.\n\n    jenkins_plugins_proxy_username: \"\"\n\nThe username for the update center proxy.\n\n    jenkins_plugins_proxy_password: \"\"\n\nThe password for the update center proxy.\n\n    #jenkins_plugins_proxy_host: \"\"\n\nThe update center proxy host, only evaluated when jenkins_plugins_proxy_port is set.\n\n    #jenkins_plugins_proxy_port: \"\"\n\nThe update center proxy port, only evaluated when jenkins_plugins_proxy_host is set.\n\n    jenkins_plugins_proxy_no_proxy_host: \"\"\n\nThe update center proxy no proxy hosts list.\n\n    jenkins_plugins_complete_initial_setup: false\n\nControls if the initial setup of the jenkins instance should be completed.\nThis may be necessary in proxy environments where the jenkins instance still thinks it is in offline mode.\n\n    jenkins_plugins_owner: \"jenkins\"\n\nUser owning the files in the plugins folder.\n\n    jenkins_plugins_group: \"jenkins\"\n\nGroup owning the files in the plugins folder.\n\n## Dependencies\n\nThis role depends on the\n[wcm_io_devops.jenkins_facts](https://github.com/wcm-io-devops/ansible-jenkins-facts)\nrole to retrieve the list of installed plugins from the Jenkins\ninstance.\n\nIt also depends on the\n[wcm_io_devops.jenkins_service](https://github.com/wcm-io-devops/ansible-jenkins-service)\nrole to restart the Jenkins instance when plugins were installed/updated\nor uninstalled.\n\n## Example Playbook\n\nInstalls the greenballs plugin in version 1.15 on the target instance.\n\n\t- hosts: jenkins\n\t  vars:\n\t    jenkins_plugins_present:\n\t        - name: greenballs\n\t          version: \"1.15\"\n\t  roles:\n\t    - role: wcm_io_devops.jenkins_plugins\n\n## License\n\nApache 2.0\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwcm-io-devops%2Fansible-jenkins-plugins","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fwcm-io-devops%2Fansible-jenkins-plugins","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwcm-io-devops%2Fansible-jenkins-plugins/lists"}