fork changes

The dockerhub-repository - https://hub.docker.com/repository/docker/necator94/icinga2_stack

Following features/modules added:

• log to /var/log/icinga2/icinga2.log is disabled, use docker functionality instead, e.g. docker-compose logs
• influxdb feature for icinga2
• modules map and grafana for icingaweb2
• environment variables to configure influxdb and grafana
• graphite is disabled

New environment variables:

Environmental Variable	Default Value	Description
ICINGA2_LOG_TO_FILE	false	set to true or 1 to enable logs to /var/log/icinga2/icinga2.log
ICINGA2_FEATURE_INFLUXDB	false	set to true or 1 to enable influxdb writer
ICINGA2_FEATURE_INFLUXDB_HOST	influxdb	hostname or IP address where influxdb is running
ICINGA2_FEATURE_INFLUXDB_PORT	8086	InfluxDB port
ICINGA2_FEATURE_INFLUXDB_SEND_THRESHOLDS	true	send min, max, warn and crit values for perf data
ICINGA2_FEATURE_INFLUXDB_SEND_METADATA	false	send state, latency and execution_time values
ICINGA2_FEATURE_INFLUXDB_FLUSH_THRESHOLD	1024	how many data points to buffer before forcing a transfer
ICINGA2_FEATURE_INFLUXDB_FLUSH_INTERVAL	10s	how long to buffer data points before transferring to InfluxDB
ICINGA2_FEATURE_INFLUXDB_DB_NAME	icinga2	name of the database
ICINGA2_FEATURE_INFLUXDB_DB_USER	icinga2	user of the database
ICINGA2_FEATURE_INFLUXDB_USER_PASSWORD	temp_password	user password
ICINGAWEB2_MODULE_GRAFANA	false	set to true or 1 to enable grafana module
ICINGAWEB2_MODULE_GRAFANA_HOST	grafana:3000	hostname or IP address where grafana is running
ICINGAWEB2_MODULE_GRAFANA_USERNAME	icinga2	grafana user
ICINGAWEB2_MODULE_GRAFANA_PASSWORD	temp_password	grafana password

When InfluxDB and Grafana are enabled their secrets must be specified (no default values).

Examples

Pull the image:

docker pull necator94/icinga2_stack:latest

Substitute the secrets (db_name, db_user, etc.) and run the container:

docker run -p 80:80 \
-h icinga2 \
-e ICINGA2_FEATURE_INFLUXDB_DB_NAME=db_name \
-e ICINGA2_FEATURE_INFLUXDB_DB_USER=db_user \
-e ICINGA2_FEATURE_INFLUXDB_USER_PASSWORD=db_user_password \
-e ICINGAWEB2_MODULE_GRAFANA_USERNAME=grafana_user \
-e ICINGAWEB2_MODULE_GRAFANA_PASSWORD=grafana_password \
-e MYSQL_ROOT_PASSWORD=random \
necator94/icinga2_stack:latest

docker-compose

Docker compose is available at github repository and includes configuration of the following components:

• icinga
• influxdb
• chronograf
• grafana
• grafana renderer

Grafana and InfluxDB docker-compose configuration are originated from https://github.com/jkehres/docker-compose-influxdb-grafana.

Clone the repository:

git clone https://github.com/necator9/icinga2.git
cd icinga2

Create .env file and substitute secrets:

# InfluxDB parameters
INFLUX_ADMIN_USERNAME=admin
INFLUX_ADMIN_PASSWORD=admin
INFLUX_DATABASE=icinga2
INFLUX_USER=icinga2
INFLUX_USER_PASSWORD=random

# Grafana parameters
GRAFANA_USERNAME=admin
GRAFANA_PASSWORD=admin

# Icinga parameters
ICINGAWEB2_ADMIN_USER=icingaadmin
ICINGAWEB2_ADMIN_PASS=icinga
MYSQL_ROOT_PASSWORD=random

Run the docker-compose:

docker-compose up

icinga2 (original description)

This repository contains the source for the icinga2 docker image.

The dockerhub-repository is located at https://hub.docker.com/r/jordan/icinga2/.

This build is automated by push for the git-repo. Just crawl it via:

docker pull jordan/icinga2

Image details

1. Based on debian:buster
2. Key-Features:
   • icinga2
   • icingacli
   • icingaweb2
   • icingaweb2-director module
   • icingaweb2-graphite module
   • icingaweb2-module-aws
   • ssmtp
   • MySQL
   • Supervisor
   • Apache2
   • SSL Support
   • Custom CA support
3. No SSH. Use docker exec or nsenter
4. If passwords are not supplied, they will be randomly generated and shown via stdout.

Usage

Start a new container and bind to host's port 80

docker run -p 80:80 -h icinga2 -t jordan/icinga2:latest

docker-compose

Clone the repository and create a file secrets_sql.env, which contains the MYSQL_ROOT_PASSWORD variable.

git clone https://github.com/jjethwa/icinga2.git
cd icinga2
echo "MYSQL_ROOT_PASSWORD=<password>" > secrets_sql.env
docker-compose up

This boots up an icinga(web)2 container with another MySQL container reachable on http://localhost with the default credentials icingaadmin:icinga.

Icinga Web 2

Icinga Web 2 can be accessed at http://localhost/icingaweb2 with the credentials icingaadmin:icinga (if not set differently via variables). When using a volume for /etc/icingaweb2, make sure to set ICINGAWEB2_ADMIN_USER and ICINGAWEB2_ADMIN_PASS

Saving PHP Sessions

If you want to save your php-sessions over multiple boots, mount /var/lib/php/sessions/ into your container. Session files will get saved there.

example:

docker run [...] -v $PWD/icingaweb2-sessions:/var/lib/php/sessions/ jordan/icinga2

Graphite

The graphite writer can be enabled by setting the ICINGA2_FEATURE_GRAPHITE variable to true or 1 and also supplying values for ICINGA2_FEATURE_GRAPHITE_HOST and ICINGA2_FEATURE_GRAPHITE_PORT. This container does not have graphite and the carbon daemons installed so ICINGA2_FEATURE_GRAPHITE_HOST should not be set to localhost.

Example:

docker run -t \
  --link graphite:graphite \
  -e ICINGA2_FEATURE_GRAPHITE=true \
  -e ICINGA2_FEATURE_GRAPHITE_HOST=graphite \
  -e ICINGA2_FEATURE_GRAPHITE_PORT=2003 \
  jordan/icinga2:latest

Icinga Director

The Icinga Director Icinga Web 2 module is installed and enabled by default. You can disable the automatic kickstart when the container starts by setting the DIRECTOR_KICKSTART variable to false. To customize the kickstart settings, modify the /etc/icingaweb2/modules/director/kickstart.ini.

API Master

The container gets automatically configured as an API master. But it has some caveats. Please make sure:

• Set the container's hostname (-h or hostname)
  • The hostname has to match the name, your sattelites are configured to access the master.
• Forward the 5665 port
• Mount both volumes: /etc/icinga2, /var/lib/icinga2

Sending Notification Mails

The container has msmtp installed, which forwards mails to a preconfigured SMTP server (MTA).

The full documentation for msmtp is found here.

You have to edit the file msmtp/msmtprc for general configuration and msmtp/aliases (mapping from local Unix-user to mail-address). Please note that the example file can be heavily changed and secured, so read the msmtp docs listed above

# msmtp/msmtprc
defaults
auth           on
tls            on
tls_trust_file /etc/ssl/certs/ca-certificates.crt
logfile        /var/log/msmtp.log
aliases        /etc/aliases

# Gmail
account        gmail
host           smtp.gmail.com
port           587
from           <your-email-address@gmail.com>
user           <your-email-address@gmail.com>
password       <your-password-or-eval-command-to-gpg-file>

# Set a default account
account default: gmail

Note that Gmail has become very restrictive, the preparation and config must be done in Gmail's settings. If you can't get it to work, consider another SMTP service.

msmtp/aliases follows the format: Unix-user: e-mail-address.

# msmtp/aliases
root:<YOUR_MAILBOX>
default:<YOUR_MAILBOX>

As a last config change, edit the data/icinga/etc/icinga2/conf.d/users.conf and change the e-mail address root@localhost to either root or a valid external address. This must be done as msmtp interprets all addresses with an at-sign as external and the transport will fail. If the address is changed to root the aliasing feature will use your root alias instead.

These files have to be mounted into the container. Add these flags to your docker run-command:

-v $(pwd)/msmtp/aliases:/etc/aliases:ro
-v $(pwd)/msmtp/msmtprc:/etc/msmtprc:ro

If you are using the docker-compose file, uncomment the settings for these files under the icinga2 node and rebuild.

SSL Support

For enabling of SSL support, just add a volume to /etc/apache2/ssl, which contains these files:

• icinga2.crt: The certificate file for apache
• icinga2.key: The corresponding private key
• icinga2.chain (optional): If a certificate chain is needed, add this file. Consult your CA-vendor for additional info.

For https-redirection or http/https dualstack consult APACHE2_HTTP env-variable.

Custom CA Support

In the case where you need to trust a non-default CA, add the certificate(s) as .crt files to a volume to be mounted at /usr/local/share/ca-certificates/.

Any certificates that are CA certificates with a .crt extension in that volume will automatically be added to the CA store at startup.

Adding own modules

To use your own modules, you're able to install these into enabledModules-folder of your /etc/icingaweb2 volume.

MySQL connections

The container has support to run a MySQL server inside or access some external resources. By default, the MySQL server inside the container is setup, but when using the docker-compose.yml project, the server is located inside an extra container. Future releases will have this as the default and require an external MySQL/MariaDB container.

If you use the image plain or the docker-compose.yml project, you don't have to worry about anything for MySQL. Only, if you want to split the container from the MySQL server, it's necessary to give some variables.

External MySQL servers

If you have the image running plain or use the docker-compose.yml project, there is no necessity to fool around with these variables.

To connect the container with the MySQL server, you have fine granular control via environment variables. For every necessary database, there is a set of variables, which describe the connection to it. In theory, the databases could get distributed over multiple hosts.

All variables are a combination of the service and the property with the format <SERVICE>_MYSQL_<PROPERTY>, while

• <SERVICE> can be one of ICINGA2_IDO, ICINGAWEB2, ICINGAWEB2_DIRECTOR
• <PROPERTY> can be one of HOST, PORT, DATA, USER, PASS

The variables default their respective DEFAULT service variable.

• DEFAULT_MYSQL_HOST: The server hostname (defaults to localhost)
• DEFAULT_MYSQL_PORT: The server port (defaults to 3306)
• DEFAULT_MYSQL_DATA: The database (defaults to unset, the specific services have separate DBs)
  • ICINGA2_IDO_MYSQL_DATA: The database for icinga2 IDO (defaults to icinga2idomysql)
  • ICINGAWEB2_MYSQL_DATA: The database for icingaweb2 (defaults to icingaweb2)
  • ICINGAWEB2_DIRECTOR_MYSQL_DATA: The database for icingaweb2 director (defaults to icingaweb2_director)
• DEFAULT_MYSQL_USER: The MySQL user to access the database (defaults to icinga2)
• DEFAULT_MYSQL_PASS: The password for the MySQL user. (defaults to randomly generated string)

Moving to separate MySQL-container

1. Start your current container as always.
2. Run docker exec <container> i2-port-mysqldb
3. Shutdown the container
4. Copy the MySQL datafolder from the icinga2 container to your new mariadb container.
5. Change the environment variable DEFAULT_MYSQL_HOST to point to your new MySQL container.
6. Add the environment variable MYSQL_ROOT_PASSWORD to the icinga2 container, with the value of your password you currently set.
7. Start your containers.

Reference

Environment variables Reference

Environmental Variable	Default Value	Description
ICINGA2_FEATURE_GRAPHITE	false	Set to true or 1 to enable graphite writer
ICINGA2_FEATURE_GRAPHITE_HOST	graphite	hostname or IP address where Carbon/Graphite daemon is running
ICINGA2_FEATURE_GRAPHITE_PORT	2003	Carbon port for graphite
ICINGA2_FEATURE_GRAPHITE_URL	http://${ICINGA2_FEATURE_GRAPHITE_HOST}	Web-URL for Graphite
ICINGA2_FEATURE_GRAPHITE_SEND_THRESHOLD	true	If you want to send min, max, warn and crit values for perf data
ICINGA2_FEATURE_GRAPHITE_SEND_METADATA	false	If you want to send state, latency and execution_time values for the checks
ICINGA2_FEATURE_DIRECTOR	true	Set to false or 0 to disable icingaweb2 director
ICINGA2_FEATURE_DIRECTOR_USER	icinga2-director	Icinga2director Login User
ICINGA2_FEATURE_DIRECTOR_PASS	random generated each start	Icinga2director Login Password Set this to prevent continues [admin] modify apiuser "icinga2-director" activities
DIRECTOR_KICKSTART	true	Set to false to disable icingaweb2 director's auto kickstart at container startup. Value is only used, if icingaweb2 director is enabled.
ICINGAWEB2_ADMIN_USER	icingaadmin	Icingaweb2 Login User After changing the username, you should also remove the old User in icingaweb2-> Configuration-> Authentication-> Users
ICINGAWEB2_ADMIN_PASS	icinga	Icingaweb2 Login Password
ICINGA2_USER_FULLNAME	Icinga	Sender's display-name for notification e-Mails
APACHE2_HTTP	REDIRECT	Variable is only active, if both SSL-certificate and SSL-key are in place. BOTH: Allow HTTP and https connections simultaneously. REDIRECT: Rewrite HTTP-requests to HTTPS
MYSQL_ROOT_USER	root	If your MySQL host is not on localhost, but you want the icinga2 container to setup the DBs for itself, specify the root user of your MySQL server in this variable.
MYSQL_ROOT_PASSWORD	unset	If your MySQL host is not on localhost, but you want the icinga2 container to setup the DBs for itself, specify the root password of your MySQL server in this variable.
other MySQL variables	none	All combinations of MySQL variables aren't listed in this reference. Please see above in the MySQL section for this.
TZ	UTC	Specify the TimeZone for the container to use

Volume Reference

All these folders are configured and able to get mounted as volume. The bottom ones are not quite necessary.

Volume	ro/rw	Description & Usage
/etc/apache2/ssl	ro	Mount optional SSL-Certificates (see SSL Support)
/etc/locale.gen	ro	In format of the well known locale.gen file. All locales listed in this file will get generated.
/etc/ssmtp/revaliases	ro	revaliases map (see Sending Notification Mails)
/etc/ssmtp/ssmtp.conf	ro	ssmtp configuration (see Sending Notification Mails)
/etc/icinga2	rw	Icinga2 configuration folder
/etc/icingaweb2	rw	Icingaweb2 configuration folder
/var/lib/mysql	rw	MySQL Database
/var/lib/icinga2	rw	Icinga2 Data
/var/lib/php/sessions/	rw	Icingaweb2 PHP Session Files
/var/log/apache2	rw	logfolder for apache2 (not neccessary)
/var/log/icinga2	rw	logfolder for icinga2 (not neccessary)
/var/log/icingaweb2	rw	logfolder for icingaweb2 (not neccessary)
/var/log/mysql	rw	logfolder for mysql (not neccessary)
/var/log/supervisor	rw	logfolder for supervisord (not neccessary)
/var/spool/icinga2	rw	spool-folder for icinga2 (not neccessary)
/var/cache/icinga2	rw	cache-folder for icinga2 (not neccessary)