tribe29.checkmk.bakery (0.23.0) — module

Trigger baking and signing in the agent bakery.

| "added in version" 0.21.0 of tribe29.checkmk"

Authors: Max Sickora (@max-checkmk)

Install collection

Install with ansible-galaxy collection install tribe29.checkmk:==0.23.0


Add to requirements.yml

  collections:
    - name: tribe29.checkmk
      version: 0.23.0

Description

Trigger baking and signing in the agent bakery.

Usage examples

  • Success
    Steampunk Spotter scan finished with no errors, warnings or hints.
# Bake all agents without signing, as example in a fresh installation without a signature key.
- name: "Bake all agents without signing."
  tribe29.checkmk.bakery:
    server_url: "http://localhost/"
    site: "my_site"
    automation_user: "automation"
    automation_secret: "$SECRET"
    state: "baked"
  • Success
    Steampunk Spotter scan finished with no errors, warnings or hints.
# Sign all agents.
- name: "Sign all agents."
  tribe29.checkmk.bakery:
    server_url: "http://localhost/"
    site: "my_site"
    automation_user: "automation"
    automation_secret: "$SECRET"
    signature_key_id: 1
    signature_key_passphrase: "secretkey"
    state: "signed"
  • Success
    Steampunk Spotter scan finished with no errors, warnings or hints.
# Bake and sign all agents.
- name: "Bake and sign all agents."
  tribe29.checkmk.bakery:
    server_url: "http://localhost/"
    site: "my_site"
    automation_user: "automation"
    automation_secret: "$SECRET"
    signature_key_id: 1
    signature_key_passphrase: "secretkey"
    state: "baked_signed"

Inputs

    
site:
    description: The site you want to connect to.
    required: true
    type: str

state:
    choices:
    - baked
    - signed
    - baked_signed
    default: baked
    description: State - Baked, signed or baked and signed
    type: str

server_url:
    description: The base url of your Checkmk server.
    required: true
    type: str

validate_certs:
    default: true
    description: Whether to validate the SSL certificate of the Checkmk server.
    type: bool

automation_user:
    description: The automation user you want to use. It has to be an 'Automation' user,
      not a normal one.
    required: true
    type: str

signature_key_id:
    description: The id of the signing key
    required: false
    type: int

automation_secret:
    description: The secret to authenticate your automation user.
    required: true
    type: str

signature_key_passphrase:
    description: The passphrase of the signing key
    required: false
    type: str

Outputs

http_code:
  description: The HTTP code the Checkmk API returns.
  returned: always
  sample: '200'
  type: int
message:
  description: The output message that the module generates.
  returned: always
  sample: Done.
  type: str