wazuh/wazuh-ansible
1
0
Fork 0
mirror of https://github.com/wazuh/wazuh-ansible.git synced 2025-12-10 00:38:17 -06:00
Code Issues Packages Projects Releases 105 Wiki Activity
wazuh-ansible/docs/ref/introduction/description.md

2.2 KiB
Raw Blame History

Description

What is Wazuh-Ansible?

Wazuh-Ansible is an open-source project designed to simplify the deployment of Wazuh across various operating systems and architectures (Compatibility) using Ansible. It offers a comprehensive set of roles and playbooks to streamline the installation and configuration process, whether for an All-in-One (AIO) setup, a distributed configuration, or the installation and enrollment of one or multiple agents.

Key features include:

  • Automated deployment of Wazuh in AIO or distributed environments.
  • Component verification to ensure proper installation.
  • Seamless support for enrolling new agents.

How Wazuh-Ansible Works

The project is organized with playbooks located in the project root directory and roles stored in the roles directory. Each role contains specific tasks to configure Wazuh components, such as the manager, agents, or the web interface.

When a playbook is executed, Ansible uses the defined roles to perform the required tasks. This structure ensures flexibility and code reusability, making it easier to manage configurations across multiple servers.

Playbooks

The available playbooks in the project include:

  • wazuh-aio.yml: Deploys Wazuh on a single server (All-in-One).
  • wazuh-distributed.yml: Deploys Wazuh in a distributed environment.
  • wazuh-agent.yml: Configures and enrolls one or more agents into the Wazuh manager.

Roles

The roles utilized in the project, executed in sequence, are:

  • package-urls: Configures the URLs for Wazuh packages.
  • wazuh-indexer: Installs and configures the Wazuh Indexer component.
  • wazuh-manager: Installs and configures the Wazuh manager.
  • wazuh-dashboard: Installs and configures the Wazuh User Interface (WUI).

Use Cases

Wazuh-Ansible is particularly useful in scenarios such as:

  • Testing Wazuh in development setups.
  • Deploying Wazuh configurations across multiple servers.
  • Secure a fleet of agents with Wazuh by enrolling them automatically.

Advantages of Using Wazuh-Ansible

Benefits of using Wazuh-Ansible include:

  • Time-saving automation for deployment and configuration.
  • Consistency in deployments across various environments.
  • Flexibility to adapt to different infrastructure setups.