Docs4dev
Docs
ansible / 2.10 / collections / community / general / foreman_module.html

community.general.foreman – Manage Foreman Resources

Note

This plugin is part of the community.general collection (version 1.3.2).

To install it use: ansible-galaxy collection install community.general.

To use it in a playbook, specify: community.general.foreman.

DEPRECATED

Removed in

version 2.0.0

Why

Replaced by re-designed individual modules living at https://github.com/theforeman/foreman-ansible-modules

Alternative

https://github.com/theforeman/foreman-ansible-modules

Synopsis

  • Allows the management of Foreman 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
string / required
The Foreman resource that the action will be performed on (e.g. organization, host).
params
string / required
Parameters associated to the entity resource to set or edit in dictionary format (e.g. name, description).
password
string / required
Password for user accessing Foreman server.
server_url
string / required
URL of Foreman server.
username
string / required
Username on Foreman server.
verify_ssl
boolean
    Choices:
  • no ←
  • yes
Whether to verify an SSL connection to Foreman server.

Examples

- name: Create CI Organization
  community.general.foreman:
    username: admin
    password: admin
    server_url: https://fakeserver.com
    entity: organization
    params:
      name: My Cool New Organization
  delegate_to: localhost

Status

  • This module will be removed in version 2.0.0. [deprecated]
  • For more information see DEPRECATED.

Authors

  • Eric D Helms (@ehelms)

© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.10/collections/community/general/foreman_module.html