Skip to content

Commit

Permalink
add readme for installation for packages from git
Browse files Browse the repository at this point in the history
  • Loading branch information
christoph2497 committed Oct 19, 2023
1 parent 0a79083 commit 155f834
Show file tree
Hide file tree
Showing 3 changed files with 21 additions and 4 deletions.
19 changes: 19 additions & 0 deletions doc/role-icingaweb2/role-icingaweb2.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,6 +7,23 @@ The role icingaweb2 installs and configures Icinga Web 2 and its modules.
* [IcingaDB](./module-icingadb.md)
* [Monitoring](./module-monitoring.md)

Custom modules can either be installed via package or git repository.
Therefore set the variable `source` with either `package` or a string consisting `git,repository_url,tag/version/branch`
If no `tag/version/branch` is set the default `HEAD` will be used.

Furthermore it's possible to differentiate between your own custom modules (for example custom themes) and Icinga specific modules.

If you want to manage the config by yourself or the module doesn't need further configuration set the variable `manage_config` to `true` otherwise it needs to be set to `false`

Example:
```
icingaweb2_modules:
my_theme:
enabled: true
manage_config: true
source: git,https://github.com/slalomsk8er/icingaweb2-theme-solarized.git,v1.0.0
```

## Variables

### Icinga Web 2 DB Configuration
Expand Down Expand Up @@ -47,3 +64,5 @@ icingaweb2_resources:
type: ldap
[...]
```


2 changes: 1 addition & 1 deletion roles/icingaweb2/vars/debian-ubuntu.yml
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
icingaweb2_httpd_user: www-data
icingaweb2_fragments_path: /var/tmp/icingaweb
icingaweb2_packages: ["icingaweb2","icingacli","libapache2-mod-php"]
icingaweb2_git_packages: []

4 changes: 1 addition & 3 deletions roles/icingaweb2/vars/main.yml
Original file line number Diff line number Diff line change
Expand Up @@ -3,6 +3,4 @@ icingaweb2_module_packages:
icingadb: icingadb-web
director: icinga-director
businessprocess: icinga-businessprocess
# vspheredb: icingaweb2-module-vspheredb


icingaweb2_git_packages: []

0 comments on commit 155f834

Please sign in to comment.