conversions were done using https://github.com/pennae/nix-doc-munge using (probably) rev f34e145 running nix-doc-munge nixos/**/*.nix nix-doc-munge --import nixos/**/*.nix the tool ensures that only changes that could affect the generated manual *but don't* are committed, other changes require manual review and are discarded.
159 lines
4.2 KiB
Nix
159 lines
4.2 KiB
Nix
{ config, lib, pkgs, ... }:
|
|
|
|
with lib;
|
|
|
|
let
|
|
|
|
cfg = config.services.nats;
|
|
|
|
format = pkgs.formats.json { };
|
|
|
|
configFile = format.generate "nats.conf" cfg.settings;
|
|
|
|
in {
|
|
|
|
### Interface
|
|
|
|
options = {
|
|
services.nats = {
|
|
enable = mkEnableOption (lib.mdDoc "NATS messaging system");
|
|
|
|
user = mkOption {
|
|
type = types.str;
|
|
default = "nats";
|
|
description = lib.mdDoc "User account under which NATS runs.";
|
|
};
|
|
|
|
group = mkOption {
|
|
type = types.str;
|
|
default = "nats";
|
|
description = lib.mdDoc "Group under which NATS runs.";
|
|
};
|
|
|
|
serverName = mkOption {
|
|
default = "nats";
|
|
example = "n1-c3";
|
|
type = types.str;
|
|
description = lib.mdDoc ''
|
|
Name of the NATS server, must be unique if clustered.
|
|
'';
|
|
};
|
|
|
|
jetstream = mkEnableOption (lib.mdDoc "JetStream");
|
|
|
|
port = mkOption {
|
|
default = 4222;
|
|
type = types.port;
|
|
description = lib.mdDoc ''
|
|
Port on which to listen.
|
|
'';
|
|
};
|
|
|
|
dataDir = mkOption {
|
|
default = "/var/lib/nats";
|
|
type = types.path;
|
|
description = lib.mdDoc ''
|
|
The NATS data directory. Only used if JetStream is enabled, for
|
|
storing stream metadata and messages.
|
|
|
|
If left as the default value this directory will automatically be
|
|
created before the NATS server starts, otherwise the sysadmin is
|
|
responsible for ensuring the directory exists with appropriate
|
|
ownership and permissions.
|
|
'';
|
|
};
|
|
|
|
settings = mkOption {
|
|
default = { };
|
|
type = format.type;
|
|
example = literalExpression ''
|
|
{
|
|
jetstream = {
|
|
max_mem = "1G";
|
|
max_file = "10G";
|
|
};
|
|
};
|
|
'';
|
|
description = lib.mdDoc ''
|
|
Declarative NATS configuration. See the
|
|
[
|
|
NATS documentation](https://docs.nats.io/nats-server/configuration) for a list of options.
|
|
'';
|
|
};
|
|
};
|
|
};
|
|
|
|
### Implementation
|
|
|
|
config = mkIf cfg.enable {
|
|
services.nats.settings = {
|
|
server_name = cfg.serverName;
|
|
port = cfg.port;
|
|
jetstream = optionalAttrs cfg.jetstream { store_dir = cfg.dataDir; };
|
|
};
|
|
|
|
systemd.services.nats = {
|
|
description = "NATS messaging system";
|
|
wantedBy = [ "multi-user.target" ];
|
|
after = [ "network.target" ];
|
|
|
|
serviceConfig = mkMerge [
|
|
(mkIf (cfg.dataDir == "/var/lib/nats") {
|
|
StateDirectory = "nats";
|
|
StateDirectoryMode = "0750";
|
|
})
|
|
{
|
|
Type = "simple";
|
|
ExecStart = "${pkgs.nats-server}/bin/nats-server -c ${configFile}";
|
|
ExecReload = "${pkgs.coreutils}/bin/kill -HUP $MAINPID";
|
|
ExecStop = "${pkgs.coreutils}/bin/kill -SIGINT $MAINPID";
|
|
Restart = "on-failure";
|
|
|
|
User = cfg.user;
|
|
Group = cfg.group;
|
|
|
|
# Hardening
|
|
CapabilityBoundingSet = "";
|
|
LimitNOFILE = 800000; # JetStream requires 2 FDs open per stream.
|
|
LockPersonality = true;
|
|
MemoryDenyWriteExecute = true;
|
|
NoNewPrivileges = true;
|
|
PrivateDevices = true;
|
|
PrivateTmp = true;
|
|
PrivateUsers = true;
|
|
ProcSubset = "pid";
|
|
ProtectClock = true;
|
|
ProtectControlGroups = true;
|
|
ProtectHome = true;
|
|
ProtectHostname = true;
|
|
ProtectKernelLogs = true;
|
|
ProtectKernelModules = true;
|
|
ProtectKernelTunables = true;
|
|
ProtectProc = "invisible";
|
|
ProtectSystem = "strict";
|
|
ReadOnlyPaths = [ ];
|
|
ReadWritePaths = [ cfg.dataDir ];
|
|
RestrictAddressFamilies = [ "AF_INET" "AF_INET6" ];
|
|
RestrictNamespaces = true;
|
|
RestrictRealtime = true;
|
|
RestrictSUIDSGID = true;
|
|
SystemCallFilter = [ "@system-service" "~@privileged" "~@resources" ];
|
|
UMask = "0077";
|
|
}
|
|
];
|
|
};
|
|
|
|
users.users = mkIf (cfg.user == "nats") {
|
|
nats = {
|
|
description = "NATS daemon user";
|
|
isSystemUser = true;
|
|
group = cfg.group;
|
|
home = cfg.dataDir;
|
|
};
|
|
};
|
|
|
|
users.groups = mkIf (cfg.group == "nats") { nats = { }; };
|
|
};
|
|
|
|
}
|