Coder Social home page Coder Social logo

mptap / katello Goto Github PK

View Code? Open in Web Editor NEW

This project forked from katello/katello

0.0 1.0 0.0 64.65 MB

Katello integrates open source systems management tools into a single solution for controlling the lifecycle of your machines.

Home Page: katello.org

License: GNU General Public License v2.0

Ruby 63.98% JavaScript 31.81% CSS 3.52% Shell 0.60% Perl 0.02% Python 0.06%

katello's Introduction

Katello Build 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)

Start the background jobs processor

You also will need the delayed_jobs engine to be running to process Katello's async tasks. To start it do:

```bash
cd $GITDIR/foreman

rake jobs:work
```

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 on our Bugzilla or 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}

katello's People

Contributors

ares avatar bbuckingham avatar beav avatar bkearney avatar dmitri-d avatar ehelms avatar gstoeckel avatar inecas avatar isratrade avatar jhadvig avatar jimmac avatar jlconnor avatar jlsherrill avatar jmontleon avatar jsomara avatar knowncitizen avatar komidore64 avatar lzap avatar mbacovsky avatar mccun934 avatar mkelley33 avatar mptap avatar omaciel avatar pajk avatar parthaa avatar pgodhani avatar pitr-ch avatar swarmingbee avatar tstrachota avatar xsuchy avatar

Watchers

 avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.