Skip to content

Commit

Permalink
WIP: doc, module.info: prepare v1.11.0
Browse files Browse the repository at this point in the history
fixes #2085
  • Loading branch information
Thomas-Gelf committed Oct 13, 2023
1 parent fb1a23f commit a6f0a08
Show file tree
Hide file tree
Showing 10 changed files with 88 additions and 10 deletions.
4 changes: 2 additions & 2 deletions doc/02-Installation.md.d/From-Source.md
Original file line number Diff line number Diff line change
Expand Up @@ -41,7 +41,7 @@ and extract it to a folder named `director` in one of your Icinga Web module pat
You might want to use a script as follows for this task:

```shell
MODULE_VERSION="1.10.2"
MODULE_VERSION="1.11.0"
ICINGAWEB_MODULEPATH="/usr/share/icingaweb2/modules"
REPO_URL="https://github.com/icinga/icingaweb2-module-director"
TARGET_DIR="${ICINGAWEB_MODULEPATH}/director"
Expand All @@ -60,7 +60,7 @@ Simply clone the repository in one of your Icinga web module path directories.
You might want to use a script as follows for this task:

```shell
MODULE_VERSION="1.10.2"
MODULE_VERSION="1.11.0"
ICINGAWEB_MODULEPATH="/usr/share/icingaweb2/modules"
REPO_URL="https://github.com/icinga/icingaweb2-module-director"
TARGET_DIR="${ICINGAWEB_MODULEPATH}/director"
Expand Down
11 changes: 10 additions & 1 deletion doc/05-Upgrading.md
Original file line number Diff line number Diff line change
Expand Up @@ -15,6 +15,7 @@ you will be told so in your frontend.
Please read more about:

* [Database Backup](#backup-first)
* [Upgrading to 1.11.x](#upgrade-to-1.11.x)
* [Upgrading to 1.10.x](#upgrade-to-1.10.x)
* [Upgrading to 1.9.x](#upgrade-to-1.9.x)
* [Upgrading to 1.8.x](#upgrade-to-1.8.x)
Expand All @@ -41,7 +42,15 @@ use the tools provided by your database backend, like `mysqldump` or `pg_dump`.
Restoring from a backup is trivial, and Director will always be able to apply
pending database migrations to an imported old database snapshot.

<a name="upgrade-to-1.9.x"></a>Upgrading to 1.10.x
<a name="upgrade-to-1.10.x"></a>Upgrading to 1.10.x
--------------------------------------------------


Before upgrading, please upgrade the [incubator module](https://github.com/Icinga/icingaweb2-module-incubator)
to (at least) v0.20.0. As always, you'll be prompted to apply pending Database
Migrations.

<a name="upgrade-to-1.11.x"></a>Upgrading to 1.11.x
--------------------------------------------------

Please check module dependencies, we raised some of them. In case you're missing
Expand Down
81 changes: 75 additions & 6 deletions doc/82-Changelog.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,10 +4,71 @@
Please make sure to always read our [Upgrading](05-Upgrading.md) documentation
before switching to a new version.

v1.11.0 (unreleased)
--------------------
v1.11.0
-------

Icinga Director v1.11 ships a nice new feature, which has been requested by
many users: it is now possible to let Notification rules pick User and/or User
Groups from Host and Service custom variables.

![82-1.11.0-05-notification_user-var.png](screenshot/director/82_changelog/v1.11.0/82-1.11.0-05-notification_user-var.png)

Behind the scenes, some Icinga DSL assures that Icinga behaves as expected:

![82-1.11.0-06-notification_user-var_rendered.png](screenshot/director/82_changelog/v1.11.0/82-1.11.0-06-notification_user-var_rendered.png)

The IcingaDB module is now supported. This release also ships a fallback template
for Icinga for Windows 1.11 (and Icinga 2.14). To improve security for those
relying on default settings, all Host templates are per default rendered to all
non-global zones in a redundant way, instead of being rendered to the main global
zone.

For those who want to store Secrets in their Host template definitions, this now
hinders them from reaching your Agent Endpoints. In addition to this, with this
release you now have more control over target Zones for services belonging to
Service Sets. Also, some issues related to permissions and restrictions have been
addressed.

Various little Import and Sync issues have been addressed, automated Service
Template import has been fixed. In addition to some minor Property modifier
improvements, they can now be applied in a conditional way. Such filter rules
also support CIDR notation. Most prominent use-case: as vSphereDB now ships ALL
guest IP addresses, you can pick specific addresses for specific use-cases /
host properties based on their network range:

![CIDR-based filters](screenshot/director/82_changelog/v1.11.0/82-1.11.0-01-cidr_based_filters.png)

This release now officially supports PHP 8.2, addresses issues when integrating
with the IcingaDB web module, and some dark-mode glitches. Search functionality
has been improved, Preview Diff shows more details, editing multiple single
Services with the very same name has been fixed, and the interactive Startup log
renderer now wraps log lines in a nice way:

![82-1_11_0-02-wrap-startup-log-lines.png](screenshot/director/82_changelog/v1.11.0/82-1.11.0-02-wrap_startup_log_lines.png)

Performance has greatly been improved for those, who trigger a lot of single API
requests, instead of relying on Import/Sync mechanism. Our template usage overview
now also summarizes and links objects used in Services belonging to Service Sets:

![Template Usage overview](screenshot/director/82_changelog/v1.11.0/82-1.11.0-03-template_usage.png)

This version hasn't been released yet
Commands can now be cloned with their field definitions, and custom variables
from set_if flags make now part of the "suggested fields" list.

In addition to major refactoring and technical improvements related to our
configuration baskets, it's now also possible to upload additional snapshots for
existing baskets:

![Basket Snapshot upload](screenshot/director/82_changelog/v1.11.0/82-1.11.0-04-upload_basket_snapshot.png)

Speaking of baskets, they have been reworked in a way giving especially Icinga
Partners and Plugin authors more control over related objects. As UUIDs are now
supported in Baskets too, it is for example possible to rename an object with a
new Basket Snapshot.

### Breaking Changes
* Module and system dependencies have been raised, [Upgrading](05-Upgrading.md)
and [Installation](02-Installation.md) documentations contain related details

### UI
* FEATURE: allow to clone commands with fields (#2264)
Expand All @@ -18,16 +79,19 @@ This version hasn't been released yet
* FEATURE: Branch and Sync diff/preview now shows related host for services (#2736)
* FEATURE: Show more details for assign filter parsing errors (#2667)
* FEATURE: Fields from set_if are now being proposed (#514)
* FEATURE: Template usage table now shows Set members (#2378)
* FIX: do not fail for (some) Service Dependencies (#2669, #1142)
* FIX: Service Sets can now be searched by Service name in branches too (#2738)
* FIX: Template usage table had no header (#2780)
* FIX: Strikethrough for deactivated services in applied Service Set (#2746, #2766)
* FIX: editing multi-selected services with the same name has been fixed (#2798)
* FIX: editing multi-selected services with the same name has been fixed (#2798, 2801, #2599)
* FIX: Service Sets table with PostgreSQL (#2799)
* FIX: Dark mode for some clone forms (#2670)

### Icinga Configuration
* FEATURE: render fallback template for IfW 1.11 for Icinga &lt; 2.14 (#2776)
* FEATURE: render host templates to all non-global zones per default (#2410)
* FEATURE: notifications can pick user(groups) from host/service vars (#462)
* FIX: render Set Services to individual zones where required (#1589, #2356)
* FIX: special characters like &amp; and | caused trouble in filters (#2667)

Expand All @@ -41,13 +105,16 @@ This version hasn't been released yet
* FIX: Import Source shows available columns for Core API Import (#2763)
* FIX: JSON-decode now explicitly fails for non-string inputs (#2810)

### Integrations
* FIX: don't throw an error, when editing a Service via IcingaDB link (#2533, #2563)

# Configuration Baskets
* FEATURE: it's now possible to upload snapshots for existing baskets (#1952)
* FIX: basket now shows where to expect changes for lists from snapshots (#2791)
* FIX: Icinga DSL parts for Commands are now restored from Baskets (#2811)

### REST API
* FIX: Commands give 304 w/o ghost changes for same properties (#2660)
* FIX: Commands give 204 w/o ghost changes for same properties (#2660)

### Permissions and Restrictions
* FIX: monitoring-related permission checks have been refactored (#2712)
Expand All @@ -63,9 +130,11 @@ This version hasn't been released yet
* FIX: complaint about overdue jobs was not correct (#2680, #2681)

### Internals
* FEATURE: support PHP 8.2 (#2777, #2792)
* FEATURE: Unit Tests are now being triggered as GitHub workflows (no issue)
* FIX: group membership is no longer resolved when not needed (#2048)
* FIX: require Auth object for all object tables (#2808)
* FEATURE: support PHP 8.2 (#2777, #2792)
* FIX: group membership is no longer resolved when not needed (#2048)

### Fixed issues
* You can find issues and feature requests related to this release on our
Expand Down
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
2 changes: 1 addition & 1 deletion module.info
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
Name: Icinga Director
Version: master
Version: 1.11.0
Depends: reactbundle (>=0.9.0), ipl (>=0.5.0), incubator (>=0.20.0)
Description: Director - Config tool for Icinga 2
Icinga Director is a configuration tool that has been designed to make
Expand Down

0 comments on commit a6f0a08

Please sign in to comment.