Development - Separate Agent/Manager - Ansible

[YisDav]

Implementation plan

Task 1 — Roles and playbooks update

Issue:

• Development - Separate Agent/Manager - Ansible - Roles and playbooks update #1937

Update wazuh-manager role for new manager layout

• Scope: roles/wazuh-manager/tasks/main.yml

Update cert-gen schema usage + distributed playbook

• Scope:
  • roles/wazuh-indexer/tasks/config_files_setup.yml
  • wazuh-distributed.yml

---

Task 2 — GitHub playbooks + GitHub Actions workflows updates (includes tests)

Issue:

• Development - Separate Agent/Manager - Ansible - GitHub playbooks and workflows updates #1938

Update GitHub diagnostics playbooks for new manager paths

• Scope: .github/playbooks/gather_central_logs.yml

Ensure agent log gathering stays unchanged

• Scope: .github/playbooks/gather_agent_logs.yml

GitHub Actions validation for AIO + distributed deployments (PR checks/workflow runs)

• Scope:
  • GitHub Actions workflows (e.g., .github/workflows/*), plus execution of:
    • wazuh-aio.yml
    • wazuh-distributed.yml
  • This issue is where the playbooks must be tested through workflow runs or PR checks.

---

Task 3 — Documentation updates

Issue:

• Development - Separate Agent/Manager - Ansible - Documentation update #1939

Remove ambiguous “server” terminology (manager context)

• Scope:
  • docs/ref/introduction/description.md
  • docs/ref/glossary.md

---

Task 4 — E2E Tests

Issue:

• Development - Separate Agent/Manager - Ansible - E2E Tests #1941

1. AIO Deployment

• Scope: wazuh-aio.yml

Steps:

1. Deploy the an AIO environment following the documentation steps
2. Ensure stack is correctly deployed and services working correctly

2. Distributed Deployment

• Scope: wazuh-distributed.yml

Steps:

1. Deploy the an Distributed environment following the documentation steps
2. Ensure stack is correctly deployed and services working correctly

3. Workflow Deployments

• Scope: wazuh-aio.yml
• Scope: .github/workflows/aio.yml
• Scope: wazuh-distributed.yml
• Scope: .github/workflows/distributed.yml

Steps:

1. Deploy AIO environment using workflow/PR-check
2. Deploy Distributed environment using workflow/PR-check
3. Ensure linting/error_gathering and other checks are passed successfully.

---

Gantt

gantt
  title Separate agent/manager - wazuh-ansible
  dateFormat  YYYY-MM-DD
  section Step 1 - Roles changes
  excludes weekends
  Roles and playbooks update #1937                         :active, task1, 2026-02-12, 12d
  GitHub playbooks and workflows updates #1938   :active, task2, after task1, 4d
  Documentation update #1939                                 :active, task3, after task2, 1d
  E2E Tests #1941                                                        :active, task4, after task3, 7d

Loading

1. Development - Separate Agent/Manager - Ansible - Roles and playbooks update #1937
2. Development - Separate Agent/Manager - Ansible - GitHub playbooks and workflows updates #1938
3. Development - Separate Agent/Manager - Ansible - Documentation update #1939
4. Development - Separate Agent/Manager - Ansible - E2E Tests #1941