https://github.com/theforeman/foreman-operations-collection

Ansible collection for management of Foreman servers
https://github.com/theforeman/foreman-operations-collection

hacktoberfest

Last synced: 3 months ago
JSON representation

Ansible collection for management of Foreman servers

• Host: GitHub
• URL: https://github.com/theforeman/foreman-operations-collection
• Owner: theforeman
• License: gpl-3.0
• Created: 2020-10-28T12:22:05.000Z (almost 5 years ago)
• Default Branch: develop
• Last Pushed: 2025-05-27T06:43:55.000Z (5 months ago)
• Last Synced: 2025-06-21T13:06:22.629Z (4 months ago)
• Topics: hacktoberfest
• Language: Makefile
• Size: 6.4 MB
• Stars: 10
• Watchers: 8
• Forks: 16
• Open Issues: 6
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.rst
  • License: LICENSE

Awesome Lists containing this project

README

          
# Foreman Operations Collection ![Build Status](https://github.com/theforeman/foreman-operations-collection/workflows/CI/badge.svg)

Ansible assets for managing Foreman operations such as install and maintenance tasks.

## Documentation

A list of all assets and their documentation can be found at [theforeman.org/plugins/foreman-operations-collection](https://theforeman.org/plugins/foreman-operations-collection/).

## Support

### Supported Foreman and plugins versions

Ansible assets should support any currently stable Foreman release and the matching set of plugins.

Some modules have additional features/arguments that are only applied when the corresponding plugin is installed.

We actively test the modules against the latest stable Foreman release and the matching set of plugins.

### Supported Ansible Versions

The supported Ansible versions are aligned with currently maintained Ansible versions. You can find the list of maintained Ansible versions [here](https://docs.ansible.com/ansible/latest/reference_appendices/release_and_maintenance.html#release-status).

### Supported Python Versions

Ansible only supports Python 2.7 and 3.5 (and higher). These are also the only Python versions we develop and test the modules against.

### Known issues

## Installation

There are currently two ways to use the modules in your setup: install directly from Ansible Galaxy or via packages.

### Installation from Ansible Galaxy

You can install the collection from [Ansible Galaxy](https://galaxy.ansible.com/theforeman/operations) by running `ansible-galaxy collection install theforeman.operations`.

After the installation, the assets are available as `theforeman.operations.`. Please see the [Using Ansible collections documentation](https://docs.ansible.com/ansible/devel/user_guide/collections_using.html) for further details.

### Installation via packages

The collection is also available as `ansible-collection-theforeman-operations` from the `plugins` repository on `yum.theforeman.org` for Enterprise Linux systems and from the `plugins` repository on `deb.theforeman.org` for Debian and Ubuntu systems.

After installing the package, you can use the modules in the same way as when they are installed directly from Ansible Galaxy.

## Dependencies

These dependencies are required for the Ansible controller, not the Foreman server.

* `PyYAML`