Add build and deploy doc

This commit is contained in:
vcerenu
2025-05-14 14:04:44 -03:00
parent ce480d5c75
commit 3a69f6aabc
9 changed files with 123 additions and 7 deletions

View File

@@ -17,13 +17,14 @@
- [Compatibility](ref/Introduction/compatibility.md)
- [Getting Started](ref/getting-started/README.md)
- [Requirements](ref/getting-started/requirements.md)
- [Installation](ref/getting-started/installation.md)
- [Deployment](ref/getting-started/deployment/README.md)
- [Single Node Wazuh Stack](ref/getting-started/deployment/single-node.md)
- [Multi Node Wazuh Stack](ref/getting-started/deployment/multi-node.md)
- [Wazuh Agent](ref/getting-started/deployment/wazuh-agent.md)
- [Configuration](ref/configuration/README.md)
- [CEnvironment Variabless](ref/configuration/environment-variables.md)
- [Configuration files](ref/configuration/configuration-files.md)
- [Upgrade](ref/upgrade.md)
- [Uninstall](ref/uninstall.md)
- [Back Up and Restore](ref/backup-restore.md)
- [Security](ref/security.md)
- [Performance](ref/performance.md)
- [Glossary](ref/glossary.md)

View File

@@ -1 +1,32 @@
# Build Image
# Wazuh Docker Image Builder
The creation of the images for the Wazuh stack deployment in Docker is done with the build-images.yml script
To execute the process, the following must be executed in the root of the wazuh-docker repository:
```
$ build-docker-images/build-images.sh
```
This script initializes the environment variables needed to build each of the images.
The script allows you to build images from other versions of Wazuh, to do this you must use the -v or --version argument:
```
$ build-docker-images/build-images.sh -v 4.12.2
```
To get all the available script options use the -h or --help option:
```
$ build-docker-images/build-images.sh -h
Usage: build-docker-images/build-images.sh [OPTIONS]
-d, --dev <ref> [Optional] Set the development stage you want to build, example rc1 or beta1, not used by default.
-f, --filebeat-module <ref> [Optional] Set Filebeat module version. By default 0.4.
-r, --revision <rev> [Optional] Package revision. By default 1
-v, --version <ver> [Optional] Set the Wazuh version should be builded. By default, 4.12.2.
-h, --help Show this help.
```

View File

@@ -0,0 +1,32 @@
# Wazuh Docker deployment
## Deploy Wazuh Docker in multi node configuration
This deployment is defined in the `multi-node/docker-compose.yml` file with two Wazuh manager containers, three Wazuh indexer containers, and one Wazuh dashboard container. It can be deployed by following these steps:
1) Enter the multi-node directory of the repository:
```
$ cd multi-node
```
2) Increase max_map_count on your host (Linux). This command must be run with root permissions:
```
$ sysctl -w vm.max_map_count=262144
```
3) Run the certificate creation script:
```
$ docker-compose -f generate-indexer-certs.yml run --rm generator
```
4) Start the environment with docker-compose:
- In the foregroud:
```
$ docker-compose up
```
- In the background:
```
$ docker-compose up -d
```
The environment takes about 1 minute to get up (depending on your Docker host) for the first time since Wazuh Indexer must be started for the first time and the indexes and index patterns must be generated.

View File

@@ -0,0 +1,31 @@
# Wazuh Docker deployment
## Deploy Wazuh Docker in single node configuration
This deployment is defined in the `single-node/docker-compose.yml` file with one Wazuh manager containers, one Wazuh indexer containers, and one Wazuh dashboard container. It can be deployed by following these steps:
1) Enter the single-node directory of the repository:
```
$ cd single-node
```
2) Increase max_map_count on your host (Linux). This command must be run with root permissions:
```
$ sysctl -w vm.max_map_count=262144
```
3) Run the certificate creation script:
```
$ docker-compose -f generate-indexer-certs.yml run --rm generator
```
4) Start the environment with docker-compose:
- In the foregroud:
```
$ docker-compose up
```
- In the background:
```
$ docker-compose up -d
```
The environment takes about 1 minute to get up (depending on your Docker host) for the first time since Wazuh Indexer must be started for the first time and the indexes and index patterns must be generated.

View File

@@ -0,0 +1,24 @@
# Wazuh Docker deployment
## Deploy Wazuh agent
1) Enter the `wazuh-agent` directory of the repository.
```
$ cd wazuh-agent
```
2) Edit the `docker-compose.yml` file, changing the current value of the `WAZUH_MANAGER_SERVER` variable to the IP or URL of the Wazuh manager:
```
environment:
- WAZUH_MANAGER_SERVER=<WAZUH_MANAGER_IP>
```
3) Start the environment with docker-compose:
- In the foregroud:
```
$ docker-compose up
```
- In the background:
```
$ docker-compose up -d
```

View File

@@ -1 +0,0 @@
# Installation

View File

@@ -1 +0,0 @@
# Performance

View File

@@ -1 +0,0 @@
# Uninstall