Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Katello integrates open source systems management tools into a single solution for controlling the lifecycle of your machines.
Ruby JavaScript HTML CSS Other
branch: master

Merge pull request #5196 from waldenraines/10258

Fixes #10258: hide "published at" section if puppet or ssl BZ 1131940.
latest commit 2294794367
@waldenraines waldenraines authored
Failed to load latest commit information.
.tx fix paths in .tx/config after git reorganization
app fixes #10246 - hypervisors do not have pulp record
ca adding redhat-uep.pem to katello ca
config Fixes #10011: fix long URI error when applying errata BZ 1208678.
db Merge pull request #5140 from stbenjam/8447
deploy Fixes #9867: Update katello-remove for latest packages.
doc Fixes #6870/BZ1075523: use ANONYMOUS_ADMIN for hidden user.
engines/bastion_katello Fixes #10258: hide "published at" section if puppet BZ 1131940.
lib fixes #9354 - fixing error with import_errata rake task
locale Fixes #5659 - String Extract
public Bastion: Adding base inline edit directives and adding them to system…
rel-eng Refs #10224 - updating comps for f20, f21
script fixes #8956, #9337 - remove unused scripts and files from specfile
spec Fixes #9818: Properly propogate enabled state for sync plans to Pulp.
test Merge pull request #5154 from ehelms/fixes-9818
vendor Fixes #8384: Remove dependence on ui-alchemy_rails and compass.
yard-template/default link filenames in module/class doc to github
.gitignore Fix apipie static generation on RPM build time
.rspec initial commit
.rubocop.yml Refs #9099 - Update rubocop to 0.28
.rubocop_todo.yml Refs #9099 - Update rubocop to 0.28
.simplecov Setup simplecov in katello
.yardopts Add documentation of db schema
CHANGELOG.md Refs #7242: Add 1.5-2.0 Changelog.
CONTRIBUTING.md Fixes #6272/BZ1118479 - move Bastion guide to katello.org.
CONTRIBUTORS Fixes #7341: Adds script to generate contributors with initial list.
Gemfile Engine: Removing old gem files
LICENSE.txt set Markdown as default markup
README.md Fixes #6297 - delayed jobs is dead, long live foreman-tasks
katello.gemspec Fixes #9986: Lock 'logging' gem to 1.X
rubygem-katello.spec Fixes #10185: Lock openjdk to less than 1.8.0.45.

README.md

Katello Dependency Status

Full documentation is at http://katello.github.io/katello

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 recommended way to set up Katello for development to use the katello-devel-installer directly or via katello-deploy.

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. http://<hostname>:3000/)

  3. Login to Foreman (default: admin and changeme)
  4. Create an initial Foreman organization
  5. Navigate to the Katello engine (e.g. http://<hostname>:3000/katello)

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 getting involved.

Contact & Resources

Documentation

Documentation is generated with YARD and hosted at http://katello.github.io/katello/. This documentation is intended for developers, user documentation can be found on wiki. Developer documentation contains:

  • code documentation
  • high level guides to architectures and implementation details
  • how-tos

Note: older developer guides can be found on our wiki, they are being migrated.

How to

Current documentation

  • {file:doc/YARDDocumentation.md}
  • {file:doc/Graphs.md}

Debugging

  • {file:doc/how_to/add_praise.md Enabling Praise} - raise/exception investigation

Packaging

  • {file:doc/how_to/package_new_gem.md How to package new gem}

Other

  • {file:doc/katellodb.html DB schema documentation}
  • Original Rails generated README {file:doc/RailsReadme}, we may do certain things differently

    • we use doc directory for storing markdown guides instead of a generated documentation

Source

  • {Katello::Configuration}
  • {Notifications}
Something went wrong with that request. Please try again.