Skip to content

theforeman/smart_proxy_pulp

Repository files navigation

Foreman Pulp Plugin

Foreman project plugin for Pulp allowing Katello hosts to interact with Pulp application services for content management. While this plugin is part of the Foreman project, it can only be used with Katello as Foreman is not content aware without the Katello plugin.

Getting Started

The Foreman project provides documentation on plugin installation from RPM and direct manual build from source.

For instructions to install a stand alone smart proxy, refer to the documentation.

Prerequisites

  • Working Katello instance (note not Foreman - must be Katello)
  • Pulp 3 installation
  • Smart Proxy 2.3 or newer

Installing

Assuming prerequisites are met, the Pulp plugin must be enabled in the Foreman Proxy directory with pulpcore.yaml. The following parameters should be set:

---
:enabled: true
#:pulp_url: https://localhost/
#:content_app_url: https://localhost:24816/
#:mirror: false

Settings

client_authentication

The setting client_authentication is an array of authentication types supported by the Pulp installation. The valid values are:

  • password: username and password authentication
  • client_certificate: This indicates whether the service handling authentication for Pulp allows matching the client certificate's presented common name to some paired string, often hostname, and setting the remote user header.

Running the tests

Run all tests

bundle exec rake test

Run an individual test

bundle exec rake test TEST=test/pulpcore_plugin_integration_test.rb

Authors

License

This project is licensed under the GNU General Public License v3.0 - see the LICENSE.md file for details

Acknowledgments

  • Foreman IRC user areyus who prompted the need for this README