Katello integrates open source systems management tools into a single solution for controlling the lifecycle of your machines.
Ruby JavaScript HTML CSS
Latest commit a5875cc Aug 23, 2016 @johnpmitsch johnpmitsch committed on GitHub Fixes #1421 - Show message on empty search results (#6171)
On an empty search result, a message that no results are returned
will be shown instead of a message that says "No _____ exists"
Failed to load latest commit information.
.tx fix paths in .tx/config after git reorganization Apr 29, 2013
app Merge pull request #6263 from bbuckingham/issue-15531 Aug 22, 2016
bin Fixes #15035 - Adding rails script to katello (#6045) May 13, 2016
ca adding redhat-uep.pem to katello ca Oct 5, 2011
config Merge pull request #6150 from waldenraines/15376 Jul 7, 2016
db Fixes #16137 - subscription_facet.activation_keys should be uniq (#6248) Aug 18, 2016
engines/bastion_katello Fixes #1421 - Show message on empty search results (#6171) Aug 23, 2016
lib Fixes #16169 - remove trailing dot in hostnames in upgrade task (#6252) Aug 22, 2016
locale Merge pull request #5760 from bkearney/bkearney/10241 Feb 9, 2016
spec Fixes #16035: fix next sync calculation for weekly sync plans. Aug 9, 2016
test Fixes #15808 - Provide more info for incremental update task name (#6224 Aug 22, 2016
vendor Fixes #4062: remove jScrollPane and references. Jun 24, 2016
.gitignore Fixes #13396 - Update the zanata mapping files Jan 27, 2016
.rspec initial commit Jun 15, 2011
.rubocop.yml Fixes #15722 - rename *_filter to *_action (#6190) Jul 20, 2016
.rubocop_todo.yml Refs #14950 - Enabling some 0.39 rubocops (#6167) Jul 7, 2016
.simplecov Setup simplecov in katello Mar 5, 2013
CONTRIBUTING.md Fixes #15034 - Remove old scripts from katello (#6044) May 13, 2016
CONTRIBUTORS adding myself to contrib Jul 1, 2015
Gemfile Engine: Removing old gem files Dec 6, 2013
LICENSE.txt set Markdown as default markup Jan 16, 2013
README.md Fixes #15669 - Fixing old stuff in README (#6180) Jul 13, 2016
katello.gemspec Fixes #16213 - Trying to fix polyglot error (#6260) Aug 22, 2016

README.md

Katello

Build Status Code Climate Dependency Status

Full documentation is at http://www.katello.org

About

Katello is a systems life cycle management plugin to Foreman. Katello allows you to manage thousands of machines with one click. Katello can pull content from remote repositories into isolated environments, and make subscriptions management a breeze.

Currently, it is able to handle Fedora and Red Hat Enterprise Linux based systems.

Development

The most common way to set up Katello for development is to use katello-deploy. This will set up a Vagrant instance with the Katello codebase checked out. You can also run setup.rb directly with katello-deploy if you prefer to not use Vagrant.

There is also katello-devel-installer if you would like to use that.

If you have questions or issues with any of the above methods, feel free to ask for assistance on #theforeman-dev IRC channel or via the foreman-dev mailing list.

Test Run

At this point, the development environment should be completely setup and the Katello engine functionality available. To verify this, go to your Foreman checkout:

  1. Start the development server

    cd $GITDIR/foreman
    
    rails s
  2. Access Foreman in your browser (e.g. https://<hostname>/). Note that while Rails will listen on port 3000, the dev installer will set up a reverse proxy so HTTPS on port 443 will work.

  3. Login to Foreman (default: admin and changeme)
  4. If you go to https://<hostname>/about and view the "Plugins" tab, you should see a "Katello" plugin listed.

Reset Development Environment

In order to reset the development environment, all backend data and the database needs to be reset. To reiterate, the following will destroy all data in Pulp, Candlepin and your Foreman/Katello database. From the Foreman checkout run:

rake katello:reset

Found a bug?

That's rather unfortunate. But don't worry! We can help. Just file a bug in our project tracker.

Contributing

See the developer documentation.

Contact & Resources

Documentation

Most of our documentation (both for users and developers) can be found at Katello.org.