Skip to content

Commit 06047d1

Browse files
committed
Merge branch 'stackhpc/2025.1' into cis-overcloud-non-kolla-hosts
2 parents a712732 + 4d167d2 commit 06047d1

File tree

9 files changed

+166
-31
lines changed

9 files changed

+166
-31
lines changed

doc/source/configuration/wazuh.rst

Lines changed: 27 additions & 23 deletions
Original file line numberDiff line numberDiff line change
@@ -205,8 +205,27 @@ Reinstall the role if required:
205205

206206
``kayobe control host bootstrap``
207207

208+
Secrets
209+
-------
210+
211+
Wazuh requires that secrets or passwords are set for itself and the services with which it communicates.
212+
Wazuh secrets playbook is located in ``$KAYOBE_CONFIG_PATH/ansible/deployment/wazuh-secrets.yml``.
213+
Running this playbook will generate and put pertinent security items into secrets
214+
vault file which will be placed in ``$KAYOBE_CONFIG_PATH/deployment/wazuh-secrets.yml``.
215+
If using environments it ends up in ``$KAYOBE_CONFIG_PATH/environments/<env_name>/deployment/wazuh-secrets.yml``
216+
Remember to encrypt!
217+
218+
Wazuh secrets template is located in ``$KAYOBE_CONFIG_PATH/ansible/templates/wazuh-secrets.yml.j2``.
219+
It will be used by wazuh secrets playbook to generate wazuh secrets vault file.
208220

209-
Edit the playbook and variables to your needs:
221+
222+
.. code-block:: console
223+
224+
kayobe playbook run $KAYOBE_CONFIG_PATH/ansible/deployment/wazuh-secrets.yml
225+
226+
.. note:: Use ``ansible-vault`` to view the secrets:
227+
228+
``ansible-vault view --vault-password-file ~/vault.password $KAYOBE_CONFIG_PATH/inventory/group_vars/wazuh-manager/deployment/wazuh-secrets.yml``
210229

211230
Wazuh manager configuration
212231
---------------------------
@@ -242,28 +261,6 @@ You may need to modify some of the variables, including:
242261

243262
You'll need to run ``wazuh-manager.yml`` playbook again to apply customisation.
244263

245-
Secrets
246-
-------
247-
248-
Wazuh requires that secrets or passwords are set for itself and the services with which it communiticates.
249-
Wazuh secrets playbook is located in ``$KAYOBE_CONFIG_PATH/ansible/deployment/wazuh-secrets.yml``.
250-
Running this playbook will generate and put pertinent security items into secrets
251-
vault file which will be placed in ``$KAYOBE_CONFIG_PATH/deployment/wazuh-secrets.yml``.
252-
If using environments it ends up in ``$KAYOBE_CONFIG_PATH/environments/<env_name>/deployment/wazuh-secrets.yml``
253-
Remember to encrypt!
254-
255-
Wazuh secrets template is located in ``$KAYOBE_CONFIG_PATH/ansible/templates/wazuh-secrets.yml.j2``.
256-
It will be used by wazuh secrets playbook to generate wazuh secrets vault file.
257-
258-
259-
.. code-block:: console
260-
261-
kayobe playbook run $KAYOBE_CONFIG_PATH/ansible/deployment/wazuh-secrets.yml
262-
263-
.. note:: Use ``ansible-vault`` to view the secrets:
264-
265-
``ansible-vault view --vault-password-file ~/vault.password $KAYOBE_CONFIG_PATH/inventory/group_vars/wazuh-manager/deployment/wazuh-secrets.yml``
266-
267264
Configure Wazuh Dashboard's Server Host
268265
---------------------------------------
269266

@@ -424,6 +421,13 @@ Verification
424421
The Wazuh agents should register with the Wazuh manager. This can be verified via the agents page in Wazuh Portal.
425422
Check CIS benchmark output in agent section.
426423

424+
Wazuh manager removal
425+
---------------------
426+
427+
The following playbook can be used to purge all Wazuh manager components from a host. This is particularly useful for Wazuh manager servers that are not hosted on an infra-vm.
428+
429+
``kayobe playbook run $KAYOBE_CONFIG_PATH/ansible/tools/wazuh-manager-purge.yml``
430+
427431
Additional resources
428432
--------------------
429433

doc/source/operations/ubuntu-noble.rst

Lines changed: 6 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -47,8 +47,10 @@ The following types of hosts will be covered in the future:
4747

4848
.. warning::
4949

50-
Ceph node upgrades have not yet been performed outside of a virtualised test
51-
environment. Proceed with caution.
50+
Due to `Bug 66389 <https://tracker.ceph.com/issues/66389>`__, do not upgrade
51+
Ceph hosts to Noble until the Ceph cluster has been upgraded to at least
52+
Reef v18.2.5. Upgrading a host prematurely will prevent its Ceph daemons
53+
from starting, and it will not be able to rejoin the cluster.
5254

5355
Prerequisites
5456
=============
@@ -353,6 +355,8 @@ Storage
353355
Potential issues
354356
----------------
355357

358+
- Ensure the Ceph cluster is running at least Reef v18.2.5.
359+
Upgrading hosts with an older Ceph version will cause daemons to fail.
356360
- It is recommended that you upgrade the bootstrap host last.
357361
- Before upgrading the bootstrap host, it can be beneficial to backup
358362
``/etc/ceph`` and ``/var/lib/ceph``, as sometimes the keys, config, etc.

doc/source/operations/upgrading-openstack.rst

Lines changed: 13 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -132,7 +132,7 @@ For example:
132132
enabled: "{{ seed_pulp_container_enabled | bool }}"
133133
134134
Ansible playbook subdirectories
135-
--------------------------------------
135+
-------------------------------
136136

137137
The playbooks under ``etc/kayobe/ansible`` have been subdivided into different
138138
categories to make them easier to navigate. This change may result in merge
@@ -147,6 +147,10 @@ To mitigate the impact of these changes, two scripts have been added:
147147
* ``tools/magic-symlink-fix.sh`` - Uses the previous script to attempt to fix
148148
any broken symlinks in the kayobe configuration.
149149

150+
If playbooks are referenced in different methods other than symlinks, they'll
151+
need to be manually resolved by operators. (e.g. Shell scripts running
152+
playbooks with file paths, ``import_playbook`` command in custom playbooks)
153+
150154
Known issues
151155
============
152156

@@ -370,6 +374,14 @@ You can find more information from the :ref:`beokay` documentation.
370374
For Rocky Linux 9, ``beokay create`` must be used with the ``--python python3.12``
371375
option to specify Beokay to use Python 3.12 as it is not the default.
372376

377+
Kayobe Automation
378+
~~~~~~~~~~~~~~~~~
379+
380+
For deployments using Kayobe Automation CI, the Kayobe Docker image also needs
381+
to be rebuilt with Python 3.12. In GitHub, run the ``Build Kayobe Docker
382+
Image`` workflow. In GitLab, run the ``build_kayobe_image`` pipeline. In either
383+
case, the image will automatically be rebuilt with Python 3.12.
384+
373385
Preparation
374386
===========
375387

etc/kayobe/ansible/maintenance/cis.yml

Lines changed: 6 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -30,7 +30,12 @@
3030
# This is to workaround an issue where we set the expiry to 365 days on kayobe
3131
# service accounts in a previous iteration of the CIS benchmark hardening
3232
# defaults. This should restore the defaults and can eventually be removed.
33-
ansible.builtin.command: chage -m 0 -M 99999 -W 7 -I -1 {{ item }}
33+
ansible.builtin.user:
34+
name: "{{ item }}"
35+
password_expire_min: 0
36+
password_expire_max: 99999
37+
password_expire_warn: 7
38+
expires: -1
3439
become: true
3540
changed_when: false
3641
with_items:

etc/kayobe/ansible/requirements.yml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
collections:
33
- name: stackhpc.cephadm
4-
version: 1.21.0
4+
version: 1.22.0
55
# NOTE: Pinning pulp.squeezer to 0.0.13 because 0.0.14+ depends on the
66
# pulp_glue Python library being installed.
77
- name: pulp.squeezer
Lines changed: 105 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,105 @@
1+
---
2+
# This is the playbook version of the wazuh purge tool from:
3+
# https://github.com/stackhpc/wazuh-server-purge
4+
5+
- name: Purge Wazuh Server Components
6+
hosts: wazuh-manager
7+
become: true
8+
become_user: root
9+
tasks:
10+
# Dashboard
11+
- name: Disable and stop wazuh-dashboard service
12+
ansible.builtin.systemd_service:
13+
name: wazuh-dashboard
14+
state: stopped
15+
enabled: no
16+
daemon_reload: true
17+
register: svc_result
18+
failed_when:
19+
- svc_result.failed
20+
- "'Could not find the requested service' not in svc_result.msg"
21+
22+
- name: Remove wazuh-dashboard and files
23+
ansible.builtin.package:
24+
name: wazuh-dashboard
25+
state: absent
26+
27+
- name: Remove wazuh-dashboard directories
28+
ansible.builtin.file:
29+
path: "{{ item }}"
30+
state: absent
31+
loop:
32+
- /var/lib/wazuh-dashboard
33+
- /usr/share/wazuh-dashboard
34+
- /etc/wazuh-dashboard
35+
# Manager
36+
- name: Remove wazuh-manager service
37+
ansible.builtin.systemd_service:
38+
name: wazuh-manager
39+
state: stopped
40+
enabled: no
41+
daemon_reload: true
42+
register: svc_result
43+
failed_when:
44+
- svc_result.failed
45+
- "'Could not find the requested service' not in svc_result.msg"
46+
47+
- name: Remove wazuh-manager and files
48+
ansible.builtin.package:
49+
name: wazuh-manager
50+
state: absent
51+
52+
- name: Remove wazuh-manager directories
53+
ansible.builtin.file:
54+
path: /var/ossec
55+
state: absent
56+
# Filebeat
57+
- name: Disable and stop filebeat service
58+
ansible.builtin.systemd_service:
59+
name: filebeat
60+
state: stopped
61+
enabled: no
62+
daemon_reload: true
63+
register: svc_result
64+
failed_when:
65+
- svc_result.failed
66+
- "'Could not find the requested service' not in svc_result.msg"
67+
68+
- name: Remove filebeat and files
69+
ansible.builtin.package:
70+
name: filebeat
71+
state: absent
72+
73+
- name: Remove filebeat directories
74+
ansible.builtin.file:
75+
path: "{{ item }}"
76+
state: absent
77+
loop:
78+
- /var/lib/filebeat
79+
- /usr/share/filebeat
80+
- /etc/filebeat
81+
# Indexer
82+
- name: Disable and stop wazuh-indexer service
83+
ansible.builtin.systemd_service:
84+
name: wazuh-indexer
85+
state: stopped
86+
enabled: no
87+
daemon_reload: true
88+
register: svc_result
89+
failed_when:
90+
- svc_result.failed
91+
- "'Could not find the requested service' not in svc_result.msg"
92+
93+
- name: Remove wazuh-indexer and files
94+
ansible.builtin.package:
95+
name: wazuh-indexer
96+
state: absent
97+
98+
- name: Remove wazuh-indexer directories
99+
ansible.builtin.file:
100+
path: "{{ item }}"
101+
state: absent
102+
loop:
103+
- /var/lib/wazuh-indexer
104+
- /usr/share/wazuh-indexer
105+
- /etc/wazuh-indexer

etc/kayobe/stackhpc.yml

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -156,11 +156,11 @@ stackhpc_repo_elrepo_9_version: "{{ stackhpc_repo_distribution }}"
156156

157157
# Kolla source repository.
158158
stackhpc_kolla_source_url: "https://github.com/stackhpc/kolla"
159-
stackhpc_kolla_source_version: stackhpc/20.2.0.4
159+
stackhpc_kolla_source_version: stackhpc/20.3.0.1
160160

161161
# Kolla Ansible source repository.
162162
stackhpc_kolla_ansible_source_url: "https://github.com/stackhpc/kolla-ansible"
163-
stackhpc_kolla_ansible_source_version: stackhpc/20.2.0.9
163+
stackhpc_kolla_ansible_source_version: stackhpc/20.3.0.2
164164

165165
###############################################################################
166166
# Container image registry
Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,5 @@
1+
---
2+
features:
3+
- |
4+
Updates the ``stackhpc.cephadm`` Ansible collection to version ``1.22.0``,
5+
pulling in Tentacle support and recent fixes.

requirements.txt

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
kayobe@git+https://github.com/stackhpc/kayobe@stackhpc/18.3.0.1
1+
kayobe@git+https://github.com/stackhpc/kayobe@stackhpc/18.3.0.2
22
ansible-modules-hashivault>=5.3.0
33
pulp-glue<0.32,>=0.29.2
44
jmespath

0 commit comments

Comments
 (0)