2015-04-21 13:34:42 +02:00
Icinga Director
===============
2015-11-20 11:07:11 +01:00
Icinga Director has been designed to make Icinga 2 configuration handling easy.
It tries to target two main audiences:
* Users with the desire to completely automate their datacenter
* Sysops willing to grant their "point & click" users a lot of flexibility
What makes Icinga Director so special is the fact that it tries to target both
of them at once.
2016-04-07 19:07:39 +02:00
2015-11-20 11:07:11 +01:00
2016-06-23 17:31:25 +02:00
Read more about Icinga Director in our [Introduction ](doc/01-Introduction.md ) section.
Afterwards, you should be ready for [getting started ](doc/04-Getting-started.md ).
2015-11-20 11:07:11 +01:00
2016-06-23 17:31:25 +02:00
Documentation
-------------
2015-06-01 17:02:31 +02:00
2016-06-23 17:31:25 +02:00
Please have a look at our [Installation instructions ](doc/02-Installation.md )
and our hints for how to apply [Upgrades ](doc/05-Upgrading.md ). We love automation
and in case you also do so, the [Automation chapter ](doc/03-Automation.md ) could
be worth a read. When upgrading, you should also have a look at our [Changelog ](doc/82-Changelog.md ).
You could be interested in understanding how the [Director works ](doc/10-How-it-works.md )
2016-06-24 16:59:15 +02:00
internally. [Working with agents ](doc/24-Working-with-agents.md ) is a topic that
2016-06-23 17:31:25 +02:00
affects many Icinga administrators. Other interesting entry points might be
[Import and Synchronization ](doc/70-Import-and-Sync.md ), our [CLI interface ](doc/60-CLI.md ),
the [REST API ](doc/70-REST-API.md ) and last but not least our [FAQ ](doc/80-FAQ.md ).
A complete list of all our documentation can be found in the [doc ](doc/ ) directory.
2017-01-12 13:39:08 +01:00
Contributing
------------
Icinga Director is an Open Source project and lives from your contributions. No
matter whether these are feature requests, issues, translations, documentation
or code.
2018-09-27 09:24:19 +02:00
* Please check whether a related issue already exists on our [Issue Tracker ](https://github.com/Icinga/icingaweb2-module-director/issues )
2017-01-12 13:39:08 +01:00
* Make sure your code conforms to the [PSR-2: Coding Style Guide ](http://www.php-fig.org/psr/psr-2/ )
* [Unit-Tests ](doc/93-Testing.md ) would be great
* Send a [Pull Request ](https://github.com/Icinga/icingaweb2-module-director/pulls )
(it will automatically be tested on Travis-CI)
* We try hard to keep our master always green: [](https://travis-ci.org/Icinga/icingaweb2-module-director)
2016-06-23 17:31:25 +02:00
Addons
------
The following are to be considered community-supported modules, as they are not
supported by the Icinga Team. At least not yet. But please give them a try if
they fit your needs. They are being used in productive environments:
2017-07-03 23:10:25 +02:00
* [AWS - Amazon Web Services ](https://github.com/Icinga/icingaweb2-module-aws ):
2016-06-23 17:31:25 +02:00
provides an Import Source for Autoscaling Groups on AWS
2017-07-03 23:10:25 +02:00
* [File-Shipper ](https://github.com/Icinga/icingaweb2-module-fileshipper ):
2016-07-21 17:43:57 +02:00
allows Director to ship additional config files with manual config with its
2016-06-23 17:31:25 +02:00
deployments
2017-07-03 23:10:25 +02:00
* [PuppetDB ](https://github.com/Icinga/icingaweb2-module-puppetdb ): provides
2016-06-23 17:31:25 +02:00
an Import Source dealing with your PuppetDB
2018-08-14 12:52:18 +02:00
* [vSphere ](https://github.com/Icinga/icingaweb2-module-vsphere ): VMware vSphere
2017-07-03 23:10:25 +02:00
Import Source for Virtual Machines and Host Systems
