Skip to content

Commit

Permalink
Work in progress
Browse files Browse the repository at this point in the history
  • Loading branch information
amousset committed Feb 8, 2019
1 parent 7e7bd54 commit 77e833f
Showing 1 changed file with 24 additions and 43 deletions.
67 changes: 24 additions & 43 deletions README.asciidoc
Original file line number Diff line number Diff line change
@@ -1,10 +1,15 @@

image::readme-resources/color_logo_horizontal_small.png[Rudder]

Continuous configuration for effective compliance
-------------------------------------------------
Continuous Auditing & Configuration
-----------------------------------

image:https://badges.gitter.im/normation/rudder.svg[link="https://gitter.im/normation/rudder?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge"]
image:https://img.shields.io/stackexchange/serverfault/t/rudder.svg?style=flat[link="https://serverfault.com/questions/tagged/rudder"]
image:https://img.shields.io/badge/docs-.rudder.io-success.svg?style=flat[link="https://docs.rudder.io"]
image:https://img.shields.io/twitter/follow/rudderio.svg?style=social[link="https://twitter.com/rudderio"]


'''

Rudder is an easy to use, web-driven, role-based solution for IT Infrastructure
Automation & Compliance.
Expand All @@ -21,15 +26,15 @@ The workflow offers different users options at their own level:
Rudder is an established project with several 10000s of node managed, in companies
from small to biggest-in-their-field. Typical deployments manage 100s to 1000s of nodes.
The biggest known deployment in 2016 is about 7000 nodes.

The biggest known deployment are about 10.000 nodes.

image::readme-resources/dashboard.png[Rudder Dashboard]

'''

=== Feature overview

* Web interface to manage nodes and define policies
** https://www.rudder-project.org/site/documentation/screenshots/
* Continuously assesses drift compared to defined policies (with or without auto-healing)
* Optionally, continuously enforces configuration over time (configuring once is good,
ensuring configuration is always valid and automatically fixing it is better)
Expand All @@ -39,29 +44,27 @@ image::readme-resources/dashboard.png[Rudder Dashboard]
* Automate common system administration tasks (installation, configuration)
* Full REST API to interact with the Rudder server


TIP: Rudder is open source – we welcome ideas, comments, criticism, patches and
any other contributions! So get chatting with our community
https://www.rudder-project.org/site/support/chat-mailing-lists/[on IRC]!

=== Documentation and community

[horizontal]
Rudder site:: http://rudder-project.org
User documentation:: https://docs.rudder.io/
Rudder site:: https://www.rudder.io
User documentation:: https://docs.rudder.io
API documentation:: https://docs.rudder.io/api
Mailing list, IRC:: https://www.rudder-project.org/site/community/mailing-lists/
Bug report:: http://www.rudder-project.org/redmine/projects/rudder/issues
Mailing list, IRC:: https://chat.rudder.io
Bug report:: https://issues.rudder.io/projects/rudder/issues
Source:: https://github.com/Normation/rudder


=== Testing and installing Rudder

==== 5 minute tests

===== Demo site

You can see a demo version of Rudder: http://demo.rudder-project.org/
You can see a demo version of Rudder: https://demo.rudder.io

===== Vagrant

Expand Down Expand Up @@ -101,14 +104,12 @@ embedded Linux on ARM/x86, Android, FreeBSD but no ready-to-use packages are pro

Normation offers AIX, Solaris and Windows agents.


=== Authors

Rudder is supported by Normation http://www.normation.com/en/rudder/
Rudder is supported by https://www.rudder.io/en/company/about-us/[Normation].

The list of contributors is available in https://github.com/Normation/rudder/graphs/contributors


=== License

This project is licensed under GPLv3 license, see the provided "LICENSE" file or
Expand All @@ -124,8 +125,7 @@ Thank you for your interest in our project!

We welcome pull requests on any of the Rudder repositories.

The contribution process is detailed here:
http://www.rudder-project.org/HowToContribute
The contribution process is detailed https://www.rudder.io/en/expand/contribute/[on our website].

=== Rudder components and projects overview

Expand All @@ -135,7 +135,7 @@ image::readme-resources/rudder-functional-component-diagram.png[Rudder Functiona

==== Projects

Rudder is now composed of several projects:
Rudder is now composed of several repositories:

|====
|Component | Description and GitHub Projects
Expand All @@ -150,11 +150,11 @@ This project contains the CLI for Rudder agent
https://github.com/Normation/rudder-agent

| Rudder Techniques |
Provided Techniques coming in the base set-up of Rudder
Provided techniques coming in the base set-up of Rudder
https://github.com/Normation/rudder-techniques

| ncf framework |
A powerful and structured CFEngine framework used to build Rudder Techniques
A powerful and structured configuration framework used to build Rudder techniques
https://github.com/Normation/ncf

| Rudder server |
Expand All @@ -163,12 +163,7 @@ generation by node, and compliance reporting. It also manages node
inventories.
It is composed of several Scala projects:

https://github.com/Normation/rudder-parent-pom
https://github.com/Normation/rudder-commons
https://github.com/Normation/scala-ldap
https://github.com/Normation/cf-clerk
https://github.com/Normation/rudder
https://github.com/Normation/ldap-inventory

| Rudder packages |
This project contains all the logic to build both server and agent packages for Rudder
Expand All @@ -180,8 +175,7 @@ https://github.com/Normation/rudder-tools

| Rudder plugins |
Plugin examples:
https://github.com/Normation/rudder-plugin-helloworld
https://github.com/Normation/rudder-plugin-external-node-information
https://github.com/Normation/rudder-plugins
https://github.com/Normation/rudder-plugin-itop

|====
Expand All @@ -196,22 +190,9 @@ You will need a working Maven 3.x.x installation.

We are working on a public artefact repository for Rudder, so for now you will
need to build all dependencies for the Scala web application yourself.
You can create a script with the following lines:

----
$ echo clone-build-rudder.sh
git clone https://github.com/Normation/rudder.git
mvn install
----

----
#!/bin/sh
BASE="$PWD"
REPOS="rudder-parent-pom rudder-commons scala-ldap ldap-inventory rudder"
for i in ${REPOS}; do
echo "\e[0;32mCloning ${i}\e[0m"
git clone https://github.com/Normation/$i.git
P=${BASE}/${i}
cd ${P}
echo "\e[0;32mBuilding ${P}\e[0m"
mvn install
done
----

0 comments on commit 77e833f

Please sign in to comment.