@@ -73,7 +73,7 @@ and [librarian-puppet](http://librarian-puppet.com/).
73
73
* Ubuntu 16.04 - Puppet 7 - [ build/ubuntu16-puppet7/Puppetfile] ( build/ubuntu16-puppet7/Puppetfile )
74
74
* Ubuntu 18.04 - Puppet 6 - [ build/ubuntu18-puppet6/Puppetfile] ( build/ubuntu18-puppet6/Puppetfile )
75
75
* Ubuntu 18.04 - Puppet 7 - [ build/ubuntu18-puppet7/Puppetfile] ( build/ubuntu18-puppet7/Puppetfile )
76
-
76
+
77
77
### Beginning with st2
78
78
79
79
For a full installation on a single node, a profile already exists to
@@ -108,21 +108,21 @@ Hiera data bindings. A few notable parameters to take note of:
108
108
value on the ` st2 ` packages. The default is ` present ` resulting in the most
109
109
up to date packages being installed initially. If you would like to hard code
110
110
to an older version you can specify that here (ex: ` 2.6.0 ` ).
111
- ** Note** Setting this to ` latest ` is NOT recommended. It will cause the
111
+ ** Note** Setting this to ` latest ` is NOT recommended. It will cause the
112
112
StackStorm packages to be automatically updated without the proper upgrade steps
113
113
being taken (proper steps detailed here: https://docs.stackstorm.com/install/upgrades.html )
114
- * ` st2::python_version ` - Version to Python to use. The default is ` 'system' ` and the
114
+ * ` st2::python_version ` - Version to Python to use. The default is ` 'system' ` and the
115
115
system ` python ` package will be installed, whatever version that is for your OS.
116
116
To explicitly install Python 3.6 specify ` '3.6' ` if on RHEL/CentOS 7.
117
117
If on Ubuntu 16.04 specify ` 'python3.6' ` .
118
- ** Notes**
118
+ ** Notes**
119
119
* RHEL 7 - The Red Hat subscription repo ` 'rhel-7-server-optional-rpms' `
120
120
will need to be enabled prior to running this module.
121
121
* :warning : Ubuntu 16.04 -
122
- The python3.6 package is a required dependency for the StackStorm ` st2 ` package
122
+ The python3.6 package is a required dependency for the StackStorm ` st2 ` package
123
123
but that is not installable from any of the default Ubuntu 16.04 repositories.
124
- We recommend switching to Ubuntu 18.04 LTS (Bionic) as a base OS. Support for
125
- Ubuntu 16.04 will be removed with future StackStorm versions.
124
+ We recommend switching to Ubuntu 18.04 LTS (Bionic) as a base OS. Support for
125
+ Ubuntu 16.04 will be removed with future StackStorm versions.
126
126
Alternatively the Puppet will try to add python3.6 from the 3rd party 'deadsnakes' repository: https://launchpad.net/~deadsnakes/+archive/ubuntu/ppa .
127
127
Only set to true, if you are aware of the support and security risks associated
128
128
with using unofficial 3rd party PPA repository, and you understand that StackStorm
@@ -132,12 +132,12 @@ Hiera data bindings. A few notable parameters to take note of:
132
132
133
133
``` puppet
134
134
# CentOS/RHEL 7
135
- class { 'st2':
135
+ class { 'st2':
136
136
python_version => '3.6',
137
137
}
138
138
139
139
# Ubuntu 16.04 (unsafe deadsnakes PPA will be enabled because of boolean flag)
140
- class { 'st2':
140
+ class { 'st2':
141
141
python_version => 'python3.6',
142
142
python_enable_unsafe_repo => true,
143
143
}
@@ -171,12 +171,12 @@ Installation/Configuration via modules:
171
171
``` ruby
172
172
# install pack from the exchange
173
173
st2::pack { ' linux' : }
174
-
174
+
175
175
# install pack from a git URL
176
176
st2::pack { ' private' :
177
177
repo_url => ' https://private.domain.tld/git/stackstorm-private.git' ,
178
178
}
179
-
179
+
180
180
# install pack and apply configuration
181
181
st2::pack { ' slack' :
182
182
config => {
@@ -216,8 +216,8 @@ The following backends are currently available:
216
216
217
217
* `flat_file` - Authenticates against an htpasswd file (default) [link](https://github.com/StackStorm/st2-auth-backend-flat-file)
218
218
* `keystone` - Authenticates against an OpenStack Keystone service [link](https://github.com/StackStorm/st2-auth-backend-keystone)
219
- * `ldap` - Authenticates against an LDAP server such as OpenLDAP or Active Directory
220
- [link](https://github. com/StackStorm/st2-auth-backend- ldap)
219
+ * `ldap` - Authenticates against an LDAP server such as OpenLDAP or Active Directory
220
+ [link](https://docs.stackstorm. com/authentication.html# ldap)
221
221
* `mongodb` - Authenticates against a collection named `users` in MongoDB [link](https://github.com/StackStorm/st2-auth-backend-mongodb)
222
222
* `pam` - Authenticates against the PAM Linux service [link](https://github.com/StackStorm/st2-auth-backend-pam)
223
223
@@ -249,32 +249,36 @@ the `::st2` class in a manifest file:
249
249
class { 'st2':
250
250
auth_backend => 'ldap',
251
251
auth_backend_config => {
252
- ldap_uri => 'ldaps://ldap.domain.tld',
253
- bind_dn => 'cn=ldap_stackstorm,ou=service accounts,dc=domain,dc=tld',
254
- bind_pw => 'some_password',
255
- ref_hop_limit => 100,
256
- user => {
257
- base_dn => 'ou=domain_users,dc=domain,dc=tld',
258
- search_filter => '(&(objectClass=user)(sAMAccountName={username})(memberOf=cn=stackstorm_users,ou=groups,dc=domain,dc=tld))',
259
- scope => 'subtree'
260
- },
252
+ host => 'ldap.domain.tld',
253
+ bind_dn => 'cn=ldap_stackstorm,ou=service accounts,dc=domain,dc=tld',
254
+ base_dn => 'dc=domain,dc=tld',
255
+ scope => 'subtree',
256
+ id_attr => 'username',
257
+ bind_pw => 'some_password',
258
+ group_dns => ['"cn=stackstorm_users,ou=groups,dc=domain,dc=tld"'],
259
+ account_pattern => 'userPrincipalName={username}',
261
260
},
262
261
}
263
262
` ` `
264
263
265
264
Or in Hiera :
266
265
267
266
` ` ` yaml
268
- st2::auth_backend: ldap
267
+ st2::auth_backend: " ldap"
269
268
st2::auth_backend_config:
270
- ldap_uri: "ldaps://ldap.domain.tld"
271
- bind_dn: "cn=ldap_stackstorm,ou=service accounts,dc=domain,dc=tld"
272
- bind_pw: "some_password"
273
- ref_hop_limit: 100
274
- user:
275
- base_dn: "ou=domain_users,dc=domain,dc=tld"
276
- search_filter: "(&(objectClass=user)(sAMAccountName={username})(memberOf=cn=stackstorm_users,ou=groups,dc=domain,dc=tld))"
277
- scope: "subtree"
269
+ host: "ldaps.domain.tld"
270
+ use_tls: false
271
+ use_ssl: true
272
+ port: 636
273
+ bind_dn: 'cn=ldap_stackstorm,ou=service accounts,dc=domain,dc=tld'
274
+ bind_pw: 'some_password'
275
+ chase_referrals: false
276
+ base_dn: 'dc=domain,dc=tld'
277
+ group_dns:
278
+ - '"cn=stackstorm_users,ou=groups,dc=domain,dc=tld"'
279
+ scope: "subtree"
280
+ id_attr: "username"
281
+ account_pattern: "userPrincipalName={username}"
278
282
` ` `
279
283
280
284
@@ -286,16 +290,16 @@ Configuration via Hiera:
286
290
# character to trigger the bot that the message is a command
287
291
# example: !help
288
292
st2::chatops_hubot_alias: "'!'"
289
-
293
+
290
294
# name of the bot in chat, sometimes requires special characters like @
291
295
st2::chatops_hubot_name: '"@RosieRobot"'
292
-
296
+
293
297
# API key generated by: st2 apikey create
294
298
st2::chatops_api_key: '"xxxxyyyyy123abc"'
295
-
299
+
296
300
# Public URL used by ChatOps to offer links to execution details via the WebUI.
297
301
st2::chatops_web_url: '"stackstorm.domain.tld"'
298
-
302
+
299
303
# install and configure hubot adapter (rocketchat, nodejs module installed by nodejs)
300
304
st2::chatops_adapter:
301
305
hubot-adapter:
@@ -313,7 +317,7 @@ Configuration via Hiera:
313
317
ROCKETCHAT_AUTH: password
314
318
RESPOND_TO_DM: true
315
319
` ` `
316
-
320
+
317
321
# ## Tasks
318
322
319
323
This module provides several tasks for interacting with StackStorm. These tasks
@@ -426,7 +430,7 @@ $res = run_task('st2::key_get', $stackstorm_target,
426
430
427
431
Support for Mistral has been dropped as of StackStorm `3.3.0`.
428
432
429
- As of version `1.8` this module no longer supports Mistral (and subsequently PostgreSQL)
433
+ As of version `1.8` this module no longer supports Mistral (and subsequently PostgreSQL)
430
434
Neither Mistral nor Postgresql will be installed or managed by this module.
431
435
432
436
# ### :warning: End-of-Support Notice - CentOS 6
@@ -443,7 +447,7 @@ is officially deprecated.
443
447
* This module no longer tests against Puppet 5 in its build matrix.
444
448
* The next major release of the module will drop support for Puppet 5 by adjusting the
445
449
minimum supported Puppet version in `metadata.json`.
446
-
450
+
447
451
# ### :warning: Deprecation Notice - Puppet 4
448
452
449
453
Puppet 4 reached End of Life on 2018-12-31. As of version `1.4` use of Puppet 4 with this module
@@ -459,23 +463,23 @@ is officially deprecated.
459
463
460
464
# ## Upgrading StackStorm
461
465
462
- By default this module does NOT handle upgrades of StackStorm. It is the
463
- responsiblity of the end user to upgrade StackStorm according to the
466
+ By default this module does NOT handle upgrades of StackStorm. It is the
467
+ responsiblity of the end user to upgrade StackStorm according to the
464
468
[upgrade documenation](https://docs.stackstorm.com/install/upgrades.html).
465
469
466
- In a future release a Puppet task may be included to perform these update
470
+ In a future release a Puppet task may be included to perform these update
467
471
on demand using [bolt](https://github.com/puppetlabs/bolt).
468
472
469
473
# # Development
470
474
471
475
Contributions to this module are more than welcome! If you have a problem with the module or
472
- would like to see a new feature, please raise an [issue](https://github.com/StackStorm/puppet-st2/issues).
476
+ would like to see a new feature, please raise an [issue](https://github.com/StackStorm/puppet-st2/issues).
473
477
If you are amazing, find a bug or implement a new feature and want to add it to the module,
474
478
please submit a [Pull Request](https://github.com/StackStorm/puppet-st2/pulls).
475
479
476
480
# ## Maintainers
477
481
478
- * Nick Maludy
482
+ * Nick Maludy
479
483
* GitHub - [@nmaludy](https://github.com/nmaludy)
480
484
481
485
* James Fryman
0 commit comments