depot/third_party/nixpkgs/nixos/doc/manual/release-notes/rl-1809.section.md

333 lines
15 KiB
Markdown
Raw Normal View History

# Release 18.09 ("Jellyfish", 2018/10/05) {#sec-release-18.09}
## Highlights {#sec-release-18.09-highlights}
In addition to numerous new and upgraded packages, this release has the following notable updates:
- End of support is planned for end of April 2019, handing over to 19.03.
- Platform support: x86_64-linux and x86_64-darwin as always. Support for aarch64-linux is as with the previous releases, not equivalent to the x86-64-linux release, but with efforts to reach parity.
- Nix has been updated to 2.1; see its [release notes](https://nixos.org/nix/manual/#ssec-relnotes-2.1).
- Core versions: linux: 4.14 LTS (unchanged), glibc: 2.26 → 2.27, gcc: 7 (unchanged), systemd: 237 → 239.
- Desktop version changes: gnome: 3.26 → 3.28, (KDE) plasma-desktop: 5.12 → 5.13.
Notable changes and additions for 18.09 include:
- Support for wrapping binaries using `firejail` has been added through `programs.firejail.wrappedBinaries`.
For example
```nix
{
programs.firejail = {
enable = true;
wrappedBinaries = {
firefox = "${lib.getBin pkgs.firefox}/bin/firefox";
mpv = "${lib.getBin pkgs.mpv}/bin/mpv";
};
};
}
```
This will place `firefox` and `mpv` binaries in the global path wrapped by firejail.
- User channels are now in the default `NIX_PATH`, allowing users to use their personal `nix-channel` defined channels in `nix-build` and `nix-shell` commands, as well as in imports like `import <mychannel>`.
For example
```ShellSession
$ nix-channel --add https://nixos.org/channels/nixpkgs-unstable nixpkgsunstable
$ nix-channel --update
$ nix-build '<nixpkgsunstable>' -A gitFull
$ nix run -f '<nixpkgsunstable>' gitFull
$ nix-instantiate -E '(import <nixpkgsunstable> {}).gitFull'
```
## New Services {#sec-release-18.09-new-services}
A curated selection of new services that were added since the last release:
- The `services.cassandra` module has been reworked and was rewritten from scratch. The service has succeeding tests for the versions 2.1, 2.2, 3.0 and 3.11 of [Apache Cassandra](https://cassandra.apache.org/).
- There is a new `services.foundationdb` module for deploying [FoundationDB](https://www.foundationdb.org) clusters.
- When enabled the `iproute2` will copy the files expected by ip route (e.g., `rt_tables`) in `/etc/iproute2`. This allows to write aliases for routing tables for instance.
- `services.strongswan-swanctl` is a modern replacement for `services.strongswan`. You can use either one of them to setup IPsec VPNs but not both at the same time.
`services.strongswan-swanctl` uses the [swanctl](https://wiki.strongswan.org/projects/strongswan/wiki/swanctl) command which uses the modern [vici](https://github.com/strongswan/strongswan/blob/master/src/libcharon/plugins/vici/README.md) _Versatile IKE Configuration Interface_. The deprecated `ipsec` command used in `services.strongswan` is using the legacy [stroke configuration interface](https://github.com/strongswan/strongswan/blob/master/README_LEGACY.md).
- The new `services.elasticsearch-curator` service periodically curates or manages, your Elasticsearch indices and snapshots.
Every new services:
- `./config/xdg/autostart.nix`
- `./config/xdg/icons.nix`
- `./config/xdg/menus.nix`
- `./config/xdg/mime.nix`
- `./hardware/brightnessctl.nix`
- `./hardware/onlykey.nix`
- `./hardware/video/uvcvideo/default.nix`
- `./misc/documentation.nix`
- `./programs/firejail.nix`
- `./programs/iftop.nix`
- `./programs/sedutil.nix`
- `./programs/singularity.nix`
- `./programs/xss-lock.nix`
- `./programs/zsh/zsh-autosuggestions.nix`
- `./services/admin/oxidized.nix`
- `./services/backup/duplicati.nix`
- `./services/backup/restic.nix`
- `./services/backup/restic-rest-server.nix`
- `./services/cluster/hadoop/default.nix`
- `./services/databases/aerospike.nix`
- `./services/databases/monetdb.nix`
- `./services/desktops/bamf.nix`
- `./services/desktops/flatpak.nix`
- `./services/desktops/zeitgeist.nix`
- `./services/development/bloop.nix`
- `./services/development/jupyter/default.nix`
- `./services/hardware/lcd.nix`
- `./services/hardware/undervolt.nix`
- `./services/misc/clipmenu.nix`
- `./services/misc/gitweb.nix`
- `./services/misc/serviio.nix`
- `./services/misc/safeeyes.nix`
- `./services/misc/sysprof.nix`
- `./services/misc/weechat.nix`
- `./services/monitoring/datadog-agent.nix`
- `./services/monitoring/incron.nix`
- `./services/networking/dnsdist.nix`
- `./services/networking/freeradius.nix`
- `./services/networking/hans.nix`
- `./services/networking/morty.nix`
- `./services/networking/ndppd.nix`
- `./services/networking/ocserv.nix`
- `./services/networking/owamp.nix`
- `./services/networking/quagga.nix`
- `./services/networking/shadowsocks.nix`
- `./services/networking/stubby.nix`
- `./services/networking/zeronet.nix`
- `./services/security/certmgr.nix`
- `./services/security/cfssl.nix`
- `./services/security/oauth2_proxy_nginx.nix`
- `./services/web-apps/virtlyst.nix`
- `./services/web-apps/youtrack.nix`
- `./services/web-servers/hitch/default.nix`
- `./services/web-servers/hydron.nix`
- `./services/web-servers/meguca.nix`
- `./services/web-servers/nginx/gitweb.nix`
- `./virtualisation/kvmgt.nix`
- `./virtualisation/qemu-guest-agent.nix`
## Backward Incompatibilities {#sec-release-18.09-incompatibilities}
When upgrading from a previous release, please be aware of the following incompatible changes:
- Some licenses that were incorrectly not marked as unfree now are. This is the case for:
- cc-by-nc-sa-20: Creative Commons Attribution Non Commercial Share Alike 2.0
- cc-by-nc-sa-25: Creative Commons Attribution Non Commercial Share Alike 2.5
- cc-by-nc-sa-30: Creative Commons Attribution Non Commercial Share Alike 3.0
- cc-by-nc-sa-40: Creative Commons Attribution Non Commercial Share Alike 4.0
- cc-by-nd-30: Creative Commons Attribution-No Derivative Works v3.00
- msrla: Microsoft Research License Agreement
- The deprecated `services.cassandra` module has seen a complete rewrite. (See above.)
- `lib.strict` is removed. Use `builtins.seq` instead.
- The `clementine` package points now to the free derivation. `clementineFree` is removed now and `clementineUnfree` points to the package which is bundled with the unfree `libspotify` package.
- The `netcat` package is now taken directly from OpenBSD's `libressl`, instead of relying on Debian's fork. The new version should be very close to the old version, but there are some minor differences. Importantly, flags like -b, -q, -C, and -Z are no longer accepted by the nc command.
- The `services.docker-registry.extraConfig` object doesn't contain environment variables anymore. Instead it needs to provide an object structure that can be mapped onto the YAML configuration defined in [the `docker/distribution` docs](https://github.com/docker/distribution/blob/v2.6.2/docs/configuration.md).
- `gnucash` has changed from version 2.4 to 3.x. If you've been using `gnucash` (version 2.4) instead of `gnucash26` (version 2.6) you must open your Gnucash data file(s) with `gnucash26` and then save them to upgrade the file format. Then you may use your data file(s) with Gnucash 3.x. See the upgrade [documentation](https://wiki.gnucash.org/wiki/FAQ#Using_Different_Versions.2C_Up_And_Downgrade). Gnucash 2.4 is still available under the attribute `gnucash24`.
- `services.munge` now runs as user (and group) `munge` instead of root. Make sure the key file is accessible to the daemon.
- `dockerTools.buildImage` now uses `null` as default value for `tag`, which indicates that the nix output hash will be used as tag.
- The ELK stack: `elasticsearch`, `logstash` and `kibana` has been upgraded from 2.\* to 6.3.\*. The 2.\* versions have been [unsupported since last year](https://www.elastic.co/support/eol) so they have been removed. You can still use the 5.\* versions under the names `elasticsearch5`, `logstash5` and `kibana5`.
The elastic beats: `filebeat`, `heartbeat`, `metricbeat` and `packetbeat` have had the same treatment: they now target 6.3.\* as well. The 5.\* versions are available under the names: `filebeat5`, `heartbeat5`, `metricbeat5` and `packetbeat5`
The ELK-6.3 stack now comes with [X-Pack by default](https://www.elastic.co/products/x-pack/open). Since X-Pack is licensed under the [Elastic License](https://github.com/elastic/elasticsearch/blob/master/licenses/ELASTIC-LICENSE.txt) the ELK packages now have an unfree license. To use them you need to specify `allowUnfree = true;` in your nixpkgs configuration.
Fortunately there is also a free variant of the ELK stack without X-Pack. The packages are available under the names: `elasticsearch-oss`, `logstash-oss` and `kibana-oss`.
- Options `boot.initrd.luks.devices.name.yubikey.ramfsMountPoint` `boot.initrd.luks.devices.name.yubikey.storage.mountPoint` were removed. `luksroot.nix` module never supported more than one YubiKey at a time anyway, hence those options never had any effect. You should be able to remove them from your config without any issues.
- `stdenv.system` and `system` in nixpkgs now refer to the host platform instead of the build platform. For native builds this is not change, let alone a breaking one. For cross builds, it is a breaking change, and `stdenv.buildPlatform.system` can be used instead for the old behavior. They should be using that anyways for clarity.
- Groups `kvm` and `render` are introduced now, as systemd requires them.
## Other Notable Changes {#sec-release-18.09-notable-changes}
- `dockerTools.pullImage` relies on image digest instead of image tag to download the image. The `sha256` of a pulled image has to be updated.
- `lib.attrNamesToStr` has been deprecated. Use more specific concatenation (`lib.concat(Map)StringsSep`) instead.
- `lib.addErrorContextToAttrs` has been deprecated. Use `builtins.addErrorContext` directly.
- `lib.showVal` has been deprecated. Use `lib.traceSeqN` instead.
- `lib.traceXMLVal` has been deprecated. Use `lib.traceValFn builtins.toXml` instead.
- `lib.traceXMLValMarked` has been deprecated. Use `lib.traceValFn (x: str + builtins.toXML x)` instead.
- The `pkgs` argument to NixOS modules can now be set directly using `nixpkgs.pkgs`. Previously, only the `system`, `config` and `overlays` arguments could be used to influence `pkgs`.
- A NixOS system can now be constructed more easily based on a preexisting invocation of Nixpkgs. For example:
```nix
{
inherit (pkgs.nixos {
boot.loader.grub.enable = false;
fileSystems."/".device = "/dev/xvda1";
}) toplevel kernel initialRamdisk manual;
}
```
This benefits evaluation performance, lets you write Nixpkgs packages that depend on NixOS images and is consistent with a deployment architecture that would be centered around Nixpkgs overlays.
- `lib.traceValIfNot` has been deprecated. Use `if/then/else` and `lib.traceValSeq` instead.
- `lib.traceCallXml` has been deprecated. Please complain if you use the function regularly.
- The attribute `lib.nixpkgsVersion` has been deprecated in favor of `lib.version`. Please refer to the discussion in [NixOS/nixpkgs\#39416](https://github.com/NixOS/nixpkgs/pull/39416#discussion_r183845745) for further reference.
- `lib.recursiveUpdateUntil` was not acting according to its specification. It has been fixed to act according to the docstring, and a test has been added.
- The module for `security.dhparams` has two new options now:
`security.dhparams.stateless`
: Puts the generated Diffie-Hellman parameters into the Nix store instead of managing them in a stateful manner in `/var/lib/dhparams`.
`security.dhparams.defaultBitSize`
: The default bit size to use for the generated Diffie-Hellman parameters.
::: {.note}
The path to the actual generated parameter files should now be queried using `config.security.dhparams.params.name.path` because it might be either in the Nix store or in a directory configured by `security.dhparams.path`.
:::
::: {.note}
**For developers:**
Module implementers should not set a specific bit size in order to let users configure it by themselves if they want to have a different bit size than the default (2048).
An example usage of this would be:
```nix
{ config, ... }:
{
security.dhparams.params.myservice = {};
environment.etc."myservice.conf".text = ''
dhparams = ${config.security.dhparams.params.myservice.path}
'';
}
```
:::
- `networking.networkmanager.useDnsmasq` has been deprecated. Use `networking.networkmanager.dns` instead.
- The Kubernetes package has been bumped to major version 1.11. Please consult the [release notes](https://github.com/kubernetes/kubernetes/blob/release-1.11/CHANGELOG-1.11.md) for details on new features and api changes.
- The option `services.kubernetes.apiserver.admissionControl` was renamed to `services.kubernetes.apiserver.enableAdmissionPlugins`.
- Recommended way to access the Kubernetes Dashboard is via HTTPS (TLS) Therefore; public service port for the dashboard has changed to 443 (container port 8443) and scheme to https.
- The option `services.kubernetes.apiserver.address` was renamed to `services.kubernetes.apiserver.bindAddress`. Note that the default value has changed from 127.0.0.1 to 0.0.0.0.
- The option `services.kubernetes.apiserver.publicAddress` was not used and thus has been removed.
- The option `services.kubernetes.addons.dashboard.enableRBAC` was renamed to `services.kubernetes.addons.dashboard.rbac.enable`.
- The Kubernetes Dashboard now has only minimal RBAC permissions by default. If dashboard cluster-admin rights are desired, set `services.kubernetes.addons.dashboard.rbac.clusterAdmin` to true. On existing clusters, in order for the revocation of privileges to take effect, the current ClusterRoleBinding for kubernetes-dashboard must be manually removed: `kubectl delete clusterrolebinding kubernetes-dashboard`
- The `programs.screen` module provides allows to configure `/etc/screenrc`, however the module behaved fairly counterintuitive as the config exists, but the package wasn't available. Since 18.09 `pkgs.screen` will be added to `environment.systemPackages`.
- The module `services.networking.hostapd` now uses WPA2 by default.
- `s6Dns`, `s6Networking`, `s6LinuxUtils` and `s6PortableUtils` renamed to `s6-dns`, `s6-networking`, `s6-linux-utils` and `s6-portable-utils` respectively.
- The module option `nix.useSandbox` is now defaulted to `true`.
- The config activation script of `nixos-rebuild` now [reloads](https://www.freedesktop.org/software/systemd/man/systemctl.html#Manager%20Lifecycle%20Commands) all user units for each authenticated user.
- The default display manager is now LightDM. To use SLiM set `services.xserver.displayManager.slim.enable` to `true`.
- NixOS option descriptions are now automatically broken up into individual paragraphs if the text contains two consecutive newlines, so it's no longer necessary to use `</para><para>` to start a new paragraph.
- Top-level `buildPlatform`, `hostPlatform`, and `targetPlatform` in Nixpkgs are deprecated. Please use their equivalents in `stdenv` instead: `stdenv.buildPlatform`, `stdenv.hostPlatform`, and `stdenv.targetPlatform`.