Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
an application that automates the lifecycle of servers

Refs #9500 - revert normalize_name tests

Current test "#normalize_hostname sets a domain based on name that contains its name if it's nil and such domain exists" is not testing anything because Domain.all does not return any domains to match (as .create was substituted on merge by .build).
latest commit 6ee8b1c279
Daniel Lobato García eLobato authored
Failed to load latest commit information.
.tx fixing transifex domain in .tx/config and scripts
app fixes #9118 - host mailer should not fail if no owner set for host
bundler.d fixes #9107 - update to fog 1.28.0, fog-aws 0.1+
config fixes #7764 - add quirks mode to JSON.dump
db Refs #3809 - Remove cop emptyliteral
doc fixes #1890 api host status
extras Refs #3809 - Remove useless assignments
lib Refs #4478 - Remove empty line in apipie.rake
locale i18n - extracting new, updating rails, pulling from tx
log WIP rails3 migration
man fixes #4659 - added foreman-tail tool
public fixes #2526 Favicon only shows up if foreman is deployed in the root …
script Fixes #9458 - process only executable debug extensions
test Refs #9500 - revert normalize_name tests
vendor/assets fixes #8049 - Add timezone to user
.gitignore fixes #5793 - add pkg:generate_source rake task to create tar.bz2
.rubocop.yml refs #3809 - exclude auto-generated schema.rb from rubocop checks
.rubocop_todo.yml Refs #3809 - Remove cop emptyliteral
CHANGELOG Bump version to 1.8-develop
Contributors Bump version to 1.8-develop
Gemfile refs #8879 - revert "Pin fast_gettext to get tests to run"
LICENSE fixes #8049 - Add timezone to user
README.md Add issue stats badge
Rakefile Fixes #3468 - Move token expiry to scope to avoid FK issues
Rakefile.dist Refs #7719 - explicitly create .ssh dir in home
VERSION Bump version to 1.8-develop
config.ru fixes #1463 - let Foreman run on a sub path

README.md

Foreman

Build Status Code Climate Issue Stats

Foreman is a free open source project that gives you the power to easily automate repetitive tasks, quickly deploy applications, and proactively manage your servers lifecyle, on-premises or in the cloud.

From provisioning and configuration to orchestration and monitoring, Foreman integrates with your existing infrastructure to make operations easier.

Using Puppet, Chef, Salt and Foreman's smart proxy architecture, you can easily automate repetitive tasks, quickly deploy applications, and proactively manage change, both on-premise with VMs and bare-metal or in the cloud.

Foreman provides comprehensive, interaction facilities including a web frontend, CLI and RESTful API which enables you to build higher level business logic on top of a solid foundation.

Foreman is a mature project, deployed in many organizations, managing from 10s to 10000s of servers. It is used in distributions such as RDO and RHOS (Red Hat OpenStack distribution) and has an extensive library of plugins.

Features

  • Automate your mixed infrastructure to make operations enjoyable
  • Discover, provision and upgrade your entire bare-metal infrastructure
  • Create and manage instances across private and public clouds
  • Group your hosts and manage them in bulk, regardless of location
  • Review historical changes for auditing or troubleshooting
  • Extend as needed via a robust plugin architecture
  • Automatically build images (on each platform) per system definition to optimize deployment
  • LDAP authentication and RBAC authorization to your infrastructure
  • and so much more

Screenshots

Hosts list New host EC2 Provisioning templates Subnets Openstack Edit Puppet class Reports Statistics Partition tables Installation media

Installation

Read the quickstart section of the manual. If you know your setup has some specific needs, read the installation scenarios section.

Documentation

Our main documentation reference is the Foreman manual. If you find some gaps you would like to fill in the manual, please contribute in this repo.

API

We document our API using apipie.The API chapter has more information about accessing the API and the layout of requests and responses. Also see the reference documentation available on our website, or via your own Foreman installation by appending /apidoc to the URL to see the API routes available.

Plugins

Plugins are tools to extend and modify the functionality of Foreman. They are implemented as Rails engines that are packaged as gems and thus easily installed into Foreman. Read the plugins section of the manual for more information.

An up-to-date plugin list is kept in the wiki

How to contribute?

Generally, follow the Foreman guidelines. For code-related contributions, fork this project and send a pull request with all changes. Some things to keep in mind:

  • Follow the rules about commit message style and create a Redmine issue. Doing this right will help reviewers to get your contribution merged faster.
  • Rubocop will analyze your code, you can run it locally with rake rubocop.
  • All of our pull requests run the full test suite in our Jenkins CI system. Please include tests in your pull requests for any additions or changes in functionality

Media

We keep a repository of talks, tutorials, articles about everything in the Foreman ecosystem in the media section of our web. If you want to get yours published, just submit a pull request to theforeman.org repository

Special thanks

The original authors of this project are Ohad Levy and Paul Kelly. You can find a more thorough list of people who have contributed to this project at some point in Contributors.

License

See LICENSE file.

Something went wrong with that request. Please try again.