ktdreyer.koji_ansible.koji_host (0.0.450) — module

Install collection

Install with ansible-galaxy collection install ktdreyer.koji_ansible:==0.0.450

Add to requirements.yml

  collections:
    - name: ktdreyer.koji_ansible
      version: 0.0.450

Description

This module can add new hosts and manage existing hosts.

Koji only supports adding new hosts, not deleting them. Once they are defined, you can enable or disable the hosts with "state: enabled" or "state: disabled".

Requirements

• python >= 2.7
• koji

Usage examples

Scanned by Steampunk Spotter

• Success
  Steampunk Spotter scan finished with no errors, warnings or hints.

- name: create a koji host
  hosts: localhost
  tasks:
    - name: Add new builder1 host
      koji_host:
        name: builder1.example.com
        arches: [x86_64]
        state: enabled
        channels:
          - createrepo
          - default

    - name: Add new builder host for OSBS
      koji_host:
        name: containerbuild1.example.com
        arches: [x86_64]
        state: enabled
        channels:
          # This will automatically create the "container" channel
          # if it does not already exist:
          - container

Inputs

    
name:
    description:
    - The name of the Koji builder.
    - 'Example: "builder1.example.com".'
    required: true

state:
    description:
    - Whether to set this host as "enabled" or "disabled". If unset, this defaults to
      "enabled".

arches:
    description:
    - The list of arches this host supports.
    - 'Example: [x86_64]'
    required: true

comment:
    description:
    - Human-readable comment explaining the current state of the host. You may write a
      description here explaining how this host was set up, or why this host is currently
      offline.

capacity:
    description:
    - Total task weight for this host. This is a float value. If unset, Koji will use
      the standard capacity for a host (2.0).
    - 'Example: 10.0'

channels:
    description:
    - The list of channels this host should belong to.
    - If you specify a completely new channel here, Ansible will create the channel on
      the hub. For example, when you set up OSBS with Koji, you must add a builder host
      to a new "container" channel. You can simply specify "container" in the list here,
      and Ansible will create the new "container" channel when it adds your host to that
      channel.
    - 'Example: [default, createrepo]'
    required: false

description:
    description:
    - Human-readable description for this host.

krb_principal:
    description:
    - Set a single non-default krb principal for this host. If unset, Koji will use the
      standard krb principal scheme for builder accounts.
    - Mutually exclusive with I(krb_principals).

krb_principals:
    description:
    - Set a list of non-default krb principals for this host. If unset, Koji will use
      the standard krb principal scheme for builder accounts. Your Koji Hub must be v1.19
      or later to use this option.
    - Mutually exclusive with I(krb_principal).