151 lines
4.7 KiB
Nix
151 lines
4.7 KiB
Nix
# helm defines kubenix module with options for using helm charts with kubenix
|
|
# Copied from hall/kubenix
|
|
{
|
|
config,
|
|
lib,
|
|
pkgs,
|
|
helm,
|
|
...
|
|
}:
|
|
with lib;
|
|
let
|
|
cfg = config.helm;
|
|
in
|
|
{
|
|
options.helm = {
|
|
releases = mkOption {
|
|
description = "Attribute set of helm releases";
|
|
type = types.attrsOf (
|
|
types.submodule (
|
|
{ config, name, ... }:
|
|
{
|
|
options = {
|
|
name = mkOption {
|
|
description = "Helm release name";
|
|
type = types.str;
|
|
default = name;
|
|
};
|
|
|
|
chart = mkOption {
|
|
description = "Helm chart to use";
|
|
type = types.package;
|
|
};
|
|
|
|
namespace = mkOption {
|
|
description = "Namespace to install helm chart to";
|
|
type = types.nullOr types.str;
|
|
default = null;
|
|
};
|
|
|
|
values = mkOption {
|
|
description = "Values to pass to chart";
|
|
type = lib.types.anything;
|
|
default = { };
|
|
};
|
|
|
|
kubeVersion = mkOption {
|
|
description = "Kubernetes version to build chart for";
|
|
type = types.str;
|
|
# default = globalConfig.kubernetes.version;
|
|
default = "1.34.1";
|
|
};
|
|
|
|
overrides = mkOption {
|
|
description = "Overrides to apply to all chart resources";
|
|
type = types.listOf types.unspecified;
|
|
default = [ ];
|
|
};
|
|
|
|
overrideNamespace = mkOption {
|
|
description = "Whether to apply namespace override";
|
|
type = types.bool;
|
|
default = true;
|
|
};
|
|
|
|
includeCRDs = mkOption {
|
|
description = ''
|
|
Whether to include CRDs.
|
|
|
|
Warning: Always including CRDs here is dangerous and can break CRs in your cluster as CRDs may be updated unintentionally.
|
|
An interactive `helm install` NEVER updates CRDs, only installs them when they are not existing.
|
|
See https://github.com/helm/community/blob/aa8e13054d91ee69857b13149a9652be09133a61/hips/hip-0011.md
|
|
|
|
Only set this to true if you know what you are doing and are manually checking the included CRDs for breaking changes whenever updating the Helm chart.
|
|
'';
|
|
type = types.bool;
|
|
default = false;
|
|
};
|
|
|
|
noHooks = mkOption {
|
|
description = ''
|
|
Wether to include Helm hooks.
|
|
|
|
Without this all hooks run immediately on apply since we are bypassing the Helm CLI.
|
|
However, some charts only have minor validation hooks (e.g., upgrade version skew validation) and are safe to ignore.
|
|
'';
|
|
type = types.bool;
|
|
default = false;
|
|
};
|
|
|
|
apiVersions = mkOption {
|
|
description = ''
|
|
Inform Helm about which CRDs are available in the cluster (`--api-versions` option).
|
|
This is useful for charts which contain `.Capabilities.APIVersions.Has` checks.
|
|
If you use `kubernetes.customTypes` to make kubenix aware of CRDs, it will include those as well by default.
|
|
'';
|
|
type = types.listOf types.str;
|
|
default = [ ];
|
|
};
|
|
|
|
objects = mkOption {
|
|
description = "Generated kubernetes objects";
|
|
type = types.listOf types.attrs;
|
|
default = [ ];
|
|
};
|
|
};
|
|
|
|
config.overrides = mkIf (config.overrideNamespace && config.namespace != null) [
|
|
{
|
|
metadata.namespace = config.namespace;
|
|
}
|
|
];
|
|
|
|
config.objects = importJSON (
|
|
helm.chart2json {
|
|
inherit (config)
|
|
chart
|
|
name
|
|
namespace
|
|
values
|
|
kubeVersion
|
|
includeCRDs
|
|
noHooks
|
|
apiVersions
|
|
;
|
|
}
|
|
);
|
|
}
|
|
)
|
|
);
|
|
default = { };
|
|
};
|
|
};
|
|
|
|
config = {
|
|
kubernetes.resources = mkMerge (
|
|
flatten (
|
|
mapAttrsToList (
|
|
_: release:
|
|
map (object: {
|
|
${object.metadata.namespace or "none"}.${object.kind}."${object.metadata.name}" = mkMerge (
|
|
[
|
|
object
|
|
]
|
|
++ release.overrides
|
|
);
|
|
}) release.objects
|
|
) cfg.releases
|
|
)
|
|
);
|
|
};
|
|
}
|