{"id":13500682,"url":"https://github.com/theforeman/foreman_ansible","last_synced_at":"2025-04-13T04:57:20.972Z","repository":{"id":1791607,"uuid":"44873119","full_name":"theforeman/foreman_ansible","owner":"theforeman","description":":arrow_forward: Ansible integration in Foreman","archived":false,"fork":false,"pushed_at":"2025-03-31T12:46:55.000Z","size":2276,"stargazers_count":213,"open_issues_count":22,"forks_count":112,"subscribers_count":22,"default_branch":"master","last_synced_at":"2025-04-13T04:57:15.477Z","etag":null,"topics":["ansible","foreman","hacktoberfest"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":false,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/theforeman.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2015-10-24T15:53:48.000Z","updated_at":"2025-04-09T13:02:13.000Z","dependencies_parsed_at":"2023-12-03T11:20:53.095Z","dependency_job_id":"b3a8f0f5-90c5-47f6-819a-8fcb223b4d77","html_url":"https://github.com/theforeman/foreman_ansible","commit_stats":{"total_commits":742,"total_committers":74,"mean_commits":"10.027027027027026","dds":0.816711590296496,"last_synced_commit":"a6f5ac90af61212eb74991020c5ffe62c55f7b11"},"previous_names":[],"tags_count":167,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/theforeman%2Fforeman_ansible","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/theforeman%2Fforeman_ansible/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/theforeman%2Fforeman_ansible/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/theforeman%2Fforeman_ansible/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/theforeman","download_url":"https://codeload.github.com/theforeman/foreman_ansible/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248665762,"owners_count":21142123,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ansible","foreman","hacktoberfest"],"created_at":"2024-07-31T22:01:09.920Z","updated_at":"2025-04-13T04:57:20.940Z","avatar_url":"https://github.com/theforeman.png","language":"JavaScript","funding_links":[],"categories":["JavaScript"],"sub_categories":[],"readme":"[![Code Climate](https://codeclimate.com/github/theforeman/foreman_ansible/badges/gpa.svg)](https://codeclimate.com/github/theforeman/foreman_ansible)\n[![Gem Version](https://badge.fury.io/rb/foreman_ansible.svg)](https://badge.fury.io/rb/foreman_ansible)\n[![GPL License](https://img.shields.io/github/license/theforeman/foreman_ansible.svg)](https://github.com/theforeman/foreman_ansible/blob/master/LICENSE)\n\n# Foreman Ansible :arrow_forward:\n\nReporting and facts import from Ansible to Foreman.\n\n* Main website: [theforeman.org](https://theforeman.org)\n* Plugin manual: [foreman_ansible manual](https://theforeman.org/plugins/foreman_ansible)\n* ServerFault tag: [Foreman](https://serverfault.com/questions/tagged/foreman)\n* Issues: [foreman ansible on Redmine](https://projects.theforeman.org/projects/ansible/issues)\n* Chat and forum: [https://theforeman.org/support.html](https://theforeman.org/support.html)\n\n## Features\n* Import facts\n* Monitor playbook and Ansible runs runtime\n* Sends Ansible reports to Foreman that contain what changed on your system after an ansible run.\n* Stores a list of roles applicable to your hosts and 'plays' them\n* Looking for an Ansible dynamic inventory for Foreman? Use [theforeman.foreman.foreman](https://github.com/theforeman/foreman-ansible-modules/blob/develop/plugins/inventory/foreman.py)\n\n## Documentation (installation and configuration)\nCheck out the official manual at [theforeman.org](http://theforeman.org/plugins/foreman_ansible/2.x/index.html)\n\n##### Registering a new host in Foreman\n![sign up gif](http://i.imgur.com/mlnVFJj.gif)\n\n##### Host with failed and successful reports\n![reports](http://i.imgur.com/1ySO4sh.png)\n\n##### Assigning roles to a host and 'playing' them\n![role list](http://i.imgur.com/UyeZIq8.png)\n![role play](http://i.imgur.com/eU4RENK.png)\n![multiple role play](http://i.imgur.com/uoIiKJ5.png)\n\n\n## Compatibility\n\n| Foreman | Plugin |\n| ---------------:| --------------:|\n| \u003e= 1.15        | 1.4             |\n| \u003e= 1.16        | 2.0             |\n| \u003e= 1.18        | 2.2             |\n| \u003e= 1.21        | 2.3             |\n\n### Devs\n\nThe callback sends a POST request to /api/v2/hosts/facts with the format you can see [in the API docs](http://theforeman.org/api/1.20/apidoc/v2/hosts/facts.html).\n\nFacts must contain the output of `ansible -m setup $HOSTNAME`, plus a '_type' and '_timestamp' keys. You can see an example on test/fixtures/sample_facts.json in this repository.\n\nAfter that request, you should have a host registered in Foreman with the Ansible facts. It takes into account some facter and ohai facts if these are available on the system as well.\n\n## Copyright\n\nCopyright (c) Daniel Lobato Garcia\n\nThis program is free software: you can redistribute it and/or modify\nit under the terms of the GNU General Public License as published by\nthe Free Software Foundation, either version 3 of the License, or\n(at your option) any later version.\n\nThis program is distributed in the hope that it will be useful,\nbut WITHOUT ANY WARRANTY; without even the implied warranty of\nMERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the\nGNU General Public License for more details.\n\nYou should have received a copy of the GNU General Public License\nalong with this program.  If not, see \u003chttp://www.gnu.org/licenses/\u003e.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftheforeman%2Fforeman_ansible","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftheforeman%2Fforeman_ansible","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftheforeman%2Fforeman_ansible/lists"}