Giter Club home page Giter Club logo

Katello

Build Status Code Climate

Full documentation is at https://www.theforeman.org/plugins/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 most common way to set up Katello for development is to use forklift. This will set up a virtual machine with the Katello codebase checked out. Please use the forklift documentation found in the repository for how to get started with forklift.

If you have questions about or issues with deploying a development environment, feel free to ask for assistance in #theforeman-dev IRC channel on libera.chat or via the community forum

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
    
    bundle exec foreman start
  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. The first time you do this, you will need to accept the self-signed certificate on port 3808 by first visiting https://<hostname>:3808

  4. Login to Foreman (default: admin and changeme)

  5. 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.

Annotated Pulp and Candlepin Workflows and test Scenarios

See the annotation docs for more information.

Contact & Resources

Documentation

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

Katello Project's Projects

foreman_sam icon foreman_sam

:warning: UNMAINTAINED :warning: This repo is no longer maintained - Katello plugin to convert app to SAM

generator-bastion icon generator-bastion

Yeoman based generator for easily scaffolding new Bastion based components.

hammer-cli-import icon hammer-cli-import

Hammer CLI plugin for mass importing data from an existing Satellite/Spacewalk server into a Katello server

katello icon katello

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

katello-cli icon katello-cli

:warning: UNMAINTAINED :warning: This project is defunct. For the katello cli, see https://github.com/Katello/hammer-cli-katello

katello-foreman-engine icon katello-foreman-engine

:warning: UNMAINTAINED :warning: This repo is no longer maintained. Foreman specific parts in Katello

katello-installer-legacy icon katello-installer-legacy

:warning: UNMAINTAINED :warning: This repo is no longer maintained. Install and installation management tool for Katello.

katello-misc icon katello-misc

:warning: UNMAINTAINED :warning: This repo is no longer maintained. Miscellaneous scripts and utilities for Katello

katello-reports-engine icon katello-reports-engine

:warning: UNMAINTAINED :warning: This repo is no longer maintained. katello based splice reports

katello-selinux-legacy icon katello-selinux-legacy

:warning: UNMAINTAINED :warning: This repo is no longer maintained. Selinux policy for Katello.

katello-website icon katello-website

:warning: UNMAINTAINED :warning: This repo is no longer maintained. The Katello community website.

katello.org icon katello.org

** WE'VE MOVED ** The Katello documentation has moved to https://github.com/theforeman/theforeman.org

katello_api icon katello_api

:warning: UNMAINTAINED :warning: This repo is no longer maintained. Ruby bindings for Katello's rest API

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.