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.
101 lines
2.4 KiB
Nix
101 lines
2.4 KiB
Nix
{ config, lib, pkgs, ... }:
|
|
|
|
with lib;
|
|
|
|
let
|
|
cfg = config.services.shellhub-agent;
|
|
in
|
|
{
|
|
###### interface
|
|
|
|
options = {
|
|
|
|
services.shellhub-agent = {
|
|
|
|
enable = mkEnableOption (lib.mdDoc "ShellHub Agent daemon");
|
|
|
|
package = mkPackageOption pkgs "shellhub-agent" { };
|
|
|
|
preferredHostname = mkOption {
|
|
type = types.str;
|
|
default = "";
|
|
description = lib.mdDoc ''
|
|
Set the device preferred hostname. This provides a hint to
|
|
the server to use this as hostname if it is available.
|
|
'';
|
|
};
|
|
|
|
keepAliveInterval = mkOption {
|
|
type = types.int;
|
|
default = 30;
|
|
description = lib.mdDoc ''
|
|
Determine the interval to send the keep alive message to
|
|
the server. This has a direct impact of the bandwidth
|
|
used by the device.
|
|
'';
|
|
};
|
|
|
|
tenantId = mkOption {
|
|
type = types.str;
|
|
example = "ba0a880c-2ada-11eb-a35e-17266ef329d6";
|
|
description = lib.mdDoc ''
|
|
The tenant ID to use when connecting to the ShellHub
|
|
Gateway.
|
|
'';
|
|
};
|
|
|
|
server = mkOption {
|
|
type = types.str;
|
|
default = "https://cloud.shellhub.io";
|
|
description = lib.mdDoc ''
|
|
Server address of ShellHub Gateway to connect.
|
|
'';
|
|
};
|
|
|
|
privateKey = mkOption {
|
|
type = types.path;
|
|
default = "/var/lib/shellhub-agent/private.key";
|
|
description = lib.mdDoc ''
|
|
Location where to store the ShellHub Agent private
|
|
key.
|
|
'';
|
|
};
|
|
};
|
|
};
|
|
|
|
###### implementation
|
|
|
|
config = mkIf cfg.enable {
|
|
|
|
systemd.services.shellhub-agent = {
|
|
description = "ShellHub Agent";
|
|
|
|
wantedBy = [ "multi-user.target" ];
|
|
requires = [ "local-fs.target" ];
|
|
wants = [ "network-online.target" ];
|
|
after = [
|
|
"local-fs.target"
|
|
"network.target"
|
|
"network-online.target"
|
|
"time-sync.target"
|
|
];
|
|
|
|
environment = {
|
|
SHELLHUB_SERVER_ADDRESS = cfg.server;
|
|
SHELLHUB_PRIVATE_KEY = cfg.privateKey;
|
|
SHELLHUB_TENANT_ID = cfg.tenantId;
|
|
SHELLHUB_KEEPALIVE_INTERVAL = toString cfg.keepAliveInterval;
|
|
SHELLHUB_PREFERRED_HOSTNAME = cfg.preferredHostname;
|
|
};
|
|
|
|
serviceConfig = {
|
|
# The service starts sessions for different users.
|
|
User = "root";
|
|
Restart = "on-failure";
|
|
ExecStart = "${cfg.package}/bin/agent";
|
|
};
|
|
};
|
|
};
|
|
}
|
|
|