ansible-infra/roles/knot/meta/argument_specs.yaml

---
argument_specs:
  main:
    options:
      knot__log_level:
        type: str
        required: false

      knot__deploy_prometheus_exporter:
        type: bool
        required: false
        description: Whether a prometheus exporter for knot should also be installed

      knot__remotes:
        description:
          - A list of definitions for remote nameservers that are used for different purposes
          - See https://www.knot-dns.cz/docs/latest/html/reference.html#remote-section for details
        type: list
        elements: dict
        required: false
        options:
          id:
            type: str
            required: true
          address:
            type: list
            required: true
            elements: str
          key:
            type: str
            required: false
          via:
            type: list
            elements: str
            required: false

      knot__catalog_zones:
        description: A list of catalog zones that will be served by knot
        type: list
        elements: dict
        required: false
        options:
          domain:
            type: str
            required: true
          notify_targets:
            type: list
            elements: str
            required: false

      knot__primary_zones:
        description: A list of user zones that will be served by knot
        type: list
        elements: dict
        required: false
        options:
          domain:
            type: str
            required: true
          notify_targets:
            type: list
            elements: str
            required: false
          catalog_member:
            type: str
            required: false
          content:
            type: str
            required: true

      knot__dynamic_zones:
        description: A list of user zones operated via DDNS that will be served by knot
        type: list
        elements: dict
        required: false
        options:
          domain:
            type: str
            required: true
          notify_targets:
            type: list
            elements: str
            required: false
          catalog_member:
            type: str
            required: false
          acl:
            type: list
            elements: str
            required: true

      knot__secondary_zones:
        description: A list of secondary zones that will be served by knot
        required: false
        type: list
        elements: dict
        options:
          domain:
            type: str
            required: true
          notify_targets:
            type: list
            elements: str
            required: false
          catalog_member:
            type: str
            required: false
          primary:
            type: str
            required: true

      knot__catalog_secondary_zones:
        description: A list of zones which are catalog secondaries and which will generate new zones based on the catalog content
        type: list
        elements: dict
        required: false
        options:
          domain:
            type: str
            required: true
          notify_targets:
            type: list
            elements: str
            required: false
          primary:
            type: str
            required: true

      knot__keys:
        description: TSIG Key stanzas used by knot
        required: false
        type: list
        elements: dict
        options:
          id:
            type: str
            required: true
          algorithm:
            type: str
            required: false
          secret:
            type: str
            required: true

      knot__acls:
        description: ACL stanzas
        required: false
        type: list
        elements: dict
        options:
          id:
            type: str
            required: true
          address:
            type: list
            elements: str
            required: false
          key:
            type: str
            required: false
          remote:
            type: list
            elements: str
            required: false
          action:
            type: str
            required: false
          update_type:
            type: list
            elements: str
            required: false