[stork-users] Stork 1.9.0 is now available
Peter Davies
peterd at isc.org
Wed Feb 1 10:38:23 UTC 2023
Stork 1.9.0 is a new development release of the Stork dashboard for
monitoring Kea servers.
The easiest way to install the software is to use native deb or RPM
packages. They can be downloaded from:
https://cloudsmith.io/~isc/repos/stork/
The Stork source and PGP signature for this release may be downloaded from:
https://www.isc.org/download#Stork
Documentation for Stork is available at:
https://stork.readthedocs.io
-----
# Stork 1.9.0 Release Notes, February 1st 2023
Welcome to Stork 1.9.0, another development release. The changes
introduced in this version are:
1. **Kea Configuration Management**: Stork now recognizes the formats of
standard DHCP options. For each option specified for a host reservation,
it automatically opens a form with the appropriate option fields; the
user no longer needs to manually add option fields unless the option
carries an array of fields. In this case, the first field of the array
is automatically added, and the remaining array fields (if any) must be
added manually [#912, #937]. DHCPv4 fixed fields are now supported in
reservations [#911]. The design is now complete [#599]. The subnet-id
information is now displayed on the subnets list page [#376].
2. **User deletion**: Users can now be deleted by super-admins. It is
not possible to delete the last super-admin, as a safety net [#117].
3. **PD pools**: Stork is now able to handle Prefix Delegation pools
[#186]. The address and PD pools are now updated properly [#196, #927].
4. **Logging levels**: Stork now has configurable logging levels -
DEBUG, INFO, WARN and ERROR - that can be specified using the
STORK_LOG_LEVEL variable [#870].
5. **Bugfixes**: It is now possible to delete machines with config
reports [#928]. The HA state no longer disappears when switching between
tabs [#448]. Communication events are now bound to the machine and will
be listed/filtered properly [#882]. Fixed an old migration (13) to
handle situations where migrating shared networks could crash the server
[#196]. Daemon statuses are no longer duplicated when a machine runs
multiple daemons [#900]. Improved icons to filter the config checkers
reports [#916].
6. **Build improvements**: The demo now builds properly [#960].
Shellcheck linter for shell scripts is now part of the CI checks [#876].
Manual pages are now properly included in the native packages [#913].
Storybook, a developer tool, has been downgraded to 6.5.12 [#926]. Fixed
one unstable test [#916].
7. **Security**: Many dependencies have been updated, to address known
security vulnerabilities [#934]. The CI now uses CodeQL (a replacement
for the LGTM service) to assess code correctness [#946]. The go linter
now refuses new go functions without comments. Missing comments for
existing functions were added [#906]. Govulncheck, a vulnerability
checker, is now used to review used third-party libraries against known
vulnerabilities [#861].
Please see this link for known issues:
https://gitlab.isc.org/isc-projects/stork/-/wikis/Known-issues.
## Incompatible Changes
None.
## Release Model
Stork has bi-monthly development releases, with some exceptions.
We encourage users to test the development releases and report back
their findings on the stork-users mailing list, available at
https://lists.isc.org/mailman/listinfo/stork-users.
This text references issue numbers. For more details, visit the Stork
GitLab page at https://gitlab.isc.org/isc-projects/stork/issues.
## License
Stork is released under the Mozilla Public License, version 2.0.
https://www.mozilla.org/en-US/MPL/2.0
## Download
The easiest way to install the software is to use native deb or RPM
packages. They can be downloaded from:
https://cloudsmith.io/~isc/repos/stork/
The Stork source and PGP signature for this release may be downloaded
from:
https://downloads.isc.org/isc/stork
The signature was generated with the ISC code-signing key, which is
available at:
https://www.isc.org/pgpkey
ISC provides documentation in the Stork Administrator Reference Manual
(ARM). It is available on ReadTheDocs.io at
https://stork.readthedocs.io/en/latest/, and in source form in [the doc/
directory](https://gitlab.isc.org/isc-projects/stork/-/tree/master/doc).
We ask users of this software to please let us know how it worked for
you and what operating system you tested on. Feel free to share your
feedback on the stork-users mailing list
(https://lists.isc.org/mailman/listinfo/stork-users). We would also like
to hear whether the documentation is adequate and accurate. Please open
tickets in the Stork GitLab project for bugs, documentation omissions
and errors, and enhancement requests. We want to hear from you even if
everything worked.
## Support
Free best-effort support is provided by our user community via a mailing
list. Information on all public email lists is available at
https://www.isc.org/mailinglists/. If you have any comments or questions
about working with Stork, please share them to the stork-users list
(https://lists.isc.org/mailman/listinfo/stork-users). Bugs and feature
requests may be submitted via GitLab at
https://gitlab.isc.org/isc-projects/stork/issues.
## Changes
The following summarizes changes and important upgrades since the
previous Stork release versioned 1.8.0.
* 277 [bug] slawek
Fixed a bug that prevented the machines from deleting.
(Gitlab #928)
* 276 [func] razvan
Added functionality for deleting users. A super-admin cannot remove
its own account and the last super-admin user cannot be removed.
(Gitlab #117)
* 275 [bug] slawek
Fixed the security vulnerabilities reported by the Github Dependabot
and
updated some dependencies. Added some Rake tasks for updating the
project
dependencies. Upgraded the target JavaScript version of the
output UI bundle to be ES2020 standard-compliant.
(Gitlab #934)
* 274 [bug] slawek
Fixed detecting changes in the subnets' configuration. Stork now
recognizes
modifications of the subnet's client class, address pools, and
delegated
prefix pools.
(Gitlab #927)
* 273 [func] marcin
DHCP option form automatically shows controls suitable for the
selected
standard option definition. Previously, a user had to know the option
format and manually add option field controls.
(Gitlab #937)
* 272 [func] tomek
Stork agent, server and tool now have logging levels configurable
using
STORK_LOG_LEVEL environment variable. The allowed values are:
DEBUG, INFO, WARN, ERROR.
(Gitlab #870)
* 271 [bug] slawek
Added a waiting indicator presented while loading the HA servers'
statuses.
Previously, an inappropriate message about missing HA configuration
was
displayed.
(Gitlab #448)
* 270 [func] slawek
Extended the UI to display the delegated prefix pools and their
utilizations.
(Gitlab #186)
* 269 [build] slawek
Added missing comments for all exported functions and enabled a
linter
rule to make them mandatory.
(Gitlab #906)
* 268 [func] slawek
The subnet ID presents a value from the Kea configuration instead of
the internal Stork database ID.
(Gitlab #376)
* 267 [build] slawek
Added govulncheck to the Stork build system, a tool to detect
security
vulnerabilities on the backend.
(Gitlab #861)
* 266 [bug] slawek
The events pertaining to the daemons and apps can be filtered by the
machines running these daemons and apps. Previously, filtering by a
specific machine or an app did not return some events related to
daemons.
(Gitlab #882)
* 265 [bug] slawek
Fixed the database migration that interrupted the schema upgrade if
the
database contained any shared networks.
(Gitlab #196)
* 264 [func] marcin
Added configuration of the DHCPv4 siaddr, sname, and file fields in
the
Kea host reservations.
(Gitlab #911)
* 263 [build] andrei
Added the lint:shell rake task which calls shellcheck on all shell
scripts.
Added a CI step that calls this linter. Improved the shell scripts to
appease the shellcheck warnings.
(Gitlab #876)
* 262 [bug] slawek
Removed duplicated statuses of daemons on the machine page when the
machine runs multiple applications.
(Gitlab #900)
* 261 [build] slawek
Fixed the missing man pages for Stork programs installed by packages.
(Gitlab #913)
Thank you again to everyone who assisted us in making this release
possible.
We look forward to receiving your feedback.
More information about the Stork-users
mailing list