[stork-users] Stork 1.13.0 is now available
Peter Davies
peterd at isc.org
Thu Oct 12 08:43:45 UTC 2023
Stork 1.13.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.13.0 Release Notes, October 11, 2023
Welcome to Stork 1.13.0, another development release. The changes
introduced in this version are:
1. **Subnet management**: We have reached an important milestone in the
long-term goal of managing Kea configuration in Stork: it is now
possible to edit many properties of subnets configured in Kea servers.
If a subnet is configured in several Kea servers, the configuration can
be applied to all of them. It is also possible to specify different
values for selected subnet parameters for each server. However, the
ability to manage pools is not yet supported. The subnet management
feature was tested, but due to its complexity should be used with
caution. Feedback is appreciated [#958]. REST API calls to update an
existing subnet were implemented [#957]. We fixed a problem with subnet,
network, host, and possibly other tabs not being shown [#1176].
2. **LDAP hook**: One of the technical features that has made Kea a
successful project - the ability to load external libraries - is coming
to Stork. Stork now has the ability to load extensions. The hooks
concept makes it much easier to implement complex, optional features,
make them available to users who need them, and avoid complicating
deployments for users who don't. The first hook to take advantage of
this capability is a Lightweight Directory Access Protocol (LDAP) hook.
If loaded, it allows the server to use LDAP to authenticate Stork users
[#638]. A build pipeline for the LDAP hook was created [#1178]. The hook
README was updated [#1183]. The logic was updated to not use the
directory name in the hook filenames [#1184]. An experiment with
`-trimpath` compiler flag was completed [#1182, #1188]. Support for a
common hook prefix was implemented [#1180].
3. **ARM support**: Starting with this release, Stork is now officially
supported on the ARM architecture. This includes the ability to build
from sources as well as native deb and RPM packages [#472, #893, #1113].
4. **BIND improvements**: Stork agent is now better able to handle BIND
deployments that use the chroot mechanism [#974].
5. **Security**: We have ended the use of self-signed certs by the Stork
agent during registration to prevent cert validation errors by the Stork
server, which expects trusted certs [#1154]. The govulncheck task now
uses version guard in the Rakefile [#1116]. We updated several
dependencies, as reported by dependabot [#1142].
6. **Build improvements**: the NPM version has been updated [#809]. A
Docker base image for CI tasks has been prepared [#846]. We removed
golang mock as it is no longer supported [#1117]. Better support for
recent PostgreSQL releases has been added [#897, #1148]. The Ubuntu
version used in the Stork demo has been updated [#689]. The API mock
files are now generated with proper names [#1136]. The Kea version was
updated in the demo, and the system tests version parsing was improved
[#995].
7. **Bug fixes**: A misleading message in the review panel was
corrected. The number of issues found is now clearly shown [#1131]. We
fixed misaligned icons after a PrimeNG upgrade [#1014]. The traffic
simulator, a part of the Stork demo, is working again [#1128]. Shared
network statistic counter summaries have been corrected [#1135]. We
fixed an issue whereby typing the appId or subnetId in the subnets
filtering field resulted in wiping this field [#1140]. The shared
networks are now clickable in the dashboard [#1133]. The agent-kea6 in
the demo was fixed [#1156].
8. **Documentation**: The README and AUTHORS files were updated
[#1125,#1126]. The incompatible changes are now marked with exclamation
points in the changelog [#1143]. We have clarified the documentation to
explain that the setup script is not available for Alpine [#1137].
Please see this link for known issues:
https://gitlab.isc.org/isc-projects/stork/-/wikis/Known-issues.
## Incompatible Changes
There are no incompatible changes in this release.
## 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, version 1.12.0.
* 340 [build] slawek
Added Rake and CI tasks to build, test, package, and upload the Stork
hooks.
(Gitlab #1178)
* 339 [build] marcin
Downgraded PrimeNG to avoid the bug with dynamic tab menu. See
PrimeNG
issue #13609.
(Gitlab #1176)
* 338 [func] slawek
Support for a new hook naming convention. The server-specific hooks
should
use the "stork-server-" prefix (e.g., stork-server-ldap.so).
(Gitlab #1180)
* 337 [bug] slawek
The agent no longer includes the TLS credentials in the requests
sent to
the server. Including them caused TLS verification errors during
agent
re-registration.
(Gitlab #1154)
* 336 [bug] slawek
Fix displaying statistics of the IPv4 shared networks.
(Gitlab #1135)
* 335 [func] marcin
Implemented a form for updating selected subnet parameters.
(Gitlab #957, #958)
* 334 [bug] slawek
Fixed the minor filtration issues on hosts, subnets and shared
networks
pages.
(Gitlab #1140)
* 333 [func] slawek
Added support for BIND 9 running in the chroot mode.
(Gitlab #974)
* 332 [func] slawek
Added support for Postgres 15+. System tests now run on Postgres 16.
Updated the docs to recommend granting all privileges on the public
schema
for the Stork user to avoid problems with some Postgres 15 (and
above)
installations.
(Gitlab #1148)
* 331 [build] slawek
Fixed the security vulnerabilities reported by the Github Dependabot
and
updated dependencies including the Go 1.21, Angular 16, PrimeNG,
GoSwagger,
OpenAPI Generator and several Python and Ruby packages.
(Gitlab #1142)
* 330 [bug] slawek
Fixed the problem of missing issues count in the configuration
review panel
header when the number of issues was zero. It resulted in a confusing
message suggesting that some issues were found.
(Gitlab #1131, #1141)
* 329 [build] slawek
Updated the dependency versions used in the CI.
(Gitlab #689)
* 328 [bug] razvan
Fix alignment of some UI components (spinner, help tip component).
(Gitlab #1014)
* 327 [func] slawek
Links to IPv6 shared networks on the dashboard.
(Gitlab #1133)
* 326 [build] slawek
Added support for building Stork components on the ARM architecture.
Added
support for an experimental cross-compilation for arbitrary
platforms.
(Gitlab #381, #472, #893, #1113)
* 325 [doc] slawek
Removed the documentation section referring to the non-existing
Alpine
script on CloudSmith.
(Gitlab #1137)
* 324 [func] slawek
Added support for configuring the Stork server hooks.
(Gitlab #638)
* 323 [build] razvan
Updated Kea version to 2.4.0 in demo and system tests.
(Gitlab #995)
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