From cff1113691bb005250b8ae4610bea518d2e5045c Mon Sep 17 00:00:00 2001 From: Andrew Stangl Date: Tue, 28 Jul 2015 07:37:58 +0200 Subject: [PATCH] add section for UUID to docs, as per suggestion from @jhoblitt --- README.md | 18 ++++++++++++++++++ 1 file changed, 18 insertions(+) diff --git a/README.md b/README.md index 9f1a7effa..091c1a5e6 100644 --- a/README.md +++ b/README.md @@ -301,6 +301,24 @@ private key: } ``` +*_Setting a UUID:_* + +You can also specify a UUID to use with the credentials, which will be used to +identify the credentials from within the job config. This is necessary when setting +credentials for use with the [git plugin](http://docs.openstack.org/infra/jenkins-job-builder/scm.html#scm.git), for example. + +You can either manually generate a UUID from a site like https://www.uuidgenerator.net, +or use the UUID from an existing user, which is accessible within the URL of the +Jenkins console when managing an existing user's credentials. + +```puppet + jenkins::credentials { 'deploy-user': + password => '', + private_key_or_path => hiera('::deploy_key'), + uuid => hiera('::deploy_credentials_uuid'), + } +``` + ### Configuring Security The Jenkins security model can be set to one of two modes: