|
|
@@ -1,26 +1,38 @@
|
|
|
|
# icinga-satellite
|
|
|
|
# icinga-satellite
|
|
|
|
An easy-to-use Dockerized Icinga2 satellite setup. It could be used as an
|
|
|
|
An easy-to-use Dockerized Icinga2 satellite setup. It could be used as an
|
|
|
|
Icinga2 agent aswell, but I don't think that would make much sense. The goal
|
|
|
|
Icinga2 agent aswell, but I don't think that would make much sense. The goal
|
|
|
|
is instead to create an easy-to-deploy satellite Docker.
|
|
|
|
is instead to create an easy-to-deploy satellite image.
|
|
|
|
|
|
|
|
|
|
|
|
## Tags
|
|
|
|

|
|
|
|
|
|
|
|

|
|
|
|
|
|
|
|

|
|
|
|
|
|
|
|

|
|
|
|
|
|
|
|

|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
## Tags and their respective Dockerfile
|
|
|
|
|
|
|
|
|
|
|
|
### Main tags
|
|
|
|
### Main tags
|
|
|
|
* **0.3, latest**
|
|
|
|
* [0.6, latest](https://github.com/jackbenny/icinga-satellite/blob/master/Dockerfile)
|
|
|
|
* **0.2**
|
|
|
|
* [0.5](https://github.com/jackbenny/icinga-satellite/blob/0.5/Dockerfile)
|
|
|
|
* **0.1**
|
|
|
|
* [0.4](https://github.com/jackbenny/icinga-satellite/blob/0.4/Dockerfile)
|
|
|
|
|
|
|
|
* [0.3](https://github.com/jackbenny/icinga-satellite/blob/0.3/Dockerfile)
|
|
|
|
|
|
|
|
* [0.2](https://github.com/jackbenny/icinga-satellite/blob/0.2/Dockerfile)
|
|
|
|
|
|
|
|
* [0.1](https://github.com/jackbenny/icinga-satellite/blob/0.1/Dockerfile)
|
|
|
|
|
|
|
|
|
|
|
|
### Alpine tags (currently has some problems)
|
|
|
|
### Alpine tags (currently has some problems)
|
|
|
|
* **0.1.1-alpine**
|
|
|
|
* [0.1.1-alpine](https://github.com/jackbenny/icinga-satellite/blob/0.1.1-alpine/Dockerfile)
|
|
|
|
* **0.1-alpine**
|
|
|
|
* [0.1-alpine](https://github.com/jackbenny/icinga-satellite/blob/0.1-alpine/Dockerfile)
|
|
|
|
|
|
|
|
|
|
|
|
> **NOTE:** Currently there are some problems with the Alpine image. Use the main images
|
|
|
|
> **NOTE:** Currently there are some problems with the Alpine image.
|
|
|
|
> instead, tagged *0.n*.
|
|
|
|
> Use the *main images* instead, tagged *0.n*.
|
|
|
|
|
|
|
|
|
|
|
|
There are two available images for you to choose from. The default ones (0.*n*) are based on
|
|
|
|
There are two available images for you to choose from. The main images (0.*n*) are based on
|
|
|
|
Ubuntu 18.04, with Icinga2 from Icingas official repository. The other images (0.*n*-alpine) is
|
|
|
|
Debian 10-slim from tag 0.5 and up. Previous to 0.5 they were based on Ubuntu 18.04.
|
|
|
|
based on Alpine 3.11, with Icinga2 from Alpines repository. From 0.1.1-alpine and up, the Alpine
|
|
|
|
The main images uses Icinga2 from Icingas official repository.
|
|
|
|
image is built on the latest Alpine.
|
|
|
|
|
|
|
|
|
|
|
|
The other images (0.*n*-alpine) are based on Alpine with Icinga2 from Alpines repository.
|
|
|
|
|
|
|
|
From 0.1.1-alpine and up, the Alpine images are built on the latest Alpine image. Previous to
|
|
|
|
|
|
|
|
0.1.1 they were based on Alpine 3.11.
|
|
|
|
|
|
|
|
|
|
|
|
## Environment variables
|
|
|
|
## Environment variables
|
|
|
|
Everything is controlled using the following environment variables.
|
|
|
|
Everything is controlled using the following environment variables.
|
|
|
@@ -35,6 +47,10 @@ Everything is controlled using the following environment variables.
|
|
|
|
* **PARENTPORT** is the Icinga2 port on the parent host. Defaults to 5665.
|
|
|
|
* **PARENTPORT** is the Icinga2 port on the parent host. Defaults to 5665.
|
|
|
|
* **TICKET** is the ticket you get from the master (if you are using Director
|
|
|
|
* **TICKET** is the ticket you get from the master (if you are using Director
|
|
|
|
you find it under the Agent tab of the host).
|
|
|
|
you find it under the Agent tab of the host).
|
|
|
|
|
|
|
|
* **TICKET_PATH** is the path to the ticket secrets file if you use Swarm and wants to use
|
|
|
|
|
|
|
|
secrets instead (to keep your ticket secure). The ticket should be on ONE line only
|
|
|
|
|
|
|
|
and be created as an external secret. This variable is optional and only apply for
|
|
|
|
|
|
|
|
Docker Swarm.
|
|
|
|
* **ACCEPT_CONFIG** takes a ***y*** or ***n*** value for yes or no. The default is
|
|
|
|
* **ACCEPT_CONFIG** takes a ***y*** or ***n*** value for yes or no. The default is
|
|
|
|
***n***
|
|
|
|
***n***
|
|
|
|
* **ACCEPT_COMMANDS** takes a ***y*** or ***n*** value for yes or no. The default is
|
|
|
|
* **ACCEPT_COMMANDS** takes a ***y*** or ***n*** value for yes or no. The default is
|
|
|
@@ -79,4 +95,25 @@ services:
|
|
|
|
- LOCAL_TIMEZONE=Europe/Stockholm
|
|
|
|
- LOCAL_TIMEZONE=Europe/Stockholm
|
|
|
|
```
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
## docker-compose.yml example with Docker secrets
|
|
|
|
|
|
|
|
```
|
|
|
|
|
|
|
|
version: "3.8"
|
|
|
|
|
|
|
|
services:
|
|
|
|
|
|
|
|
my-icinga-sat:
|
|
|
|
|
|
|
|
image: jackbenny/icinga-satellite
|
|
|
|
|
|
|
|
environment:
|
|
|
|
|
|
|
|
- CN=icinga-sat02.local
|
|
|
|
|
|
|
|
- PARENTHOST=icinga-master.local
|
|
|
|
|
|
|
|
- PARENTZONE=master
|
|
|
|
|
|
|
|
- TICKET_PATH=/var/run/secrets/ticket
|
|
|
|
|
|
|
|
- ACCEPT_CONFIG=y
|
|
|
|
|
|
|
|
- ACCEPT_COMMANDS=y
|
|
|
|
|
|
|
|
- DISABLE_CONFD=y
|
|
|
|
|
|
|
|
- LOCAL_TIMEZONE=Europe/Stockholm
|
|
|
|
|
|
|
|
secrets:
|
|
|
|
|
|
|
|
- ticket
|
|
|
|
|
|
|
|
secrets:
|
|
|
|
|
|
|
|
ticket:
|
|
|
|
|
|
|
|
external: true
|
|
|
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|