RobotMK ansible role

Manage the RobotMK CheckMK plugin and test suites.

This role requires https://github.com/geof77/ansible-cmk-utils

In active development. Feature requests, suggestions and contributions are welcome!

NOTES

• For now, the RobotMK agent is installed on the CheckMK server itself. This is not recommended in a production environment. There is work in progress to separate server and agent tasks.

• This role requires a few modifications to work with CheckMK CRE. It will fully support CRE in the future.

Features

• RobotFramework and RobotMK installation
• Deployment of test suites
• Creation of a service monitoring rule

For CheckMK CEE version:

• Create the agent deployment rule with all the suites
• Bake the agent
• Create a rule for automatic discovery of the test cases

Planned features:

• Per-suite configuration settings
• Install the agent on a different host than the server
• Make configuration variables similar to the tribe29.checkmk collection
• Use the collection features where possible (instead of snippets)
• Creation of the robotmk.yml file for CRE
• Agent deployment for CRE
• ...

Requirements

• cd ansbile/roles; git clone https://github.com/geof77/ansible-cmk-utils cmk-utils
• Install the tribe29.checkmk collection

To use CEE features (optional):

• Agent bakery must be configured (with signing keys, ...)
• Additionnal variables must be set
• Automatic agent updates should be enabled

Role Variables

Generic settings

Name	Description
https_proxy	proxy to download the robotmk mkp
cmk_site_name	CheckMK site name
cmk_server_url	URL of the CheckMK server
robotmk_version	"1.4.1"
robotmk_suites	list of suite names you want to deploy from the role's files/ directory

CEE features (agent bakery)

Name	Description
cmk_agent_key_id	the agent key id
cmk_agent_key_pw	the agent key password

Runner configuration

For now, only agent_serial is supported. The agent configuration settings default values can be overriden with these variables:

Settings	Default value
cache_time	960
execution_interval	900
log_level	"INFO"
log_rotation	7
transmit_html	"True"

Dependencies

• tribe29.checkmk >= 0.16.0

Example Playbook

- hosts: checkmk

  collections:
    - tribe29.checkmk

  vars:
    https_proxy: http://proxy.example.com:8000
    cmk_site_name: test
    cmk_server_url: http://test.example.com/test/check_mk
    cmk_agent_key_id: 1
    cmk_agent_key_pw: secret
    robotmk_version: "1.4.1"
    robotmk_suites:
      - testsuite

  roles:
     - robotmk

This is provided as-is in the hope it will be useful, but with no warranty of any kind. This personal project is not maintained nor endorsed by CheckMK or RobotMK authors.

IMPORTANT NOTES:

• This is an early version with basic functions.
• Please read the code and run on test servers only. Feedback welcome.
• Only tested on RHEL 8 with python 3.9