ansible-wazuh-agent role from the documentation does not seem to exist

[joshmcorreia]

According to the Roles documentation, the Ansible roles can be installed by running:

# cd /etc/ansible/roles
# git clone --branch v4.14.1 https://github.com/wazuh/wazuh-ansible.git

According to the Wazuh Agent Role documentation, it can be called in a playbook like so:

- hosts: all:!wazuh-manager
  roles:
   - ansible-wazuh-agent

This is the error I'm seeing:

ERROR! the role 'ansible-wazuh-agent' was not found in ... /etc/ansible/roles ...

The error appears to be in './install_wazuh_agent_playbook.yml': line 11, column 7, but may
be elsewhere in the file depending on the exact syntax problem.

The offending line appears to be:

  roles:
    - ansible-wazuh-agent
      ^ here

Searching the source of this repo, the role ansible-wazuh-agent doesn't exist. What is the proper way to call the wazuh-agent role?

[YisDav]

@joshmcorreia
You are attempting to import the role using an incomplete path. Ensure you provide the full path for the Wazuh agent role

Refer to the latest release documentation for the directory structure at the following link: https://github.com/wazuh/wazuh-ansible/tree/v4.14.1?tab=readme-ov-file#directory-structure

For roles, the directory structure is as follows:

├── wazuh-ansible
│ ├── roles
│ │ ├── wazuh
│ │ │ ├── ansible-filebeat-oss
│ │ │ ├── ansible-wazuh-manager
│ │ │ ├── ansible-wazuh-agent
│ │ │ ├── wazuh-dashboard
│ │ │ ├── wazuh-indexer

The correct path to the role should be: wazuh-ansible/roles/wazuh/ansible-wazuh-agent

Example:

- hosts: all:!wazuh-manager
  roles:
   - wazuh-ansible/roles/wazuh/ansible-wazuh-agent

Additionally, review the role documentation to ensure you include all required parameters: https://github.com/wazuh/wazuh-ansible/blob/v4.14.1/roles/wazuh/ansible-wazuh-agent/README.md.

[joshmcorreia]

Should the documentation be updated to reflect what you posted?