Repository files navigation

Browse hiera data for a given Host usingHDM and theHDM smart proxy plugin.

You must have aHDM installation running.If you are running with authentication enabled, you need an API user in HDM.

SeeHow_to_Install_a_Pluginfor how to install Foreman plugins

The most simple way is installing from packages (available with Foreman 3.6 and later)

RedHat:dnf install rubygem-foreman_hdm rubygem-smart_proxy_hdm

After installation you must initialize the database:foreman-rake db:migrate

The HDM Smart Proxy must be configured:

# /etc/foreman-proxy/settings.d/hdm.yml# HDM Smart Proxy:enabled:https:hdm_url:'http://<HDM IP>:<HDM Port>':hdm_user:'<HDM API User Email>':hdm_password:'<HDM API User Password>'

Next you must restart the smart-proxy:systemctl restart foreman-proxy

Go to Foreman and Refresh the Smart Proxy features.

Within the nodes or node groups you can now set the HDM Smart Proxy.

When you now select a node, you will see an HDM tab.

Todo list here

Fork and send a Pull Request. Thanks!

Copyright (c) 2023 betadots GmbH

This program is free software: you can redistribute it and/or modifyit under the terms of the GNU General Public License as published bythe 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 ofMERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See theGNU General Public License for more details.

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

To make a new release, please do:

• update the version inlib/foreman_hdm/version.rb
• Install gems withbundle install --with release --path .vendor
• generate the changelog withbundle exec rake changelog
• Check if the new version matches the closed issues/PRs in the changelog
  • if required, add labels to unlabled PR/issues, regenerate the changelog
• Create a PR with it
• After it got merged, push a tag that's prefixed withv. GitHub Actions will do the actual release to Rubygems and GitHub Packages

The Foreman team packages this gem as Debian package (deb) and as RedHat package(rpm). They have a bot that will automatically propose an rpm/deb update atgithub.com/theforeman/foreman-packaging.