Skip to content

Commit

Permalink
Fixes #18425 - Update README screenshots and links
Browse files Browse the repository at this point in the history 
Some of the README links were pointing to old versions of our
documentation. Also the pictures are from Foreman 1.8 (I think), the UI
does not look similar at all anymore.
  • Loading branch information
@dLobatog @timogoebel
dLobatog authored and timogoebel committed Feb 10, 2017
1 parent caa2c21 commit 15fc2d9
Showing 1 changed file with 27 additions and 26 deletions.
53 changes: 27 additions & 26 deletions README.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -5,24 +5,24 @@
[![Issue Stats](http://issuestats.com/github/theforeman/foreman/badge/pr)](http://issuestats.com/github/theforeman/foreman)
[![Support IRC channel](https://kiwiirc.com/buttons/irc.freenode.net/theforeman.png)](https://kiwiirc.com/client/irc.freenode.net/?#theforeman)

[Foreman](http://theforeman.org) 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.
[Foreman](https://theforeman.org) 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.

* Website: [theforeman.org](http://theforeman.org)
* Website: [theforeman.org](https://theforeman.org)
* ServerFault tag: [Foreman](http://serverfault.com/questions/tagged/foreman)
* Issues: [Redmine](http://projects.theforeman.org/issues)
* Wiki: [Foreman wiki](http://projects.theforeman.org/projects/foreman/wiki/About)
* Community and support: We use [Freenode](irc.freenode.net) IRC channels
* Community and support: We use [Freenode](https://freenode.net) IRC channels
* #theforeman for general support
* #theforeman-dev for development chat
* Mailing lists:
* [foreman-users](https://groups.google.com/forum/?fromgroups#!forum/foreman-users)
* [foreman-dev](https://groups.google.com/forum/?fromgroups#!forum/foreman-dev)

Using Puppet, [Chef](http://github.com/theforeman/foreman_chef), [Salt](http://github.com/theforeman/foreman_salt) and Foreman's [smart proxy](http://github.com/theforeman/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.
Using [Puppet](https://www.theforeman.org/manuals/latest/#4.2ManagingPuppet), [Ansible](https://theforeman.org/plugins/foreman_ansible/), [Chef](https://theforeman.org/plugins/foreman_chef/), [Salt](https://theforeman.org/plugins/foreman_salt/) and Foreman's [smart proxy](https://www.theforeman.org/manuals/latest/#4.3SmartProxies) 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**](http://theforeman.org/manuals/1.6/index.html#4.5CommandLineInterface) and [**RESTful API**](http://theforeman.org/api_v2.html) which enables you to build higher level business logic on top of a solid foundation.
Foreman provides comprehensive, interaction facilities including a **web frontend**, [**CLI**](https://theforeman.org/manuals/latest/index.html#4.5CommandLineInterface) and [**RESTful API**](https://theforeman.org/documentation.html) which enables you to build higher level business logic on top of a solid foundation.

Foreman is a mature project, deployed in [many organizations](http://projects.theforeman.org/projects/foreman/wiki/Who_Uses_Foreman), 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](http://projects.theforeman.org/projects/foreman/wiki/List_of_Plugins).

Expand All @@ -35,47 +35,48 @@ Foreman is a mature project, deployed in [many organizations](http://projects.th
* 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](http://theforeman.org/manuals/latest/index.html)
* and so [much more](https://theforeman.org/documentation.html)

# Screenshots
![Hosts list](http://i.imgur.com/XXCtFFH.png)
![New host](http://i.imgur.com/e4XrLo2.png =100x20)
![EC2](http://i.imgur.com/IUQ0ciM.png)
![Provisioning templates](http://i.imgur.com/sn9CzN1.png)
![Subnets](http://i.imgur.com/QNO8tdh.png)
![Openstack](http://i.imgur.com/vCwOjdv.png)
![Edit Puppet class](http://i.imgur.com/8nIJip9.png)
![Reports](http://i.imgur.com/ns7Vg1e.png)
![Statistics](http://i.imgur.com/0Hlt7wO.png)
![Partition tables](http://i.imgur.com/Pgdhlsl.png)
![Installation media](http://i.imgur.com/5Uz9LFa.png)
![Hosts list](http://i.imgur.com/VMMLRd3.png)
![New host](http://i.imgur.com/wl9MCyz.png)
![EC2](http://imgur.com/x6gCogZ.png)
![Provisioning templates](http://imgur.com/J3szFIu.png)
![Subnets](http://imgur.com/isBcyGb.png)
![Compute Resource](http://imgur.com/BetWNzW.png)
![Edit Puppet class](http://imgur.com/0KDClmy.png)
![Reports](http://imgur.com/NxlP7yo.png)
![Statistics](http://imgur.com/DKGjtFQ.png)
![Partition tables](http://imgur.com/Gg80lzg.png)
![Installation media](http://imgur.com/BsYcvoM.png)

# Installation
Read the [quickstart section](http://theforeman.org/manuals/latest/#2.Quickstart) of the manual. If you know your setup has some specific needs, read the [installation scenarios section](http://theforeman.org/manuals/latest/#3.2.3InstallationScenarios).
Read the [quickstart section](https://theforeman.org/manuals/latest/quickstart_guide.html#QuickstartGuide) of the manual. If you know your setup has some specific needs, read the [installation scenarios section](https://theforeman.org/manuals/latest/#3.2.3InstallationScenarios).

# Documentation
Our main documentation reference is the [Foreman manual](http://theforeman.org/manuals/latest/). If you find some gaps you would like to fill in the manual, please contribute in [this repo](https://github.com/theforeman/theforeman.org).
Our main documentation reference is the [Foreman manual](https://theforeman.org/manuals/latest/). If you find some gaps you would like to fill in the manual, please contribute in [this repo](https://github.com/theforeman/theforeman.org).

## API
We document our API using [apipie](https://github.com/Apipie/apipie-rails).The [API chapter](http://theforeman.org/manuals/latest/index.html#5.1API) has more information about accessing the API and the layout of requests and responses. Also see the [reference documentation](http://theforeman.org/api_v2.html) available on our website, or via your own Foreman installation by appending `/apidoc` to the URL to see the API routes available.
We document our API using [apipie](https://github.com/Apipie/apipie-rails).The [API chapter](https://theforeman.org/manuals/latest/index.html#5.1API) has more information about accessing the API and the layout of requests and responses. Also see the [reference documentation](https://theforeman.org/api/) 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](http://theforeman.org/manuals/latest/index.html#6.Plugins) of the manual for more information.
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.

An up-to-date plugin list is kept in the [wiki](http://projects.theforeman.org/projects/foreman/wiki/List_of_Plugins)
The [plugins page](https://theforeman.org/plugins/) lists all available plugins and has more information about how to install and develop them.

# How to contribute?
Generally, follow the [Foreman guidelines](http://theforeman.org/contribute.html). For code-related contributions, fork this project and send a pull request with all changes. Some things to keep in mind:
* [Follow the rules](http://theforeman.org/contribute.html#SubmitPatches) about commit message style and create a Redmine issue. Doing this right will help reviewers to get your contribution merged faster.
Generally, follow the [Foreman guidelines](https://theforeman.org/contribute.html). For code-related contributions, fork this project and send a pull request with all changes. Some things to keep in mind:
* [Follow the rules](https://theforeman.org/contribute.html#SubmitPatches) about commit message style and create a Redmine issue. Doing this right will help reviewers to get your contribution merged faster.
* We have a [development handbook](https://theforeman.org/handbook.html) to help developers understand how Foreman developers code.
* [Rubocop](https://github.com/bbatsov/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](http://ci.theforeman.org/). 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](http://theforeman.org/media.html) of our web. If you want to get yours published, just submit a pull request to [theforeman.org repository](https://github.com/theforeman/theforeman.org)
We keep a repository of talks, tutorials, articles about everything in the Foreman ecosystem in the [media section](https://theforeman.org/media.html) of our web. If you want to get yours published, just submit a pull request to [theforeman.org repository](https://github.com/theforeman/theforeman.org)

# Special thanks

The original authors of this project are [Ohad Levy](http://github.com/ohadlevy) and [Paul Kelly](http://github.com/pikelly).
The original authors of this project are [Ohad Levy](https://github.com/ohadlevy) and [Paul Kelly](https://github.com/pikelly).
You can find a more thorough list of people who have contributed to this project at some point in [Contributors](Contributors).

# License
Expand Down

0 comments on commit 15fc2d9

Please sign in to comment.