foreman – Manage Foreman Resources

From Get docs
Ansible/docs/2.8/modules/foreman module


foreman – Manage Foreman Resources

New in version 2.3.


DEPRECATED

Removed in Ansible:
version: 2.12
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

- / 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.

verify_ssl

boolean

  • no

  • yes

Whether to verify an SSL connection to Foreman server.



Examples

- name: Create CI Organization
  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.12. [deprecated]
  • For more information see DEPRECATED.

Authors

  • Eric D Helms (@ehelms)

Hint

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


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