https://github.com/onix-systems/zabbix-deployment
Deployment of zabbix server by using one config
https://github.com/onix-systems/zabbix-deployment
docker docker-compose installer zabbix zabbix-agent zabbix-deployment zabbix-server
Last synced: 22 days ago
JSON representation
Deployment of zabbix server by using one config
- Host: GitHub
- URL: https://github.com/onix-systems/zabbix-deployment
- Owner: Onix-Systems
- License: apache-2.0
- Created: 2017-10-20T19:28:58.000Z (over 7 years ago)
- Default Branch: master
- Last Pushed: 2021-09-08T07:13:50.000Z (over 3 years ago)
- Last Synced: 2025-04-11T05:07:50.206Z (22 days ago)
- Topics: docker, docker-compose, installer, zabbix, zabbix-agent, zabbix-deployment, zabbix-server
- Language: Python
- Homepage: https://onix-systems.com
- Size: 168 KB
- Stars: 2
- Watchers: 2
- Forks: 5
- Open Issues: 5
-
Metadata Files:
- Readme: readme.md
- License: LICENSE
Awesome Lists containing this project
README
## Be aware of environment's state by using Zabbix solution
[](https://travis-ci.org/Onix-Systems/zabbix-deployment)
### About
Repository contain docker-compose project for running zabbix server on your own server.
1. Zabbix server 3.4
1. Zabbix frontend
1. Zabbix agent (will be installed on host, not run inside the docker container)
1. MariaDB 10.3
1. Exim4 SMTP service
PS: It is used the official docker image: https://hub.docker.com/u/zabbix/
###
Requirements
1. Debian family OS (scripts limits)
1. docker-ce (1.13.0+)
1. docker-compose
### Preparing configuration file for server
If default options are not enough, then please use `.env.example` to create own environment configuration file.
### Run Zabbix server
```shell
$ ./x-setup-server.sh
```
After server will be launched, this script will call `./x-setup-agent.sh` to install
Zabbix agent on host machine, where Zabbix server works inside the docker environment.
#### Run and configured only server components
```shell
$ docker-compose up -d
```
Zabbix provisioned service is **configurator**, after succesfully configuring the server, configurator has to return exit code 0.
To be sure that it is precisely so, execute such command and look at state column:
```shell
$ docker-compose ps configurator
Name Command State Ports
-----------------------------------------------------------------
default_configurator_1 /configurator.py --debug Exit 0
```
If something wrong, it is possible to debug provision by attaching to configurator service while it is running or look at its logs.
```shell
$ docker-compose logs configurator
...
$ docker-compose up configurator
default_db_1 is up-to-date
default_smtp_1 is up-to-date
default_server_1 is up-to-date
default_frontend_1 is up-to-date
Starting default_configurator_1 ...
Starting default_configurator_1 ... done
Attaching to default_configurator_1
configurator_1 | DEBUG:Configurator:SMTP_HELO value is: zabbix.
configurator_1 | INFO:Configurator:Waiting while Zabbix server will be reachable.
configurator_1 | DEBUG:Configurator:Server is reachable.
configurator_1 | INFO:Configurator:Connecting to Zabbix database.
...
configurator_1 | DEBUG:Configurator:Comparasing desired config with current.
configurator_1 | DEBUG:Configurator:Logout from Zabbix server.
default_configurator_1 exited with code 0
```
For enable debug mode, use configurator option `--debug`. It is possible to set this option by using configurator variable `CONFIGURATOR_OPTIONS=--debug` in `.env` environment config file.
### Install and configured external agent
For server it is not necessary to run below described command, `./setup-server.sh` will launch it by self.
```shell
$ ./x-setup-agent.sh --help
...
$ ./x-setup-agent.sh -m "Linux ${DEFAULT_HOST_SECRET}" -s zabbix.local --hostname $(hostname -f)
```
Frontend url is: http://localhost if you launch project on your local machine.
Default user for zabbix is: admin / zabbix
To run project with specific options, please see `.env.example` file.
To apply non default option, copy `.env.example` file to `.env` and
edit necessary values there.
#### Testing a deployment of environment
Project contains Vagrantfile that can be used for testing running the project.
If VM does not exist yes, launch next command:
```
$ vagrant up
```
After succesfully completed provision scenario it is possible to get access to
Zabbix UI by url: http://localhost:8080.
Repeat provision scenario
```
$ vagrant provision
```