v2024.0.0-alpha.2

Changelog

Added

• core/apps/cockpit now provides a drop-in config file for reverse-proxying (see the notes on additions to core/host/cockpit)
• core/apps/planktoscope/node-red-dashboard now exports more config files needed for the Node-RED dashboard.
• core/host/cockpit now provides system services to automatically generate the Cockpit config file from a drop-in config directory, and it provides some default drop-in config files - including drop-in files provided by some new feature flags: allow-unencrypted, allow-origins-planktoscope-static-ips, allow-origins-planktoscope-legacy-mdns-names, allow-origins-planktoscope-mdns-names, allow-origins-templated-custom-domain-home, and allow-origins-templated-mdns-hostname
• Added a core/host/docker package which exports an override to the default systemd docker.service.
• core/host/machine-name (renamed from core/host/planktoscope/machine-name) now exports everything needed for automatically updating machine name-related configurations (machine name, hostname, SSID).
• core/host/machine-name: the dynamically-generated machine name can now be overridden by making a file with a desired static name at /etc/machine-name.
• core/host/machine-name: if deployed on a non-Raspberry Pi computer, generation of the machine name now uses /etc/machine-id as a substitute for the Raspberry Pi's serial number, instead of falling back to a placeholder like pkscope.
• core/host/machine-name: the prefix for the hostname (and the SSID and the Cockpit configuration), which was previously hard-coded, can now be manually changed by creating a hostname template file at /etc/hostname-template. A default hostname template of pkscope-{machine-name} is provided the new hostname-template-pkscope feature flag.
• core/host/networking/autohotspot now exports everything needed for autohotspot functionality.
• core/host/networking/avahi-daemon now provides two feature flags for registering the PlanktoScope under mDNS aliases planktoscope.local and pkscope.local, respectively: register-planktoscope-local and register-pkscope-local
• core/host/networking/dhcpcd now exports an override to the default systemd dhcpcd.service.
• core/host/networking/dnsmasq now exports various drop-in config files for dnsmasq and adds a few new feature flags: planktoscope-dhcp-interfaces, to add another drop-in config file for dnsmasq based on the PlanktoScope OS's static IP address assignments for its various network interfaces; custom-domain, to add drop-in config file template for dnsmasq which uses the custom domain (newly configurable at /etc/custom-domain) for dnsmasq; and planktoscope-custom-domain, which provides a /etc/custom-domain file to set the custom domain to pkscope.
• core/host/networking/hostapd now provides system services to automatically generate the hostapd config file from a drop-in config directory, and it provides some default drop-in config files - including drop-in files provided by some new feature flags: interface-wlan0, localization-us, planktoscope-password, ssid-hostname
• core/host/networking/hosts now provides system services to automatically generate the hosts file from a drop-in config directory, and it provides some default drop-in config files - including hostnames previously provided by the Raspberry Pi OS, and also drop-in files provided by some new feature flags: planktoscope-custom-domain-home and planktoscope-domain-machine-name
• core/host/networking/interface-forwarding now exports everything needed for interface-forwarding functionality.
• core/host/planktoscope/gpio-init now exports everything needed for GPIO-initialization functionality.
• core/host/planktoscope/gpsd now exports all config files needed to support the GPS module (still no guarantee whether the files are actually correct, though!).
• core/host/sshd adds two feature flags: ssh-server-enabled to enable the ssh.service and ensure-ssh-host-keys to add and enable a service which automatically regenerates host keys for the SSH server if no host keys exist at boot.

Changed

• (Breaking change) The minimum supported Forklift version for using this repository has been bumped from v0.4.0 to v0.7.0, because some packages provided by this repository now require functionality added by v0.7.0 (namely, file-exporting functionality) in order to work as described/expected.
• (Breaking change) community/apps/portainer was previously named core/apps/portainer; it's been moved out of core, as its default inclusion in the PlanktoScope OS is deprecated in v2024.0.0 of the PlanktoScope OS; in the future, the user will have to manually add this package to their custom pallet if they want to add Portainer.
• (Breaking change) core/host/machine-name was previously named core/host/planktoscope/machine-name; it's been renamed, as it can now be configured (via feature flags) without PlanktoScope-specific naming.
• (Breaking change) core/host/machine-name: the machine name is now generated at /run/machine-name rather than /var/lib/planktoscope/machine-name. however, a symlink is now exported to redirect /var/lib/planktoscope/machine-name to /run/machine-name, for backwards-compatibility with programs still expecting /var/lib/planktoscope/machine-name.
• (Breaking change) core/host/machine-name: automatic updating of the hostname based on the machine name is no longer default behavior, but rather has to be enabled with a new generate-templated-hostname feature flag. If a hostname template is unspecified, the default hostname template is now machine-{machine-name} instead of pkscope-{machine-name}.
• (Breaking change) core/host/machine-name: inclusion of a pkscope- prefix for the hostname (and the SSID and the Cockpit configuration) is no longer default behavior, but rather has to be enabled with a new hostname-prefix-pkscope feature flag.
• (Breaking change) core/host/networking/dnsmasq: use of pkscope as the custom domain is no longer default behavior, but rather has to be enabled with a new planktoscope-custom-domain feature flag.
• (Breaking change) core/host/networking/hostapd: various settings are no longer provided by default, but rather have to be enabled with the new interface-wlan0, localization-us, planktoscope-password, and ssid-hostname feature flags.
• (Breaking change) core/host/networking/hosts: hostnames involving the custom domain (e.g. pkscope) are no longer added by default, but rather have to be enabled with a new planktoscope-custom-domain-homeandplanktoscope-custom-domain-machine-name` feature flags.
• (Breaking change) Previously, the default behavior of the segmenter provided by core/apps/planktoscope/device-backend/processing/segmenter was to subtract consecutive masks to try to mitigate image-processing issues with objects which get stuck to the flowcell during imaging. However, when different objects occupied the same space in consecutive frames, the subtraction behavior would subtract one object's mask from the mask of the other object in the following frame, which would produce clearly incorrect masks. This behavior is no longer enabled by default; in order to re-enable it, you should enable the pipeline-subtract-consecutive-masks feature flag.
• All packages in core/apps which use the alpine container image have upgraded it from v3.19.0 to v3.19.1.
• core/apps/dozzle: the amir20/dozzle container image is upgraded from v6.0.6 to v6.5.1.
• core/apps/grafana: the grafana/grafana-oss container image is upgraded from v10.1.6 to v10.4.2.
• core/apps/planktoscope/device-portal: the device-portal container image is upgraded from v0.1.15 to v0.2.1.
• core/infra/caddy-ingress: the lucaslorentz/caddy-docker-proxy container image is upgraded from v2.8.10 to v2.8.11.
• core/infra/prometheus: the prom/prometheus container image is upgraded from v2.48.1 to v2.51.2.
• core/host/networking/interface-forwarding has a slightly simpler network configuration, and now all packets for the PlanktoScope's static IP addresses (e.g. 192.168.4.1, 192.168.5.1, 192.168.6.1, etc.) are routed to 127.0.0.1 regardless of whether the packet for that IP address came from the interface corresponding to it.

Deprecated

• In the future, core/host/planktoscope/machine-name will remove support for looking up the machine name from /var/lib/planktoscope/machine-name; instead, only /run/machine-name will be supported.

Removed

• core/apps/cockpit no longer has a resource dependency on a fileset involving /etc/cockpit/cockpit.conf.
• (Breaking change) core/host/planktoscope/machine-name no longer provides functionality to automatically update the Cockpit config based on the machine name. Instead, core/host/cockpit provides templating functionality to automatically update the Cockpit config, and the machine name and hostname can be interpolated into those templates.
• (Breaking change) core/host/exim is no longer provided, as exim was only provided by a Cockpit extension (cockpit-storaged) which is no longer installed by default on the PlanktoScope OS.

Pull Requests

• Add Dozzle by @ethanjli in #2
• Add packages for Prometheus metrics by @ethanjli in #3
• Split up Grafana features, improve dependency relationships by @ethanjli in #4
• Add scripts and local config files from the PlanktoScope distro by @ethanjli in #5
• Provision dhcpcd config file by @ethanjli in #6
• Make the backend segmenter package deploy as a Docker container by @ethanjli in #7
• Bump Python segmenter by @ethanjli in #8
• Provide config files for the base OS layer by @ethanjli in #9
• Bump container images by @ethanjli in #10

Full Changelog: v2023.9.0...v2024.0.0-alpha.2