Home > docs > plugins v1 > Puppet Task
The puppet
task allows users to interact with various
Puppet Enterprise API endpoints.
To be able to use the task in a Concord flow, it must be added as a dependency:
configuration:
dependencies:
- mvn://com.walmartlabs.concord.plugins:puppet-task:2.5.0
This adds the task to the classpath and allows you to invoke the task in a flow:
flows:
default:
- task: puppet
in:
action: "createApiToken"
rbacUrl: 'https://peconsole.example.com:4433'
username: 'my-user'
password: 'my-pass'
lifetime: '1y'
label: 'one year token'
description: 'Created by Puppet Task for Concord'
- task: puppet
in:
action: "pql"
databaseUrl: 'https://puppetdb.example.com:8081'
apiToken: 'puppet-api-token'
queryString: "inventory{ limit 10 }"
Common Parameters
action
: Action to perform
createApiToken
: Create an API tokenpql
: Execute a Puppet Query Language querycertificate
: Certificate for validating SSL connections with self-signed
certificates
path
: Path to Base64-encoded certificate filesecret
: Single-value file Concord secret holding Base64-encoded certificate
file
org
: Concord organization where the secret is savedname
: Name of the secretpassword
: Optional password for the secrettext
: Base64 encoded certificate stringconnectTimeout
: Network connect timeout in seconds, default value is 30
debug
: If true
, enables additional debug outputignoreErrors
: If true
, exceptions are suppressed. ${result.ok}
is set to
false
when exceptions are encountered. ${result.error}
contains the
exception messagepuppetParams
: Map to hold default values for any other parameters for
the Puppet TaskreadTimeout
: Network read timeout ins seconds, default value is 30
validateCerts
: If true
, ignored certificate verification on HTTPS URLswriteTimeout
: Network write timeout in seconds, default value is 30
createApiToken
Action Parameters
password
: Password for authenticationrbacUrl
: URL for RBAC API queriestokenDescription
: Token descriptiontokenLabel
: Token labeltokenLife
: Token lifetime. Number followed by y (years), d (days), h (hours),
m (minutes), or s (seconds)username
: Username for authenticationpql
Action Parameters
apiToken
: API token for authenticationdatabaseUrl
: URL for executing database API queriesqueryString
: PQL statement to executeThe results of the task are saved into the result
variable.
flows:
default:
- task: puppet
in:
...
- if: ${result.ok}
then:
- log: "Puppet query result: ${result.data}"
else:
- log: "Error with task: ${result.error}"
Note that API tokens can only be created with the RBAC API which is part of Puppet Enterprise
Concord can generate API tokens for use to authenticate with other Puppet API endpoints.
flows:
default:
- task: puppet
in:
action: "createApiToken"
rbacUrl: 'https://peconsole.example.com:4433'
username: 'my-user'
password: 'my-pass'
tokenLife: '1y'
label: 'One year token'
description: 'created by Puppet Task for Concord'
Concord can execute PQL queries.
flows:
default:
- task: puppet
in:
action: "pql"
databaseUrl: 'https://puppetdb.example.com:8081'
apiToken: 'my-api-token'
queryString: 'inventory[certname]{ limit 5 }'
The value of result.data
of the example query above is a list of objects
[
{
"certname": "host01.example.com"
},
{
"certname": "host02.example.com"
},
{
"certname": "host03.example.com"
},
{
"certname": "host04.example.com"
},
{
"certname": "host05.example.com"
}
]
You can filter the objects down to a more simple list of strings with an expression.
- expr: "${result.data.stream().map(x -> x.get('certname')).toList()}"
out: namesOnly
The value of namesOnly
is a list of strings:
[
"host01.example.com",
"host02.example.com",
"host03.example.com",
"host04.example.com",
"host05.example.com"
]
API endpoints which use self-signed certificates for SSL connections require a public certificate to be provided to the Puppet Task. Use one of three ways to provide the cert to the task. Alternatively, ignore certificate verification altogether.
# Get the public cert from Puppet Master of Masters
curl -k https://mom.example.com:8140/puppet-ca/v1/certificate/ca
# output
-----BEGIN CERTIFICATE-----
MIICsDCCAZgCCQDw4hBBzMyVRzANBgkqhkiG9w0BAQsFADAaMRgwFgYDVQQDDA93
d3cuZXhhbXBsZS5jb20wHhcNMTkwNTIxMTMxMjQ3WhcNMjkwNTE4MTMxMjQ3WjAa
MRgwFgYDVQQDDA93d3cuZXhhbXBsZS5jb20wggEiMA0GCSqGSIb3DQEBAQUAA4IB
DwAwggEKAoIBAQC9Ll8J5ravkkCIw0szg3LPH7crfHdnJ0QHPHJUCuu3+7YPfXAA
PLu59bEasI/Hfa6LiW1YTYVrhnuA82OFLmuNqhmgHIvUDNJH5Xu/scn9r7srN67Q
x0duM0XkHi5FFbYh8lgvEUXOjfFVWkNUVmQvhd6AWHjyrw1d1GEAfMS4NhBQLfov
asP3AHEHZt8JZAs5VeG3wtcwRkAiild2OTEqVtP4lhgedfR2C10lj43b7LtxnY6k
Z2h1yedFsmKsZ+tsrP2I350qf9BDmpt5rrV3qblx6MXaHTdoV1xl5bKXqWzDcXXX
cBhy0wEKIQNNX+qPtGo461oWDDbWddajPfcFAgMBAAEwDQYJKoZIhvcNAQELBQAD
ggEBAGdy6scvRQOWvSJ1gcKgIXrhgd6RbGq7ccyZusOYOvg2pKxPKDiTpaRx9zr4
HDyryfXQmQsmcahuGcO3EroQh+KPCHrMOZgUTrZEGNct6na/eCHm5rJB1uY7dkyt
a/lSBtgE/jjmsRS4vSN6DXPFmkpFGsY4gUu0v/66NaWWY+Ak6NzvXoEys4eKJ4k6
aC1fpp7rBer1wSgzFxkmnS+aPl9Yic46BLk1mPMSEn3BabnYzDjC/Q/+CTNINoR2
r2xDuuKuhiCgxevHQ48w+QoxMNgtdfaWLD+A9uV3Ds+hN2eJCh/sVzisjechX89s
xZHfg5zRgZavH0uRF/FEkjnXD1I=
-----END CERTIFICATE-----
Provide the Base64-encoded certificate text as a parameter for the task.
- task: puppet
in:
certificate:
text: |
-----BEGIN CERTIFICATE-----
MIICsDCCAZgCCQDw4hBBzMyVRzANBgkqhkiG9w0BAQsFADAaMRgwFgYDVQQDDA93
d3cuZXhhbXBsZS5jb20wHhcNMTkwNTIxMTMxMjQ3WhcNMjkwNTE4MTMxMjQ3WjAa
MRgwFgYDVQQDDA93d3cuZXhhbXBsZS5jb20wggEiMA0GCSqGSIb3DQEBAQUAA4IB
DwAwggEKAoIBAQC9Ll8J5ravkkCIw0szg3LPH7crfHdnJ0QHPHJUCuu3+7YPfXAA
PLu59bEasI/Hfa6LiW1YTYVrhnuA82OFLmuNqhmgHIvUDNJH5Xu/scn9r7srN67Q
x0duM0XkHi5FFbYh8lgvEUXOjfFVWkNUVmQvhd6AWHjyrw1d1GEAfMS4NhBQLfov
asP3AHEHZt8JZAs5VeG3wtcwRkAiild2OTEqVtP4lhgedfR2C10lj43b7LtxnY6k
Z2h1yedFsmKsZ+tsrP2I350qf9BDmpt5rrV3qblx6MXaHTdoV1xl5bKXqWzDcXXX
cBhy0wEKIQNNX+qPtGo461oWDDbWddajPfcFAgMBAAEwDQYJKoZIhvcNAQELBQAD
ggEBAGdy6scvRQOWvSJ1gcKgIXrhgd6RbGq7ccyZusOYOvg2pKxPKDiTpaRx9zr4
HDyryfXQmQsmcahuGcO3EroQh+KPCHrMOZgUTrZEGNct6na/eCHm5rJB1uY7dkyt
a/lSBtgE/jjmsRS4vSN6DXPFmkpFGsY4gUu0v/66NaWWY+Ak6NzvXoEys4eKJ4k6
aC1fpp7rBer1wSgzFxkmnS+aPl9Yic46BLk1mPMSEn3BabnYzDjC/Q/+CTNINoR2
r2xDuuKuhiCgxevHQ48w+QoxMNgtdfaWLD+A9uV3Ds+hN2eJCh/sVzisjechX89s
xZHfg5zRgZavH0uRF/FEkjnXD1I=
-----END CERTIFICATE-----
...
Provide the certificate file in the project’s repository or in the payload to start the process.
- task: puppet
in:
certificate:
path: path/to/cert
...
Create a Concord secret with the certificate in a Base64-encoded format file.
# Provide the cert from a Concord secret (single value, file)
- task: puppet
in:
certificate:
secret:
org: my-org
name: my-secret
password: secret-pass # or null, if no password
...
Set the validateCerts
parameter to false
to disabling certificate validation
- task: puppet
in:
validateCerts: false
...