Skip to content

Commit b744ee6

Browse files
authored
Merge pull request #328 from EncoreTechnologies/feature/rhel8-support
Feature/rhel8 support
2 parents c7b6856 + 9b6d157 commit b744ee6

File tree

8 files changed

+149
-130
lines changed

8 files changed

+149
-130
lines changed

CHANGELOG.md

+14-3
Original file line numberDiff line numberDiff line change
@@ -2,11 +2,22 @@
22

33
## Development
44

5+
## 2.1.0 (Mar 6, 2021)
6+
Note: This version only supports the 'integrated' LDAP plugin.
7+
8+
- Added the RabbitMQ repo manage flag to the RabbitMQ install because it no longer exists in
9+
EPEL for CentOS/Rhel 8
10+
- Stackstorm 3.4 change the way they process LDAP and moved the pip install into
11+
the requirements file so we do not need to install the extra module. Also updated
12+
the ldap backend config to be consistent with new structure.
13+
- Stackstorm 3.4 removed resultstracker so we took that out of the services list and all tests and configs.
14+
Contributed by @bishopbm1
15+
516
## 2.0.0 (Feb 15, 2020)
617

718
- Added new parameter `st2::python_version` that controls the version of python to install.
819
This was added so that OSes that don't come with Python 3 by default, can install Python 3.
9-
The default is `'system'` and the system `python` package will be installed,
20+
The default is `'system'` and the system `python` package will be installed,
1021
whatever version that is for your OS.
1122
To explicitly install Python 3.6 on CentOS 7, pass in `'3.6'`.
1223
To install Python 3.6 on Ubuntu 16.04 pass in `'python3.6'`. On Ubuntu 16.04 you'll
@@ -64,13 +75,13 @@
6475
- Added a new plan `st2::upgrade_mongodb` that can be used to upgrade a standalone MongoDB
6576
database between versions. (Feature)
6677
Contributed by @nmaludy
67-
78+
6879
- PDK Sync to 1.18.1 (Enhancement)
6980
Contributed by @nmaludy
7081

7182
- Added support for Puppet 7 (Enhancement)
7283
Contributed by @nmaludy
73-
84+
7485
- Deprecated Puppet 5. Removed Puppet 5 from build matrix (Enhancement)
7586
Contributed by @nmaludy
7687

README.md

+47-43
Original file line numberDiff line numberDiff line change
@@ -73,7 +73,7 @@ and [librarian-puppet](http://librarian-puppet.com/).
7373
* Ubuntu 16.04 - Puppet 7 - [build/ubuntu16-puppet7/Puppetfile](build/ubuntu16-puppet7/Puppetfile)
7474
* Ubuntu 18.04 - Puppet 6 - [build/ubuntu18-puppet6/Puppetfile](build/ubuntu18-puppet6/Puppetfile)
7575
* Ubuntu 18.04 - Puppet 7 - [build/ubuntu18-puppet7/Puppetfile](build/ubuntu18-puppet7/Puppetfile)
76-
76+
7777
### Beginning with st2
7878

7979
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:
108108
value on the `st2` packages. The default is `present` resulting in the most
109109
up to date packages being installed initially. If you would like to hard code
110110
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
112112
StackStorm packages to be automatically updated without the proper upgrade steps
113113
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
115115
system `python` package will be installed, whatever version that is for your OS.
116116
To explicitly install Python 3.6 specify `'3.6'` if on RHEL/CentOS 7.
117117
If on Ubuntu 16.04 specify `'python3.6'`.
118-
**Notes**
118+
**Notes**
119119
* RHEL 7 - The Red Hat subscription repo `'rhel-7-server-optional-rpms'`
120120
will need to be enabled prior to running this module.
121121
* :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
123123
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.
126126
Alternatively the Puppet will try to add python3.6 from the 3rd party 'deadsnakes' repository: https://launchpad.net/~deadsnakes/+archive/ubuntu/ppa.
127127
Only set to true, if you are aware of the support and security risks associated
128128
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:
132132

133133
```puppet
134134
# CentOS/RHEL 7
135-
class { 'st2':
135+
class { 'st2':
136136
python_version => '3.6',
137137
}
138138
139139
# Ubuntu 16.04 (unsafe deadsnakes PPA will be enabled because of boolean flag)
140-
class { 'st2':
140+
class { 'st2':
141141
python_version => 'python3.6',
142142
python_enable_unsafe_repo => true,
143143
}
@@ -171,12 +171,12 @@ Installation/Configuration via modules:
171171
```ruby
172172
# install pack from the exchange
173173
st2::pack { 'linux': }
174-
174+
175175
# install pack from a git URL
176176
st2::pack { 'private':
177177
repo_url => 'https://private.domain.tld/git/stackstorm-private.git',
178178
}
179-
179+
180180
# install pack and apply configuration
181181
st2::pack { 'slack':
182182
config => {
@@ -216,8 +216,8 @@ The following backends are currently available:
216216

217217
* `flat_file` - Authenticates against an htpasswd file (default) [link](https://github.com/StackStorm/st2-auth-backend-flat-file)
218218
* `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)
221221
* `mongodb` - Authenticates against a collection named `users` in MongoDB [link](https://github.com/StackStorm/st2-auth-backend-mongodb)
222222
* `pam` - Authenticates against the PAM Linux service [link](https://github.com/StackStorm/st2-auth-backend-pam)
223223

@@ -249,32 +249,36 @@ the `::st2` class in a manifest file:
249249
class { 'st2':
250250
auth_backend => 'ldap',
251251
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}',
261260
},
262261
}
263262
```
264263

265264
Or in Hiera:
266265

267266
``` yaml
268-
st2::auth_backend: ldap
267+
st2::auth_backend: "ldap"
269268
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}"
278282
```
279283

280284

@@ -286,16 +290,16 @@ Configuration via Hiera:
286290
# character to trigger the bot that the message is a command
287291
# example: !help
288292
st2::chatops_hubot_alias: "'!'"
289-
293+
290294
# name of the bot in chat, sometimes requires special characters like @
291295
st2::chatops_hubot_name: '"@RosieRobot"'
292-
296+
293297
# API key generated by: st2 apikey create
294298
st2::chatops_api_key: '"xxxxyyyyy123abc"'
295-
299+
296300
# Public URL used by ChatOps to offer links to execution details via the WebUI.
297301
st2::chatops_web_url: '"stackstorm.domain.tld"'
298-
302+
299303
# install and configure hubot adapter (rocketchat, nodejs module installed by nodejs)
300304
st2::chatops_adapter:
301305
hubot-adapter:
@@ -313,7 +317,7 @@ Configuration via Hiera:
313317
ROCKETCHAT_AUTH: password
314318
RESPOND_TO_DM: true
315319
```
316-
320+
317321
### Tasks
318322

319323
This module provides several tasks for interacting with StackStorm. These tasks
@@ -426,7 +430,7 @@ $res = run_task('st2::key_get', $stackstorm_target,
426430

427431
Support for Mistral has been dropped as of StackStorm `3.3.0`.
428432

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)
430434
Neither Mistral nor Postgresql will be installed or managed by this module.
431435

432436
#### :warning: End-of-Support Notice - CentOS 6
@@ -443,7 +447,7 @@ is officially deprecated.
443447
* This module no longer tests against Puppet 5 in its build matrix.
444448
* The next major release of the module will drop support for Puppet 5 by adjusting the
445449
minimum supported Puppet version in `metadata.json`.
446-
450+
447451
#### :warning: Deprecation Notice - Puppet 4
448452

449453
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.
459463

460464
### Upgrading StackStorm
461465

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
464468
[upgrade documenation](https://docs.stackstorm.com/install/upgrades.html).
465469

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
467471
on demand using [bolt](https://github.com/puppetlabs/bolt).
468472

469473
## Development
470474

471475
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).
473477
If you are amazing, find a bug or implement a new feature and want to add it to the module,
474478
please submit a [Pull Request](https://github.com/StackStorm/puppet-st2/pulls).
475479

476480
### Maintainers
477481

478-
* Nick Maludy
482+
* Nick Maludy
479483
* GitHub - [@nmaludy](https://github.com/nmaludy)
480484
* StackStorm <[email protected]>
481485
* James Fryman

files/etc/rsyslog.d/10-st2.conf

-2
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,6 @@
33
# all logs
44
if $programname contains "st2actions" then /var/log/st2/st2actions.log
55
if $programname contains "st2notifier" then /var/log/st2/st2notifier.log
6-
if $programname contains "st2resultstracker" then /var/log/st2/st2resultstracker.log
76
if $programname contains "st2rulesengine" then /var/log/st2/st2rulesengine.log
87
if $programname contains "st2sensorcontainer" then /var/log/st2/st2sensorcontainer.log
98
if $programname contains "st2garbagecollector" then /var/log/st2/st2garbagecollector.log
@@ -13,7 +12,6 @@ if $programname contains "st2auth" then /var/log/st2/st2auth.log
1312
# audit logs
1413
if $programname contains "st2actions" and $msg contains "AUDIT" then /var/log/st2/st2actions.audit.log
1514
if $programname contains "st2notifier" and $msg contains "AUDIT" then /var/log/st2/st2notifier.audit.log
16-
if $programname contains "st2resultstracker" and $msg contains "AUDIT" then /var/log/st2/st2resultstracker.audit.log
1715
if $programname contains "st2rulesengine" and $msg contains "AUDIT" then /var/log/st2/st2rulesengine.audit.log
1816
if $programname contains "st2sensorcontainer" and $msg contains "AUDIT" then /var/log/st2/st2sensorcontainer.audit.log
1917
if $programname contains "st2garbagecollector" and $msg contains "AUDIT" then /var/log/st2/st2garbagecollector.audit.log

0 commit comments

Comments
 (0)