Documentation

katello - Manage Katello Resources

New in version 2.3.

Synopsis

  • Allows the management of Katello resources inside your Foreman server.

Requirements

The below requirements are needed on the host that executes this module.

  • nailgun >= 0.28.0
  • python >= 2.6
  • datetime

Parameters

Parameter
Choices/Defaults
Comments
entity
required
The Foreman resource that the action will be performed on (e.g. organization, host).
params
required
Parameters associated to the entity resource to set or edit in dictionary format (e.g. name, description).
password
required
Password for user accessing Foreman server.
server_url
required
URL of Foreman server.
username
required
Username on Foreman server.

Examples

---
# Simple Example:

- name: Create Product
  katello:
      username: admin
      password: admin
      server_url: https://fakeserver.com
      entity: product
      params:
        name: Centos 7
  delegate_to: localhost

# Abstraction Example:
# katello.yml
---
- name: "{{ name }}"
  katello:
      username: admin
      password: admin
      server_url: https://fakeserver.com
      entity: "{{ entity }}"
      params: "{{ params }}"
  delegate_to: localhost

# tasks.yml
---
- include: katello.yml
  vars:
    name: Create Dev Environment
    entity: lifecycle_environment
    params:
      name: Dev
      prior: Library
      organization: Default Organization

- include: katello.yml
  vars:
    name: Create Centos Product
    entity: product
    params:
      name: Centos 7
      organization: Default Organization

- include: katello.yml
  vars:
    name: Create 7.2 Repository
    entity: repository
    params:
      name: Centos 7.2
      product: Centos 7
      organization: Default Organization
      content_type: yum
      url: http://mirror.centos.org/centos/7/os/x86_64/

- include: katello.yml
  vars:
      name: Create Centos 7 View
      entity: content_view
      params:
        name: Centos 7 View
        organization: Default Organization
        repositories:
          - name: Centos 7.2
            product: Centos 7

- include: katello.yml
  vars:
      name: Enable RHEL Product
      entity: repository_set
      params:
        name: Red Hat Enterprise Linux 7 Server (RPMs)
        product: Red Hat Enterprise Linux Server
        organization: Default Organization
        basearch: x86_64
        releasever: 7

Status

This module is flagged as preview which means that it is not guaranteed to have a backwards compatible interface.

Author

  • Eric D Helms (@ehelms)

Hint

If you notice any issues in this documentation you can edit this document to improve it.