unixadm.jenkins

Jenkins related plugins

Repository

https://git.unixadm.org/phil/ansible-collection-jenkins

Plugins

module

jenkins_credential - This module creates or deletes a credential

Synopsis

this module creates or deletes a credential

Parameters
Parameter Choices/Defaults Description
domain
(str)		 (global) credential domain
key
(str)		 the user's ssh key
mutually exclusive with password
name
(str)
required		 the user@domain combination to retrieve the id for
passphrase
(str)		 the user's ssh key's passphrase
must be specified when key is used
password
(str)		 the user's password
mutually exclusive with key
scope
(str)		 GLOBAL
SYSTEM		 credential scope
ssh_host
(str)		 localhost jenkins ssh hostname
ssh_key
(str)		 jenkins ssh private key as string
ssh_key_file
(str)		 path to the jenkins ssh private key file
ssh_key_passphrase
(str)		 passphrase for private key decryption
ssh_pass
(str)		 jenkins ssh password
ssh_user
(str)		 jenkins jenkins ssh username
state
(str)		 present
absent		 create ("present") or remove ("absent") the given credential domain
Notes

you must provide either a password or an ssh key (file or string)

jenkins_credential_domain - This module creates or deletes a credential domain

Synopsis

this module creates or deletes a credential domain

Parameters
Parameter Choices/Defaults Description
description
(str)		 the domain's description
excludes
(str)		 something
includes
(str)		 something
name
(str)
required		 the credential domain name
ssh_host
(str)		 localhost jenkins ssh hostname
ssh_key
(str)		 jenkins ssh private key as string
ssh_key_file
(str)		 path to the jenkins ssh private key file
ssh_key_passphrase
(str)		 passphrase for private key decryption
ssh_pass
(str)		 jenkins ssh password
ssh_user
(str)		 jenkins jenkins ssh username
state
(str)		 present
absent		 create ("present") or remove ("absent") the given credential domain
Notes

you must provide either a password or an ssh key (file or string)

jenkins_credential_id - This module retrieves the credential id

Synopsis

this module retrieves the credential id for a given name (user@domain)

Parameters
Parameter Choices/Defaults Description
name
(str)
required		 the user@domain combination to retrieve the id for
ssh_host
(str)		 localhost jenkins ssh hostname
ssh_key
(str)		 jenkins ssh private key as string
ssh_key_file
(str)		 path to the jenkins ssh private key file
ssh_key_passphrase
(str)		 passphrase for private key decryption
ssh_pass
(str)		 jenkins ssh password
ssh_user
(str)		 jenkins jenkins ssh username
Notes

you must provide either a password or an ssh key (file or string)

jenkins_keypair - generates a keypair for jenkins

Synopsis

generates and returns the jenkins master keypair

Parameters
Parameter Choices/Defaults Description
path
(str)		 path to the secrets path (usually /var/lib/jenkins/secrets)

jenkins_plugin - installs a jenkins plugin

Synopsis

installs a jenkins plugin together with its dependencies

Parameters
Parameter Choices/Defaults Description
cache
(str)		 path for the updatecenter cache
jenkins_home
(str)		 jenkins home directory
name
(str)		 name of the plugin to install
state
(str)		 install (present) or uninstall (absent) plugin
timeout
(str)		 timeout for retrieving the updatecenter information and the plugin file
updates_url
(str)		 updatecenter url

filter

lookup

version - return this collection's version

Synopsis

Returns this collection's version

Examples
---
- assert:
    that: "lookup('unixadm.jenkins.version') is version_compare('0.0.1', '>=')"
Return values
Key Returned Description
_raw
(str)		 Success version string

inventory

test

Authors

  • Philippe Kueck <projects at unixadm dot org>

Licenses

GPL-2.0-only