checkmk

Ansible role to install CheckMK server or satellite.

Sponsor

Building and improving this Ansible role have been sponsored by my current and previous employers like Cloudpunks GmbH and Proact Deutschland GmbH.

Table of content

• Requirements
• Default Variables
  • checkmk_admin_password
  • checkmk_default_folders
  • checkmk_default_labels
  • checkmk_default_publish
  • checkmk_default_volumes
  • checkmk_extra_folders
  • checkmk_extra_labels
  • checkmk_extra_publish
  • checkmk_extra_volumes
  • checkmk_image
  • checkmk_livestatus_tcp
  • checkmk_mail_relay_host
  • checkmk_network
  • checkmk_pull_image
  • checkmk_site_id
  • checkmk_version
• Discovered Tags
• Dependencies
• License
• Author

---

Requirements

• Minimum Ansible version: 2.10

Default Variables

checkmk_admin_password

Password for the admin user

Default value

checkmk_admin_password:

checkmk_default_folders

List of default folders to create

Default value

checkmk_default_folders:
  - /var/lib/checkmk

checkmk_default_labels

List of default labels to assign to docker command

Default value

checkmk_default_labels: []

checkmk_default_publish

List of default port publishing

Default value

checkmk_default_publish:
  - 5000:5000
  - 6557:6557

Example usage

checkmk_default_publish:
  - 127.0.0.1:5000:5000
  - 127.0.0.1:6557:6557

checkmk_default_volumes

List of default volumes to mount

Default value

checkmk_default_volumes:
  - /var/lib/checkmk:/opt/omd/sites

checkmk_extra_folders

List of extra folders to create

Default value

checkmk_extra_folders: []

Example usage

checkmk_extra_folders:
  - /path/to/host/folder1
  - /path/to/host/folder2
  - /path/to/host/folder3

checkmk_extra_labels

List of extra labels to assign to docker command

Default value

checkmk_extra_labels: []

checkmk_extra_publish

List of extra port publishing

Default value

checkmk_extra_publish: []

Example usage

checkmk_extra_publish:
  - 8080:8080
  - 127.0.0.1:9000:9000

checkmk_extra_volumes

List of extra volumes to mount

Default value

checkmk_extra_volumes: []

Example usage

checkmk_extra_volumes:
  - /path/to/host/folder1:/path/within/container1
  - /path/to/host/folder2:/path/within/container2
  - /path/to/host/folder3:/path/within/container3

checkmk_image

Docker image to use for deployment

Default value

checkmk_image: checkmk/check-mk-raw:{{ checkmk_version }}

checkmk_livestatus_tcp

Enable livestatus via TCP

Default value

checkmk_livestatus_tcp: true

checkmk_mail_relay_host

Host of an SMTP relay server

Default value

checkmk_mail_relay_host:

checkmk_network

Optionally assign this Docker network to container

Default value

checkmk_network:

checkmk_pull_image

Pull image as part of the tasks

Default value

checkmk_pull_image: true

checkmk_site_id

Site name of the CheckMK server

Default value

checkmk_site_id:

checkmk_version

Version of CheckMK to use

Default value

checkmk_version: 2.3.0-latest

Discovered Tags

checkmk

Dependencies

• rolehippie.docker
• community.docker

License

Apache-2.0

Author

Thomas Boerger