rangeid.icinga.maintenance (0.0.2) — module

Authors: Angelo Conforti (@angeloxx)

Install collection

Install with ansible-galaxy collection install rangeid.icinga:==0.0.2


Add to requirements.yml

  collections:
    - name: rangeid.icinga
      version: 0.0.2

Description

Perform Maintenance Operations

Inputs

    
message:
    description:
    - the maintenance message
    required: false
    type: str

service:
    description:
    - regexp or name of involved services. If omitted, only the host will be configured.
      If all or '*', all services will be set in maintenance mode
    required: false
    type: str

duration:
    description:
    - the maintenance window in dhms format, eg. 1d, 30m 40s, 1h 30m
    required: false
    type: str

hostname:
    description:
    - Icinga host object name
    required: true
    type: str

services:
    description:
    - list of involved services
    required: false
    type: list

maintenance:
    choices:
    - enabled
    - disabled
    default: enabled
    description:
    - The state of the maintenance mode
    required: false
    type: choices

check_before:
    description:
    - all about checking the services before operations
    suboptions:
      enabled:
        default: false
        description:
        - check before set or unset maintenance
        required: false
        type: bool
      retries:
        default: 0
        description:
        - retry checks on failure
        required: false
        type: int
      stop_on_failed_service:
        default: false
        description:
        - if check_before is enabled, do not perform changes if one or more checks fails
        required: false
        type: bool
      timeout:
        default: 10
        description:
        - check timeout
        required: false
        type: int

icinga_server:
    description:
    - The Icinga URL in the format https://<server> or https://<server>:<port>/<context>
    required: true
    type: url

icinga_password:
    description:
    - The Icinga user's password
    required: true
    type: str

icinga_username:
    description:
    - The Icinga username
    required: true
    type: str