0.01
The project is in a healthy, maintained state
Adds integration with NetBox
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
 Dependencies

Development

>= 0
~> 1.10.0

Runtime

 Project Readme

ForemanNetbox

This is a plugin for Foreman that introduces integration with NetBox

Compatibility

Netbox Version Plugin Version
2.8 1.0
2.11 1.1

Installation

See How_to_Install_a_Plugin for how to install Foreman plugins.

The gem name is "foreman_netbox".

Integration tests

The easiest way to start Netbox is to use netbox-docker. To run integration tests provide FOREMAN_NETBOX_URL and FOREMAN_NETBOX_TOKEN variables, eg.

$ FOREMAN_NETBOX_URL=http://0.0.0.0:8000 FOREMAN_NETBOX_TOKEN=0123456789abcdef0123456789abcdef01234567 bundle exec rake test:foreman_netbox

After installation of the plugin you can find these settings as well under Administer/Settings/Netbox tab.

You will find there as well a Netbox Orchestration Switch.

If the switch is enabled every change of a Foreman Hostobject will be synced with your netbox instance.

Contributing

Fork and send a Pull Request. Thanks!

Copyright

Copyright (c) 2019 dmTECH GmbH, dmtech.de

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see http://www.gnu.org/licenses/.