Skip to content

A Foreman plug-in to synchronise hosts to the Netbox CMDB

License

Notifications You must be signed in to change notification settings

dm-drogeriemarkt/foreman_netbox

Repository files navigation

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
3.3 1.2

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

About

A Foreman plug-in to synchronise hosts to the Netbox CMDB

Resources

License

Stars

Watchers

Forks

Packages

No packages published