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)
|
|
|
|
|
|
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
|
