Skip to content

Built-ins

This page is for image authors and operators who want to know why a node refused a config, what a delivery reloads and restarts, or what chalkctl node diag runs. It lists the change rules, facts, validators, outputs, effects and diagnostics that chalkos's own modules declare: those of every image, and those that images with Kubernetes and router images add. An extension declares more with the Extension API, and its validators, outputs, effects and diagnostics take names other than these.

Change rules

A change rule refuses a config that breaks it before the node applies any of it. Guard changes with rules and facts describes how rules are written and where they run. Each table holds a kind's rules: the field a field rule sits on, or — for a kind rule, which sees all of the kind's documents; what the rule guards; what a change it refuses takes, refuse, reset or reinstall; the CEL expression, which holds for a config the rule accepts; and the message, or the CEL expression that builds it. An expression too long for its row follows the table.

Every image

The rules of the kinds every image accepts.

Registry

Rule Field Guards Takes Expression Message
1 — A Registry gives username and password together, or neither. refuse documents.all(n, (documents[n].spec.username == null) == (documents[n].spec.password == null)) after the table

Message of rule 1:

documents.filter(n, (documents[n].spec.username == null) != (documents[n].spec.password == null)).map(n, "Registry " + n).join(", ") + ": give username and password together, or neither to pull anonymously"

SystemDisk

Rule Field Guards Takes Expression Message
1 — VAR keeps its format, encryption and size; a larger VAR, or one that fills the disk, is accepted. reinstall after the table after the table

Expression of rule 1:

facts.recorded == null || !("var" in facts.recorded.volumes) || size(documents) != 1 || cel.bind(sd, documents.map(n, documents[n].spec)[0], cel.bind(r, facts.recorded.volumes["var"], size([r.format != "ext4" ? "format ext4 instead of " + (r.format == "" ? "none" : r.format) : "",
 ((sd.var.encryption.mode != null ? sd.var.encryption.mode : sd.encryption.mode) != r.encryption ? "encryption " + (sd.var.encryption.mode != null ? sd.var.encryption.mode : sd.encryption.mode) + " instead of " + r.encryption : ""),
 ((sd.var.size == null ? "" : sd.var.size) == r.size || (sd.var.size == null ? "" : sd.var.size) == "" ? "" : r.size == "" ? "size " + (sd.var.size == null ? "" : sd.var.size) + " instead of filling its disk" : bytes((sd.var.size == null ? "" : sd.var.size)) < bytes(r.size) ? "smaller: " + (sd.var.size == null ? "" : sd.var.size) + " instead of " + r.size : "")].filter(x, x != "")) == 0))

Message of rule 1:

cel.bind(sd, documents.map(n, documents[n].spec)[0], cel.bind(r, facts.recorded.volumes["var"], "VAR: " + [r.format != "ext4" ? "format ext4 instead of " + (r.format == "" ? "none" : r.format) : "",
 ((sd.var.encryption.mode != null ? sd.var.encryption.mode : sd.encryption.mode) != r.encryption ? "encryption " + (sd.var.encryption.mode != null ? sd.var.encryption.mode : sd.encryption.mode) + " instead of " + r.encryption : ""),
 ((sd.var.size == null ? "" : sd.var.size) == r.size || (sd.var.size == null ? "" : sd.var.size) == "" ? "" : r.size == "" ? "size " + (sd.var.size == null ? "" : sd.var.size) + " instead of filling its disk" : bytes((sd.var.size == null ? "" : sd.var.size)) < bytes(r.size) ? "smaller: " + (sd.var.size == null ? "" : sd.var.size) + " instead of " + r.size : "")].filter(x, x != "").join("; ") + "; only a reinstall of " + node.name + " carries it out"))

Volume

Rule Field Guards Takes Expression Message
1 — A volume stays on the disk it was created on: the system disk or a disk of its own. reinstall after the table after the table
2 — A disk reference that differs from the one the volume's disk was pinned by finds that disk. reinstall after the table after the table
3 — A disk reference that differs from the one the volume's disk was pinned by resolves. refuse after the table after the table
4 — A volume keeps its format and encryption, also the encryption it inherits from the SystemDisk, and does not shrink or take a fixed size where it filled its disk. reset after the table after the table
5 — The pinned disk of a volume that the config creates or changes is plugged in. refuse after the table after the table
6 — No volume the machine records is left out of the config. reinstall facts.recorded == null || facts.recorded.volumes.all(n, n == "var" || n in documents) after the table
7 — A new TPM2-encrypted volume, on a node with a fallback, comes with the fallback secret, which opens the node's fallback keyslot. refuse after the table after the table

Expression of rule 1:

facts.recorded == null || documents.all(n, cel.bind(v, documents[n].spec, cel.bind(sd, config["storage.chalkos.dev/v1alpha1"].SystemDisk.map(k, config["storage.chalkos.dev/v1alpha1"].SystemDisk[k].spec)[0], cel.bind(r, n in facts.recorded.volumes ? facts.recorded.volumes[n] : null, !(r != null && (v.disk == null ? "system" : n) != r.disk)))))

Message of rule 1:

documents.filter(n, cel.bind(v, documents[n].spec, cel.bind(sd, config["storage.chalkos.dev/v1alpha1"].SystemDisk.map(k, config["storage.chalkos.dev/v1alpha1"].SystemDisk[k].spec)[0], cel.bind(r, n in facts.recorded.volumes ? facts.recorded.volumes[n] : null, r != null && (v.disk == null ? "system" : n) != r.disk)))).map(n, cel.bind(v, documents[n].spec, cel.bind(sd, config["storage.chalkos.dev/v1alpha1"].SystemDisk.map(k, config["storage.chalkos.dev/v1alpha1"].SystemDisk[k].spec)[0], cel.bind(r, n in facts.recorded.volumes ? facts.recorded.volumes[n] : null, "Volume " + n + ": disk " + (v.disk == null ? "system" : n) + " instead of " + r.disk + "; only a reinstall of " + node.name + " carries it out")))).join("; ")

Expression of rule 2:

facts.recorded == null || documents.all(n, cel.bind(v, documents[n].spec, cel.bind(sd, config["storage.chalkos.dev/v1alpha1"].SystemDisk.map(k, config["storage.chalkos.dev/v1alpha1"].SystemDisk[k].spec)[0], cel.bind(r, n in facts.recorded.volumes ? facts.recorded.volumes[n] : null, !(v.disk != null && n in facts.disks && facts.disks[n].changed && facts.disks[n].error == "" && !facts.disks[n].same)))))

Message of rule 2:

documents.filter(n, cel.bind(v, documents[n].spec, cel.bind(sd, config["storage.chalkos.dev/v1alpha1"].SystemDisk.map(k, config["storage.chalkos.dev/v1alpha1"].SystemDisk[k].spec)[0], cel.bind(r, n in facts.recorded.volumes ? facts.recorded.volumes[n] : null, v.disk != null && n in facts.disks && facts.disks[n].changed && facts.disks[n].error == "" && !facts.disks[n].same)))).map(n, cel.bind(v, documents[n].spec, cel.bind(sd, config["storage.chalkos.dev/v1alpha1"].SystemDisk.map(k, config["storage.chalkos.dev/v1alpha1"].SystemDisk[k].spec)[0], cel.bind(r, n in facts.recorded.volumes ? facts.recorded.volumes[n] : null, "Volume " + n + ": disk reference " + facts.disks[n].ref + " resolves to " + facts.disks[n].found + ", but the volume lives on " + facts.disks[n].identity + "; only a reinstall of " + node.name + " carries it out")))).join("; ")

Expression of rule 3:

facts.recorded == null || documents.all(n, cel.bind(v, documents[n].spec, cel.bind(sd, config["storage.chalkos.dev/v1alpha1"].SystemDisk.map(k, config["storage.chalkos.dev/v1alpha1"].SystemDisk[k].spec)[0], cel.bind(r, n in facts.recorded.volumes ? facts.recorded.volumes[n] : null, !(v.disk != null && n in facts.disks && facts.disks[n].changed && facts.disks[n].error != "")))))

Message of rule 3:

documents.filter(n, cel.bind(v, documents[n].spec, cel.bind(sd, config["storage.chalkos.dev/v1alpha1"].SystemDisk.map(k, config["storage.chalkos.dev/v1alpha1"].SystemDisk[k].spec)[0], cel.bind(r, n in facts.recorded.volumes ? facts.recorded.volumes[n] : null, v.disk != null && n in facts.disks && facts.disks[n].changed && facts.disks[n].error != "")))).map(n, cel.bind(v, documents[n].spec, cel.bind(sd, config["storage.chalkos.dev/v1alpha1"].SystemDisk.map(k, config["storage.chalkos.dev/v1alpha1"].SystemDisk[k].spec)[0], cel.bind(r, n in facts.recorded.volumes ? facts.recorded.volumes[n] : null, "Volume " + n + ": disk reference " + facts.disks[n].ref + " cannot be resolved: " + facts.disks[n].error + "; "
+ (facts.disks[n].errorKind == "noDisk" ? "fix the disk reference or plug in the disk it names"
  : facts.disks[n].errorKind == "listDisks" ? "try again once the node can list its disks"
  : "fix the disk reference")
)))).join("; ")

Expression of rule 4:

facts.recorded == null || documents.all(n, cel.bind(v, documents[n].spec, cel.bind(sd, config["storage.chalkos.dev/v1alpha1"].SystemDisk.map(k, config["storage.chalkos.dev/v1alpha1"].SystemDisk[k].spec)[0], cel.bind(r, n in facts.recorded.volumes ? facts.recorded.volumes[n] : null, !(r != null && (v.disk == null ? "system" : n) == r.disk && !(v.disk != null && n in facts.disks && facts.disks[n].changed && facts.disks[n].error == "" && !facts.disks[n].same) && !(v.disk != null && n in facts.disks && facts.disks[n].changed && facts.disks[n].error != "") && size([(v.format == "raw" ? "" : v.format) != r.format ? "format " + ((v.format == "raw" ? "" : v.format) == "" ? "raw" : (v.format == "raw" ? "" : v.format)) + " instead of " + (r.format == "" ? "raw" : r.format) : "",
 ((v.encryption.mode != null ? v.encryption.mode : sd.encryption.mode) != r.encryption ? "encryption " + (v.encryption.mode != null ? v.encryption.mode : sd.encryption.mode) + " instead of " + r.encryption : ""),
 ((v.size == null ? "" : v.size) == r.size || (v.size == null ? "" : v.size) == "" ? "" : r.size == "" ? "size " + (v.size == null ? "" : v.size) + " instead of filling its disk" : bytes((v.size == null ? "" : v.size)) < bytes(r.size) ? "smaller: " + (v.size == null ? "" : v.size) + " instead of " + r.size : "")].filter(x, x != "")) > 0)))))

Message of rule 4:

documents.filter(n, cel.bind(v, documents[n].spec, cel.bind(sd, config["storage.chalkos.dev/v1alpha1"].SystemDisk.map(k, config["storage.chalkos.dev/v1alpha1"].SystemDisk[k].spec)[0], cel.bind(r, n in facts.recorded.volumes ? facts.recorded.volumes[n] : null, r != null && (v.disk == null ? "system" : n) == r.disk && !(v.disk != null && n in facts.disks && facts.disks[n].changed && facts.disks[n].error == "" && !facts.disks[n].same) && !(v.disk != null && n in facts.disks && facts.disks[n].changed && facts.disks[n].error != "") && size([(v.format == "raw" ? "" : v.format) != r.format ? "format " + ((v.format == "raw" ? "" : v.format) == "" ? "raw" : (v.format == "raw" ? "" : v.format)) + " instead of " + (r.format == "" ? "raw" : r.format) : "",
 ((v.encryption.mode != null ? v.encryption.mode : sd.encryption.mode) != r.encryption ? "encryption " + (v.encryption.mode != null ? v.encryption.mode : sd.encryption.mode) + " instead of " + r.encryption : ""),
 ((v.size == null ? "" : v.size) == r.size || (v.size == null ? "" : v.size) == "" ? "" : r.size == "" ? "size " + (v.size == null ? "" : v.size) + " instead of filling its disk" : bytes((v.size == null ? "" : v.size)) < bytes(r.size) ? "smaller: " + (v.size == null ? "" : v.size) + " instead of " + r.size : "")].filter(x, x != "")) > 0)))).map(n, cel.bind(v, documents[n].spec, cel.bind(sd, config["storage.chalkos.dev/v1alpha1"].SystemDisk.map(k, config["storage.chalkos.dev/v1alpha1"].SystemDisk[k].spec)[0], cel.bind(r, n in facts.recorded.volumes ? facts.recorded.volumes[n] : null, "Volume " + n + ": " + [(v.format == "raw" ? "" : v.format) != r.format ? "format " + ((v.format == "raw" ? "" : v.format) == "" ? "raw" : (v.format == "raw" ? "" : v.format)) + " instead of " + (r.format == "" ? "raw" : r.format) : "",
 ((v.encryption.mode != null ? v.encryption.mode : sd.encryption.mode) != r.encryption ? "encryption " + (v.encryption.mode != null ? v.encryption.mode : sd.encryption.mode) + " instead of " + r.encryption : ""),
 ((v.size == null ? "" : v.size) == r.size || (v.size == null ? "" : v.size) == "" ? "" : r.size == "" ? "size " + (v.size == null ? "" : v.size) + " instead of filling its disk" : bytes((v.size == null ? "" : v.size)) < bytes(r.size) ? "smaller: " + (v.size == null ? "" : v.size) + " instead of " + r.size : "")].filter(x, x != "").join("; ") + "; reset it with chalkctl storage reset " + node.name + " " + n)))).join("; ")

Expression of rule 5:

facts.recorded == null || documents.all(n, cel.bind(v, documents[n].spec, cel.bind(sd, config["storage.chalkos.dev/v1alpha1"].SystemDisk.map(k, config["storage.chalkos.dev/v1alpha1"].SystemDisk[k].spec)[0], cel.bind(r, n in facts.recorded.volumes ? facts.recorded.volumes[n] : null, !(v.disk != null && n in facts.disks && facts.disks[n].pinned && !facts.disks[n].present && (r == null || (v.format == "raw" ? "" : v.format) != r.format || (v.encryption.mode != null ? v.encryption.mode : sd.encryption.mode) != r.encryption || ((v.size == null ? "" : v.size) != r.size && !(isSize((v.size == null ? "" : v.size)) && isSize(r.size) && bytes((v.size == null ? "" : v.size)) == bytes(r.size))) || (v.mountPoint == null ? "" : v.mountPoint) != r.mountPoint))))))

Message of rule 5:

documents.filter(n, cel.bind(v, documents[n].spec, cel.bind(sd, config["storage.chalkos.dev/v1alpha1"].SystemDisk.map(k, config["storage.chalkos.dev/v1alpha1"].SystemDisk[k].spec)[0], cel.bind(r, n in facts.recorded.volumes ? facts.recorded.volumes[n] : null, v.disk != null && n in facts.disks && facts.disks[n].pinned && !facts.disks[n].present && (r == null || (v.format == "raw" ? "" : v.format) != r.format || (v.encryption.mode != null ? v.encryption.mode : sd.encryption.mode) != r.encryption || ((v.size == null ? "" : v.size) != r.size && !(isSize((v.size == null ? "" : v.size)) && isSize(r.size) && bytes((v.size == null ? "" : v.size)) == bytes(r.size))) || (v.mountPoint == null ? "" : v.mountPoint) != r.mountPoint))))).map(n, cel.bind(v, documents[n].spec, cel.bind(sd, config["storage.chalkos.dev/v1alpha1"].SystemDisk.map(k, config["storage.chalkos.dev/v1alpha1"].SystemDisk[k].spec)[0], cel.bind(r, n in facts.recorded.volumes ? facts.recorded.volumes[n] : null, facts.disks[n].presentError != ""
  ? "Volume " + n + ": the node cannot find its disk " + n + ": " + facts.disks[n].presentError + "; try again once it can"
  : "Volume " + n + ": its disk " + n + " (" + facts.disks[n].identity + ") is not plugged in; plug it in"
)))).join("; ")

Message of rule 6:

facts.recorded.volumes.filter(n, n != "var" && !(n in documents)).map(n, n in oldDocuments
  ? "Volume " + n + ": the config removes it; only a reinstall of " + node.name + " removes a volume"
  : "Volume " + n + ": an earlier config of this image or another added it, with an upgrade or chalkctl config apply --staged, and it stays on the node; name it in this config too; only a reinstall of " + node.name + " removes it").join("; ")

Expression of rule 7:

facts.recorded == null || config["storage.chalkos.dev/v1alpha1"].SystemDisk.map(k, config["storage.chalkos.dev/v1alpha1"].SystemDisk[k].spec)[0].encryption.fallback == "none" || size(documents.filter(n, !(n in facts.recorded.volumes) && cel.bind(v, documents[n].spec, cel.bind(sd, config["storage.chalkos.dev/v1alpha1"].SystemDisk.map(k, config["storage.chalkos.dev/v1alpha1"].SystemDisk[k].spec)[0], cel.bind(r, n in facts.recorded.volumes ? facts.recorded.volumes[n] : null, (v.encryption.mode != null ? v.encryption.mode : sd.encryption.mode) == "tpm2"))))) == 0 || (facts.fallback.sent && facts.fallback.matches != false)

Message of rule 7:

!facts.fallback.sent
  ? "Volume " + documents.filter(n, !(n in facts.recorded.volumes) && cel.bind(v, documents[n].spec, cel.bind(sd, config["storage.chalkos.dev/v1alpha1"].SystemDisk.map(k, config["storage.chalkos.dev/v1alpha1"].SystemDisk[k].spec)[0], cel.bind(r, n in facts.recorded.volumes ? facts.recorded.volumes[n] : null, (v.encryption.mode != null ? v.encryption.mode : sd.encryption.mode) == "tpm2"))))[0] + " is encrypted and the node's fallback is " + config["storage.chalkos.dev/v1alpha1"].SystemDisk.map(k, config["storage.chalkos.dev/v1alpha1"].SystemDisk[k].spec)[0].encryption.fallback + ", but no fallback secret was sent"
  : "the fallback secret does not match the node's existing fallback keyslot"

Images with Kubernetes

The rules of the kinds that images with Kubernetes accept, and those they add to other kinds.

BGPPeer

Rule Field Guards Takes Expression Message
1 spec A BGPPeer names an address, interfaces or both. refuse self.address != null || self.interfaces != null the peer names neither address nor interfaces; give its address, the interfaces of unnumbered sessions, or the address and the one interface its session runs on
2 spec A BGPPeer with an address names one interface at most. refuse self.address == null || self.interfaces == null || size(self.interfaces) == 1 FRR binds a session to an address to one interface, so a peer with an address names one interface at most; for a neighbour on several links, give each link a BGPPeer of its own with the neighbour's address on that link, a different address on each, or leave the address out for unnumbered sessions
3 spec No interface carries the unnumbered sessions of two BGPPeers. refuse after the table after the table
4 spec A node with BGPPeer documents has a BGPSpeaker. refuse after the table a node with BGPPeer documents needs a BGPSpeaker document, which gives FRR its AS number and router ID
5 spec.address A BGPPeer's address is a unicast address: not unspecified, loopback, link-local or multicast. refuse after the table after the table
6 spec.asn A BGPPeer keeps its AS number. refuse self == oldSelf "the AS number stays " + string(oldSelf) + "; add a BGPPeer of another name for " + string(self)
7 spec.interfaces Each interface is named by a Network document's [Match] Name=. refuse after the table after the table
8 spec.interfaces A BGPPeer's interfaces are not named like IPv4 addresses. refuse self == null || self.all(i, !i.matches("^([0-9]{1,3}[.]){3}[0-9]{1,3}$")) after the table
9 spec.password A BGPPeer's password names its Secret and key as credentials' names. refuse after the table the Secret's name and key hold letters, digits, '.', '_' and '-' alone, as the names of frr.service's credentials do

Expression of rule 3:

self.address != null || self.interfaces == null || cel.bind(peers, (("kubernetes.chalkos.dev/v1alpha1" in config && "BGPPeer" in config["kubernetes.chalkos.dev/v1alpha1"]) ? config["kubernetes.chalkos.dev/v1alpha1"].BGPPeer : {}), cel.bind(links, peers.map(n, peers[n].spec.address == null && peers[n].spec.interfaces != null ? peers[n].spec.interfaces.map(i, "<" + i + ">").join("") : "").join(""), self.interfaces.all(i, links.indexOf("<" + i + ">") == links.lastIndexOf("<" + i + ">"))))

Message of rule 3:

cel.bind(peers, (("kubernetes.chalkos.dev/v1alpha1" in config && "BGPPeer" in config["kubernetes.chalkos.dev/v1alpha1"]) ? config["kubernetes.chalkos.dev/v1alpha1"].BGPPeer : {}), cel.bind(links, peers.map(n, peers[n].spec.address == null && peers[n].spec.interfaces != null ? peers[n].spec.interfaces.map(i, "<" + i + ">").join("") : "").join(""), self.interfaces.filter(i, links.indexOf("<" + i + ">") != links.lastIndexOf("<" + i + ">"))[0])) + " carries the unnumbered sessions of another BGPPeer too; FRR runs one unnumbered session per interface, so give the neighbour on that link one BGPPeer"

Expression of rule 4:

size((("kubernetes.chalkos.dev/v1alpha1" in config && "BGPSpeaker" in config["kubernetes.chalkos.dev/v1alpha1"]) ? config["kubernetes.chalkos.dev/v1alpha1"].BGPSpeaker : {})) > 0

Expression of rule 5:

self == null || cel.bind(x, ip(self), x != ip("0.0.0.0") && x != ip("::") && !cidr("127.0.0.0/8").contains(x) && x != ip("::1") && !cidr("169.254.0.0/16").contains(x) && !cidr("fe80::/10").contains(x) && !cidr("224.0.0.0/4").contains(x) && !cidr("ff00::/8").contains(x))

Message of rule 5:

"the address " + self + " is no neighbour's: give a unicast address, neither loopback nor link-local; a neighbour on a link without one takes interfaces alone"

Expression of rule 7:

self == null || cel.bind(names, cel.bind(nets, (("networkd.chalkos.dev/v1alpha1" in config && "Network" in config["networkd.chalkos.dev/v1alpha1"]) ? config["networkd.chalkos.dev/v1alpha1"].Network : {}), cel.bind(matches, dyn(nets.map(n, "match" in nets[n].spec ? (type(nets[n].spec.match) == list ? nets[n].spec.match : [nets[n].spec.match]) : []).flatten()), " " + dyn(matches.map(m, "name" in m ? (type(m.name) == list ? m.name : [m.name]) : []).flatten()).join(" ").replace("\t", " ") + " ")), self.all(i, names.contains(" " + i + " ")))

Message of rule 7:

cel.bind(names, cel.bind(nets, (("networkd.chalkos.dev/v1alpha1" in config && "Network" in config["networkd.chalkos.dev/v1alpha1"]) ? config["networkd.chalkos.dev/v1alpha1"].Network : {}), cel.bind(matches, dyn(nets.map(n, "match" in nets[n].spec ? (type(nets[n].spec.match) == list ? nets[n].spec.match : [nets[n].spec.match]) : []).flatten()), " " + dyn(matches.map(m, "name" in m ? (type(m.name) == list ? m.name : [m.name]) : []).flatten()).join(" ").replace("\t", " ") + " ")), self.filter(i, !names.contains(" " + i + " "))[0] + " has no Network document whose [Match] Name= names it; FRR runs sessions on interfaces the node configures")

Message of rule 8:

"the interface " + self.filter(i, i.matches("^([0-9]{1,3}[.]){3}[0-9]{1,3}$"))[0] + " is named like an address, which FRR cannot tell from a neighbour's; rename the interface"

Expression of rule 9:

self == null || self.secretRef.name.matches("^[A-Za-z0-9._-]+$") && self.secretRef.key.matches("^[A-Za-z0-9._-]+$")

BGPSpeaker

Rule Field Guards Takes Expression Message
1 spec A BGPSpeaker gives a router ID unless the Node has an IPv4 address. refuse after the table the Node's nodeIP.addresses hold no IPv4 address, which FRR would take as its router ID; give routerID, an IPv4 address unique within the node's AS, such as 0.0.0.11
2 spec.asn A BGPSpeaker keeps its AS number. refuse self == oldSelf after the table
3 spec.export.interfaces Each interface is named by a Network document's [Match] Name=. refuse after the table after the table
4 spec.routerID A router ID is not 0.0.0.0. refuse self == null || self != "0.0.0.0" FRR takes no router ID 0.0.0.0; give the node another one, unique within its AS

Expression of rule 1:

self.routerID != null || cel.bind(nodes, (("kubernetes.chalkos.dev/v1alpha1" in config && "Node" in config["kubernetes.chalkos.dev/v1alpha1"]) ? config["kubernetes.chalkos.dev/v1alpha1"].Node : {}), nodes.exists(n, has(nodes[n].spec.nodeIP) && has(nodes[n].spec.nodeIP.addresses) && nodes[n].spec.nodeIP.addresses != null && nodes[n].spec.nodeIP.addresses.exists(a, ip(a).family() == "ipv4")))

Message of rule 2:

"the AS number stays " + string(oldSelf) + "; to change it, deliver the config without the BGPSpeaker, which ends the node's sessions, and then with the new AS number"

Expression of rule 3:

cel.bind(names, cel.bind(nets, (("networkd.chalkos.dev/v1alpha1" in config && "Network" in config["networkd.chalkos.dev/v1alpha1"]) ? config["networkd.chalkos.dev/v1alpha1"].Network : {}), cel.bind(matches, dyn(nets.map(n, "match" in nets[n].spec ? (type(nets[n].spec.match) == list ? nets[n].spec.match : [nets[n].spec.match]) : []).flatten()), " " + dyn(matches.map(m, "name" in m ? (type(m.name) == list ? m.name : [m.name]) : []).flatten()).join(" ").replace("\t", " ") + " ")), self.all(i, names.contains(" " + i + " ")))

Message of rule 3:

cel.bind(names, cel.bind(nets, (("networkd.chalkos.dev/v1alpha1" in config && "Network" in config["networkd.chalkos.dev/v1alpha1"]) ? config["networkd.chalkos.dev/v1alpha1"].Network : {}), cel.bind(matches, dyn(nets.map(n, "match" in nets[n].spec ? (type(nets[n].spec.match) == list ? nets[n].spec.match : [nets[n].spec.match]) : []).flatten()), " " + dyn(matches.map(m, "name" in m ? (type(m.name) == list ? m.name : [m.name]) : []).flatten()).join(" ").replace("\t", " ") + " ")), self.filter(i, !names.contains(" " + i + " "))[0] + " has no Network document whose [Match] Name= names it; FRR announces the addresses of interfaces the node configures")

Cluster

Rule Field Guards Takes Expression Message
1 — The pod range of each family both configs have stays once the node holds a Kubernetes share. refuse after the table after the table
2 — The service range of each family both configs have stays once the node holds a Kubernetes share. refuse after the table after the table
3 — The cluster DNS's address of each family both configs have, by default the 10th of its service range, stays once the node holds a Kubernetes share. refuse after the table after the table
4 spec.allowSchedulingOnControlPlanes Whether workloads run on control planes stays once the node holds a Kubernetes share. refuse facts.share == null || self == oldSelf the config changes allowSchedulingOnControlPlanes; the value applies when the node registers with the cluster, so changing it on a running node changes nothing; add or remove the node-role.kubernetes.io/control-plane:NoSchedule taint with kubectl taint instead, or reinstall the node
5 spec.ipFamilies The cluster's address families stay once the node holds a Kubernetes share. refuse facts.share == null || self == oldSelf after the table

Expression of rule 1:

facts.share == null || size(oldDocuments) == 0 || size(documents) == 0 || cel.bind(was, oldDocuments.map(o, oldDocuments[o].spec)[0], cel.bind(gets, documents.map(n, documents[n].spec)[0], was.ipFamilies.filter(f, f in gets.ipFamilies).all(f, cidr(was.podCIDRs[f]) == cidr(gets.podCIDRs[f]))))

Message of rule 1:

cel.bind(was, oldDocuments.map(o, oldDocuments[o].spec)[0], cel.bind(gets, documents.map(n, documents[n].spec)[0], cel.bind(families, was.ipFamilies.filter(f, f in gets.ipFamilies),
  "the config changes the cluster's podCIDRs from "
  + families.map(f, f + " " + string(cidr(was.podCIDRs[f]))).join(", ") + " to "
  + families.map(f, f + " " + string(cidr(gets.podCIDRs[f]))).join(", ") + "; they are fixed once the cluster exists, so keep them, or reinstall the node into a new cluster")
))

Expression of rule 2:

facts.share == null || size(oldDocuments) == 0 || size(documents) == 0 || cel.bind(was, oldDocuments.map(o, oldDocuments[o].spec)[0], cel.bind(gets, documents.map(n, documents[n].spec)[0], was.ipFamilies.filter(f, f in gets.ipFamilies).all(f, cidr(was.serviceCIDRs[f]) == cidr(gets.serviceCIDRs[f]))))

Message of rule 2:

cel.bind(was, oldDocuments.map(o, oldDocuments[o].spec)[0], cel.bind(gets, documents.map(n, documents[n].spec)[0], cel.bind(families, was.ipFamilies.filter(f, f in gets.ipFamilies),
  "the config changes the cluster's serviceCIDRs from "
  + families.map(f, f + " " + string(cidr(was.serviceCIDRs[f]))).join(", ") + " to "
  + families.map(f, f + " " + string(cidr(gets.serviceCIDRs[f]))).join(", ") + "; they are fixed once the cluster exists, so keep them, or reinstall the node into a new cluster")
))

Expression of rule 3:

facts.share == null || size(oldDocuments) == 0 || size(documents) == 0 || cel.bind(was, oldDocuments.map(o, oldDocuments[o].spec)[0], cel.bind(gets, documents.map(n, documents[n].spec)[0], was.ipFamilies.filter(f, f in gets.ipFamilies).all(f, (was.dnsIPs[f] != null ? ip(was.dnsIPs[f]) : cidr(was.serviceCIDRs[f]).ip(10)) == (gets.dnsIPs[f] != null ? ip(gets.dnsIPs[f]) : cidr(gets.serviceCIDRs[f]).ip(10)))))

Message of rule 3:

cel.bind(was, oldDocuments.map(o, oldDocuments[o].spec)[0], cel.bind(gets, documents.map(n, documents[n].spec)[0], cel.bind(families, was.ipFamilies.filter(f, f in gets.ipFamilies),
  "the config changes the cluster's dnsIPs from "
  + families.map(f, f + " " + string((was.dnsIPs[f] != null ? ip(was.dnsIPs[f]) : cidr(was.serviceCIDRs[f]).ip(10)))).join(", ") + " to "
  + families.map(f, f + " " + string((gets.dnsIPs[f] != null ? ip(gets.dnsIPs[f]) : cidr(gets.serviceCIDRs[f]).ip(10)))).join(", ") + "; they are fixed once the cluster exists, so keep them, or reinstall the node into a new cluster")
))

Message of rule 5:

"the config changes the cluster's ipFamilies from " + oldSelf.join(", ") + " to " + self.join(", ") + "; they are fixed once the cluster exists, so keep them, or reinstall the node into a new cluster"

ClusterRegistry

Rule Field Guards Takes Expression Message
1 spec.endpoints Every control plane serves the cluster registry: one of its static addresses is an endpoint. refuse after the table after the table

Expression of rule 1:

cel.bind(nodes, (("kubernetes.chalkos.dev/v1alpha1" in config && "Node" in config["kubernetes.chalkos.dev/v1alpha1"]) ? config["kubernetes.chalkos.dev/v1alpha1"].Node : {}), !nodes.exists(n, nodes[n].spec.type == "controlplane")) || node.addresses.exists(a, self.exists(e, ip(e) == ip(a)))

Message of rule 1:

"the control plane " + node.name + " serves the cluster registry, but the ClusterRegistry's endpoints name none of its static addresses (" + (size(node.addresses) == 0 ? "none" : node.addresses.join(", ")) + "); add one of them to the endpoints and apply the config to every node"

Node

Rule Field Guards Takes Expression Message
1 — The node keeps the type its Kubernetes share is for. refuse facts.share == null || documents.all(n, documents[n].spec.type == facts.share.kind) after the table
2 spec.labels The node keeps its labels once it holds a Kubernetes share. refuse facts.share == null || self == oldSelf the config changes the node's labels; the value applies when the node registers with the cluster, so changing it on a running node changes nothing; change the Node object with kubectl label instead, or reinstall the node
3 spec.taints The node keeps its taints once it holds a Kubernetes share. refuse facts.share == null || self == oldSelf the config changes the node's taints; the value applies when the node registers with the cluster, so changing it on a running node changes nothing; change the Node object with kubectl taint instead, or reinstall the node
4 spec.vip.interface A control plane of a cluster with a routed VIP names the interface it adds the VIP to. refuse after the table the Cluster's VIP is routed, so a control plane needs vip.interface: the interface it adds the VIP to, such as a dummy interface its routing daemon announces

Message of rule 1:

cel.bind(type, documents.map(n, documents[n].spec.type)[0],
  "the config changes the node's type from \"" + facts.share.kind + "\" to \"" + type
  + "\"; a node keeps its type once it holds a Kubernetes share, so keep it, or reinstall the node as a " + type)

Expression of rule 4:

self != null || cel.bind(nodes, (("kubernetes.chalkos.dev/v1alpha1" in config && "Node" in config["kubernetes.chalkos.dev/v1alpha1"]) ? config["kubernetes.chalkos.dev/v1alpha1"].Node : {}), nodes.all(n, nodes[n].spec.type == "worker")) || cel.bind(clusters, (("kubernetes.chalkos.dev/v1alpha1" in config && "Cluster" in config["kubernetes.chalkos.dev/v1alpha1"]) ? config["kubernetes.chalkos.dev/v1alpha1"].Cluster : {}), clusters.all(n, clusters[n].spec.vip.mode != "routed" || size(clusters[n].spec.vip.addresses) == 0))

Router images

The rules of the kinds that router images accept, and those they add to other kinds.

AddressSet

Rule Field Guards Takes Expression Message
1 — An AddressSet's ranges are of its family. refuse after the table after the table

Expression of rule 1:

documents.all(n, documents[n].spec.prefixes.all(p, cidr(p).ip(0).family() == documents[n].spec.family))

Message of rule 1:

documents.filter(n, !documents[n].spec.prefixes.all(p, cidr(p).ip(0).family() == documents[n].spec.family)).map(n, "AddressSet " + n + " holds ranges of another family than " + documents[n].spec.family).join("; ")

BGP

Rule Field Guards Takes Expression Message
1 — A BGP instance does not import its own VRF. refuse after the table after the table
2 — A delivery that drops the default VRF's BGP document keeps no running BGP instance of another VRF, as FRR keeps its default instance while another runs. refuse after the table the config drops the default VRF's BGP document and keeps a running BGP instance of another VRF, which FRR does not allow; drop the other VRFs' BGP documents in the same delivery, or keep the default VRF's
3 — A BGP instance of a VRF other than the default one announces no default route among its networks. refuse after the table after the table
4 spec.asn BGP keeps its AS number. refuse self == oldSelf after the table
5 spec.import An import's VRFs have BGP documents. refuse after the table after the table
6 spec.import An import's policy matches PrefixLists of its family alone. refuse after the table after the table
7 spec.networks A network's policy matches PrefixLists of the network's family alone. refuse after the table after the table
8 spec.routerID A router ID is an IPv4 unicast address: not 0.0.0.0, multicast or 255.255.255.255. refuse after the table after the table

Expression of rule 1:

documents.all(n, cel.bind(s, documents[n].spec, [s["import"].ipv4, s["import"].ipv6].all(f, f == null || !(documents[n].spec.vrf in f.vrfs))))

Message of rule 1:

documents.filter(n, cel.bind(s, documents[n].spec, ![s["import"].ipv4, s["import"].ipv6].all(f, f == null || !(documents[n].spec.vrf in f.vrfs)))).map(n, "BGP " + n).join(", ") + " imports the routes of its own VRF; name other VRFs"

Expression of rule 2:

!oldDocuments.exists(n, oldDocuments[n].spec.vrf == "default") || documents.exists(n, documents[n].spec.vrf == "default") || !documents.exists(n, documents[n].spec.vrf != "default" && oldDocuments.exists(m, oldDocuments[m].spec.vrf == documents[n].spec.vrf))

Expression of rule 3:

documents.all(n, (documents[n].spec.vrf == "default" || documents[n].spec.networks.all(w, cidr(w.prefix).prefix() > 0)))

Message of rule 3:

documents.filter(n, !(documents[n].spec.vrf == "default" || documents[n].spec.networks.all(w, cidr(w.prefix).prefix() > 0))).map(n, "BGP " + n + " announces the network " + documents[n].spec.networks.filter(w, cidr(w.prefix).prefix() == 0)[0].prefix + " in VRF " + documents[n].spec.vrf).join(", ") + ", which would always be announced, as a VRF's table ends in an unreachable default route; use a peer family's defaultOriginate"

Message of rule 4:

"the AS number stays " + string(oldSelf) + "; to change it, deliver the config without the BGP document, which ends the router's sessions, and then with the new AS number"

Expression of rule 5:

cel.bind(have, cel.bind(bgps, (("router.chalkos.dev/v1alpha1" in config && "BGP" in config["router.chalkos.dev/v1alpha1"]) ? config["router.chalkos.dev/v1alpha1"].BGP : {}), bgps.map(n, bgps[n].spec.vrf)), [self.ipv4, self.ipv6].all(f, f == null || f.vrfs.all(v, v in have)))

Message of rule 5:

cel.bind(have, cel.bind(bgps, (("router.chalkos.dev/v1alpha1" in config && "BGP" in config["router.chalkos.dev/v1alpha1"]) ? config["router.chalkos.dev/v1alpha1"].BGP : {}), bgps.map(n, bgps[n].spec.vrf)), "the import names the VRF " + [self.ipv4, self.ipv6].filter(f, f != null).map(f, f.vrfs.filter(v, !(v in have))).flatten()[0] + ", which no BGP document serves; leaking takes routes from BGP alone")

Expression of rule 6:

(self.ipv4 == null || self.ipv4.policy == null || cel.bind(named, document("RoutingPolicy", self.ipv4.policy).spec.terms.filter(t, t.match.prefixList != null), size(named) == 0 || document("PrefixList", named[0].match.prefixList).spec.family == "ipv4")) && (self.ipv6 == null || self.ipv6.policy == null || cel.bind(named, document("RoutingPolicy", self.ipv6.policy).spec.terms.filter(t, t.match.prefixList != null), size(named) == 0 || document("PrefixList", named[0].match.prefixList).spec.family == "ipv6"))

Message of rule 6:

"the " + (self.ipv4 == null || self.ipv4.policy == null || cel.bind(named, document("RoutingPolicy", self.ipv4.policy).spec.terms.filter(t, t.match.prefixList != null), size(named) == 0 || document("PrefixList", named[0].match.prefixList).spec.family == "ipv4") ? "ipv6" : "ipv4") + " import's RoutingPolicy matches PrefixLists of another family"

Expression of rule 7:

self.all(w, w.policy == null || cel.bind(named, document("RoutingPolicy", w.policy).spec.terms.filter(t, t.match.prefixList != null), size(named) == 0 || document("PrefixList", named[0].match.prefixList).spec.family == cidr(w.prefix).ip(0).family()))

Message of rule 7:

cel.bind(w, self.filter(w, w.policy != null && !cel.bind(named, document("RoutingPolicy", w.policy).spec.terms.filter(t, t.match.prefixList != null), size(named) == 0 || document("PrefixList", named[0].match.prefixList).spec.family == cidr(w.prefix).ip(0).family()))[0], "the RoutingPolicy " + w.policy + " of the network " + w.prefix + " matches PrefixLists of another family")

Expression of rule 8:

cel.bind(a, ip(self), a != ip("0.0.0.0") && !cidr("224.0.0.0/4").contains(a) && a != ip("255.255.255.255"))

Message of rule 8:

"the router ID " + self + " is no IPv4 unicast address; give one that is neither 0.0.0.0, multicast nor 255.255.255.255"

BGPPeer

Rule Field Guards Takes Expression Message
1 — A BGPPeer names exactly one of address, interface, interfaces and listen. refuse after the table after the table
2 — A BGPPeer's VRF has a BGP document. refuse after the table after the table
3 — A BGPPeer at an IPv6 address or with an IPv6 listen range that exchanges IPv4 routes has extendedNextHop. refuse after the table after the table
4 spec.address A BGPPeer's address is a unicast address beyond the router: not unspecified, loopback, link-local, multicast, broadcast or IPv4-mapped IPv6. refuse after the table after the table
5 spec.description A BGPPeer's description holds 80 characters at most. refuse self == null || size(self) <= 80 the description holds more than 80 characters
6 spec.families A BGPPeer exchanges the routes of one family at least. refuse self.ipv4 != null || self.ipv6 != null the peer exchanges the routes of no family; give families.ipv4 or families.ipv6, an empty one accepting and sending every route
7 spec.families A family's policies match PrefixLists of that family alone. refuse after the table after the table
8 spec.families A family's defaultOriginateWhen comes with defaultOriginate. refuse after the table after the table
9 spec.families A family's defaultOriginateWhen is a PrefixList of that family. refuse after the table after the table
10 spec.interface A BGPPeer's interfaces are not named like addresses. refuse after the table after the table
11 spec.interfaces A BGPPeer's interfaces are not named like addresses. refuse after the table after the table
12 spec.listen A BGPPeer's listen range starts at an address a neighbour may have: not in link-local, loopback, multicast or IPv4-mapped IPv6 space. refuse after the table after the table
13 spec.listen A BGPPeer's listen range is longer than 0 bits. refuse self == null || cidr(self.range).prefix() > 0 after the table
14 spec.password A BGPPeer's password names its Secret and key as credentials' names. refuse after the table the Secret's name and key hold letters, digits, '.', '_' and '-' alone, as the names of frr.service's credentials do

Expression of rule 1:

documents.all(n, cel.bind(s, documents[n].spec, [s.address, s.interface, s.interfaces, s.listen].filter(x, x != null).size() == 1))

Message of rule 1:

documents.filter(n, cel.bind(s, documents[n].spec, [s.address, s.interface, s.interfaces, s.listen].filter(x, x != null).size() != 1)).map(n, "BGPPeer " + n).join(", ") + " names not exactly one of address, interface, interfaces and listen; a peer is reached at an address, on an interface or on each interface of a list, or accepted from a listen range"

Expression of rule 2:

cel.bind(have, cel.bind(bgps, (("router.chalkos.dev/v1alpha1" in config && "BGP" in config["router.chalkos.dev/v1alpha1"]) ? config["router.chalkos.dev/v1alpha1"].BGP : {}), bgps.map(n, bgps[n].spec.vrf)), documents.all(n, documents[n].spec.vrf in have))

Message of rule 2:

cel.bind(have, cel.bind(bgps, (("router.chalkos.dev/v1alpha1" in config && "BGP" in config["router.chalkos.dev/v1alpha1"]) ? config["router.chalkos.dev/v1alpha1"].BGP : {}), bgps.map(n, bgps[n].spec.vrf)), documents.filter(n, !(documents[n].spec.vrf in have)).map(n, "BGPPeer " + n + " runs in the VRF " + documents[n].spec.vrf).join(", ") + ": a peer's VRF needs a BGP document, which gives the router its AS number there")

Expression of rule 3:

documents.all(n, (documents[n].spec.families.ipv4 == null || documents[n].spec.extendedNextHop || (documents[n].spec.address == null || ip(documents[n].spec.address).family() == "ipv4") && (documents[n].spec.listen == null || cidr(documents[n].spec.listen.range).ip(0).family() == "ipv4")))

Message of rule 3:

documents.filter(n, !(documents[n].spec.families.ipv4 == null || documents[n].spec.extendedNextHop || (documents[n].spec.address == null || ip(documents[n].spec.address).family() == "ipv4") && (documents[n].spec.listen == null || cidr(documents[n].spec.listen.range).ip(0).family() == "ipv4"))).map(n, "BGPPeer " + n + " exchanges IPv4 routes " + (documents[n].spec.address != null ? "at the IPv6 address " + documents[n].spec.address : "from the IPv6 listen range " + documents[n].spec.listen.range)).join(", ") + " without extendedNextHop: true; the routes' next hops are IPv6 addresses, which a session carries with extendedNextHop alone"

Expression of rule 4:

self == null || cel.bind(x, ip(self), x != ip("0.0.0.0") && x != ip("::") && !cidr("127.0.0.0/8").contains(x) && x != ip("::1") && !cidr("169.254.0.0/16").contains(x) && !cidr("fe80::/10").contains(x) && !cidr("224.0.0.0/4").contains(x) && !cidr("ff00::/8").contains(x) && x != ip("255.255.255.255") && !cidr("::ffff:0:0/96").contains(x))

Message of rule 4:

"the address " + self + " is no neighbour's: give a unicast address beyond the router, neither loopback, link-local nor IPv4-mapped; a neighbour on a link takes interface or interfaces"

Expression of rule 7:

(self.ipv4 == null || self.ipv4["import"] == null || cel.bind(named, document("RoutingPolicy", self.ipv4["import"]).spec.terms.filter(t, t.match.prefixList != null), size(named) == 0 || document("PrefixList", named[0].match.prefixList).spec.family == "ipv4")) && (self.ipv4 == null || self.ipv4["export"] == null || cel.bind(named, document("RoutingPolicy", self.ipv4["export"]).spec.terms.filter(t, t.match.prefixList != null), size(named) == 0 || document("PrefixList", named[0].match.prefixList).spec.family == "ipv4")) && (self.ipv6 == null || self.ipv6["import"] == null || cel.bind(named, document("RoutingPolicy", self.ipv6["import"]).spec.terms.filter(t, t.match.prefixList != null), size(named) == 0 || document("PrefixList", named[0].match.prefixList).spec.family == "ipv6")) && (self.ipv6 == null || self.ipv6["export"] == null || cel.bind(named, document("RoutingPolicy", self.ipv6["export"]).spec.terms.filter(t, t.match.prefixList != null), size(named) == 0 || document("PrefixList", named[0].match.prefixList).spec.family == "ipv6"))

Message of rule 7:

cel.bind(u, [(self.ipv4 == null || self.ipv4["import"] == null || cel.bind(named, document("RoutingPolicy", self.ipv4["import"]).spec.terms.filter(t, t.match.prefixList != null), size(named) == 0 || document("PrefixList", named[0].match.prefixList).spec.family == "ipv4") ? [] : [self.ipv4["import"], "ipv4"]), (self.ipv4 == null || self.ipv4["export"] == null || cel.bind(named, document("RoutingPolicy", self.ipv4["export"]).spec.terms.filter(t, t.match.prefixList != null), size(named) == 0 || document("PrefixList", named[0].match.prefixList).spec.family == "ipv4") ? [] : [self.ipv4["export"], "ipv4"]), (self.ipv6 == null || self.ipv6["import"] == null || cel.bind(named, document("RoutingPolicy", self.ipv6["import"]).spec.terms.filter(t, t.match.prefixList != null), size(named) == 0 || document("PrefixList", named[0].match.prefixList).spec.family == "ipv6") ? [] : [self.ipv6["import"], "ipv6"]), (self.ipv6 == null || self.ipv6["export"] == null || cel.bind(named, document("RoutingPolicy", self.ipv6["export"]).spec.terms.filter(t, t.match.prefixList != null), size(named) == 0 || document("PrefixList", named[0].match.prefixList).spec.family == "ipv6") ? [] : [self.ipv6["export"], "ipv6"])].filter(u, size(u) > 0)[0], "the " + u[1] + " family's RoutingPolicy " + u[0] + " matches a PrefixList of another family")

Expression of rule 8:

(self.ipv4 == null || self.ipv4.defaultOriginateWhen == null || self.ipv4.defaultOriginate) && (self.ipv6 == null || self.ipv6.defaultOriginateWhen == null || self.ipv6.defaultOriginate)

Message of rule 8:

cel.bind(u, [(self.ipv4 == null || self.ipv4.defaultOriginateWhen == null || self.ipv4.defaultOriginate ? [] : ["ipv4", self.ipv4.defaultOriginateWhen]), (self.ipv6 == null || self.ipv6.defaultOriginateWhen == null || self.ipv6.defaultOriginate ? [] : ["ipv6", self.ipv6.defaultOriginateWhen])].filter(u, size(u) > 0)[0], "the " + u[0] + " family names defaultOriginateWhen without defaultOriginate: true; defaultOriginateWhen says when the router sends the default route that defaultOriginate originates")

Expression of rule 9:

(self.ipv4 == null || self.ipv4.defaultOriginateWhen == null || document("PrefixList", self.ipv4.defaultOriginateWhen).spec.family == "ipv4") && (self.ipv6 == null || self.ipv6.defaultOriginateWhen == null || document("PrefixList", self.ipv6.defaultOriginateWhen).spec.family == "ipv6")

Message of rule 9:

cel.bind(u, [(self.ipv4 == null || self.ipv4.defaultOriginateWhen == null || document("PrefixList", self.ipv4.defaultOriginateWhen).spec.family == "ipv4" ? [] : ["ipv4", self.ipv4.defaultOriginateWhen]), (self.ipv6 == null || self.ipv6.defaultOriginateWhen == null || document("PrefixList", self.ipv6.defaultOriginateWhen).spec.family == "ipv6" ? [] : ["ipv6", self.ipv6.defaultOriginateWhen])].filter(u, size(u) > 0)[0], "the " + u[0] + " family's defaultOriginateWhen names the PrefixList " + u[1] + " of " + document("PrefixList", u[1]).spec.family + "; it tracks routes of the family whose default route it sends")

Expression of rule 10:

self == null || [self].all(i, !i.matches("^([0-9]{1,3}[.]){3}[0-9]{1,3}$|^[0-9A-Fa-f:.]*:[0-9A-Fa-f:.]*:[0-9A-Fa-f:.]*$"))

Message of rule 10:

"the interface " + [self].filter(i, i.matches("^([0-9]{1,3}[.]){3}[0-9]{1,3}$|^[0-9A-Fa-f:.]*:[0-9A-Fa-f:.]*:[0-9A-Fa-f:.]*$"))[0] + " is named like an address, which FRR cannot tell from a neighbour's; give the peer its address, or rename the interface"

Expression of rule 11:

self == null || self.all(i, !i.matches("^([0-9]{1,3}[.]){3}[0-9]{1,3}$|^[0-9A-Fa-f:.]*:[0-9A-Fa-f:.]*:[0-9A-Fa-f:.]*$"))

Message of rule 11:

"the interface " + self.filter(i, i.matches("^([0-9]{1,3}[.]){3}[0-9]{1,3}$|^[0-9A-Fa-f:.]*:[0-9A-Fa-f:.]*:[0-9A-Fa-f:.]*$"))[0] + " is named like an address, which FRR cannot tell from a neighbour's; give the peer its address, or rename the interface"

Expression of rule 12:

self == null || cidr(self.range).prefix() == 0 || cel.bind(x, ip(string(cidr(self.range).ip(0))), x != ip("0.0.0.0") && x != ip("::") && !cidr("127.0.0.0/8").contains(x) && x != ip("::1") && !cidr("169.254.0.0/16").contains(x) && !cidr("fe80::/10").contains(x) && !cidr("224.0.0.0/4").contains(x) && !cidr("ff00::/8").contains(x) && x != ip("255.255.255.255") && !cidr("::ffff:0:0/96").contains(x))

Message of rule 12:

"the listen range " + self.range + " starts in link-local, loopback, multicast or IPv4-mapped space, where no neighbour's address lies; give the neighbours' prefix. FRR accepts no link-local range"

Message of rule 13:

"a listen range of length 0, " + self.range + ", accepts a session from every address; give the neighbours' prefix"

Expression of rule 14:

self == null || self.secretRef.name.matches("^[A-Za-z0-9._-]+$") && self.secretRef.key.matches("^[A-Za-z0-9._-]+$")

CommunityList

Rule Field Guards Takes Expression Message
1 — A CommunityList holds standard or large communities, not both. refuse after the table after the table

Expression of rule 1:

documents.all(n, cel.bind(c, documents[n].spec.communities, cel.bind(large, c[0].indexOf(":") != c[0].lastIndexOf(":"), c.all(x, (x.indexOf(":") != x.lastIndexOf(":")) == large))))

Message of rule 1:

documents.filter(n, cel.bind(c, documents[n].spec.communities, cel.bind(large, c[0].indexOf(":") != c[0].lastIndexOf(":"), !c.all(x, (x.indexOf(":") != x.lastIndexOf(":")) == large)))).map(n, "CommunityList " + n).join(", ") + " holds standard and large communities; give each kind a list of its own"

DHCPRelay

Rule Field Guards Takes Expression Message
1 spec.servers A relay's servers are unicast addresses. refuse after the table after the table

Expression of rule 1:

self.all(a, !["0.0.0.0/8", "127.0.0.0/8", "169.254.0.0/16", "224.0.0.0/3", "::/8", "fe80::/10", "ff00::/8"].exists(r, cidr(r).contains(ip(a))))

Message of rule 1:

"the server " + self.filter(a, ["0.0.0.0/8", "127.0.0.0/8", "169.254.0.0/16", "224.0.0.0/3", "::/8", "fe80::/10", "ff00::/8"].exists(r, cidr(r).contains(ip(a))))[0] + " is no unicast address a relay forwards to"

DHCPSubnet

Rule Field Guards Takes Expression Message
1 spec A pool lies inside the subnet. refuse cel.bind(c, cidr(self.subnet), self.pools.all(p, c.contains(ip(p.first)) && c.contains(ip(p.last)))) after the table
2 spec A pool's first address comes before its last or is its last. refuse self.pools.all(p, ip(p.first).compare(ip(p.last)) <= 0) after the table
3 spec No two pools share an address. refuse after the table after the table
4 spec A pool leaves out the subnet's network and broadcast addresses, or an IPv6 subnet's subnet-router anycast address. refuse after the table after the table
5 spec A pool holds neither the gateway nor a DNS server nor boot's server. refuse after the table after the table
6 spec A reservation lies inside the subnet. refuse cel.bind(c, cidr(self.subnet), self.reservations.all(r, c.contains(ip(r.address)))) after the table
7 spec A reservation lies outside the pools. refuse after the table after the table
8 spec A reservation is neither the subnet's network nor its broadcast address, nor an IPv6 subnet's subnet-router anycast address. refuse after the table after the table
9 spec A reservation is neither the gateway nor a DNS server nor boot's server. refuse after the table after the table
10 spec A gateway is given for IPv4 subnets alone; IPv6 clients learn their routers from router advertisements. refuse cel.bind(c, cidr(self.subnet), self.gateway == null || c.ip(0).family() == "ipv4") gateway is for IPv4 subnets; IPv6 clients learn their routers from router advertisements
11 spec A gateway lies inside the subnet. refuse cel.bind(c, cidr(self.subnet), self.gateway == null || c.contains(ip(self.gateway))) after the table
12 spec A gateway is neither the subnet's network nor its broadcast address. refuse after the table after the table
13 spec A DNS server is an address of the subnet's family, and no IPv4-mapped IPv6 address. refuse after the table after the table
14 spec PXE boot files are given for IPv4 subnets alone. refuse cel.bind(c, cidr(self.subnet), self.boot == null || c.ip(0).family() == "ipv4") boot is for IPv4 subnets
15 spec A subnet delegates prefixes for IPv6 alone. refuse cel.bind(c, cidr(self.subnet), self.prefixDelegation == null || !(c.ip(0).family() == "ipv4")) prefixDelegation delegates IPv6 prefixes, which an IPv4 subnet has none of
16 spec The prefixes a subnet delegates lie apart from the subnet. refuse after the table after the table
17 spec An IPv6 subnet is served on one link, the one Kea's DHCPv6 subnet names. refuse cel.bind(c, cidr(self.subnet), c.ip(0).family() == "ipv4" || size(self.interfaces) == 1) after the table
18 spec.boot A boot names a file. refuse self == null || self.bios != null || self.uefi != null || self.ipxe != null boot names no file; give bios, uefi or ipxe, or leave boot out
19 spec.boot A boot's server is an IPv4 address. refuse self == null || self.server == null || ip(self.server).family() == "ipv4" boot's server is no IPv4 address
20 spec.boot A boot of BIOS or UEFI files names their server. refuse self == null || self.server != null || (self.bios == null && self.uefi == null) boot's bios and uefi files load over TFTP from boot's server; give server
21 spec.leaseTime A lease lasts 4294967295 seconds at most, the longest Kea takes. refuse after the table "a lease of " + self + " is longer than 4294967295 seconds, the longest Kea takes"
22 spec.prefixDelegation Prefixes are delegated from an IPv6 range apart from ::/8, fe80::/10 and ff00::/8, each longer than the range. refuse after the table after the table
23 spec.subnet A subnet is an IPv4 range of 30 bits at most apart from 0.0.0.0/8, 127.0.0.0/8, 169.254.0.0/16 and 224.0.0.0/3, or an IPv6 range of 120 bits at most apart from ::/8, fe80::/10 and ff00::/8. refuse after the table after the table

Message of rule 1:

cel.bind(c, cidr(self.subnet), cel.bind(p, self.pools.filter(p, !(c.contains(ip(p.first)) && c.contains(ip(p.last))))[0], "the pool " + p.first + "-" + p.last + " lies outside the subnet " + string(c)))

Message of rule 2:

cel.bind(p, self.pools.filter(p, !(ip(p.first).compare(ip(p.last)) <= 0))[0], "the pool " + p.first + "-" + p.last + " ends before it starts")

Expression of rule 3:

self.pools.all(p, size(self.pools.filter(q, (ip(p.first).compare(ip(q.last)) <= 0 && ip(q.first).compare(ip(p.last)) <= 0))) <= 1)

Message of rule 3:

cel.bind(p, self.pools.filter(p, !(size(self.pools.filter(q, (ip(p.first).compare(ip(q.last)) <= 0 && ip(q.first).compare(ip(p.last)) <= 0))) <= 1))[0], "the pool " + p.first + "-" + p.last + " shares addresses with another pool")

Expression of rule 4:

cel.bind(c, cidr(self.subnet), self.pools.all(p, !(ip(p.first) == c.ip(0) || c.ip(0).family() == "ipv4" && ip(p.first) == c.last()) && !(ip(p.last) == c.ip(0) || c.ip(0).family() == "ipv4" && ip(p.last) == c.last())))

Message of rule 4:

cel.bind(c, cidr(self.subnet), cel.bind(p, self.pools.filter(p, !(!(ip(p.first) == c.ip(0) || c.ip(0).family() == "ipv4" && ip(p.first) == c.last()) && !(ip(p.last) == c.ip(0) || c.ip(0).family() == "ipv4" && ip(p.last) == c.last())))[0], cel.bind(a, (ip(p.first) == c.ip(0) || c.ip(0).family() == "ipv4" && ip(p.first) == c.last()) ? p.first : p.last, "the pool " + p.first + "-" + p.last + " holds " + a + ", the " + (ip(a) != c.ip(0) ? "broadcast address" : c.ip(0).family() == "ipv4" ? "network address" : "subnet-router anycast address") + " of the subnet " + string(c))))

Expression of rule 5:

cel.bind(t, (self.gateway == null ? [] : [{"address": self.gateway, "is": "the gateway"}]) + self.dns.map(a, {"address": a, "is": "a DNS server"}) + (self.boot == null || self.boot.server == null ? [] : [{"address": self.boot.server, "is": "boot's server"}]), self.pools.all(p, t.all(x, !(ip(p.first).compare(ip(x.address)) <= 0 && ip(x.address).compare(ip(p.last)) <= 0))))

Message of rule 5:

cel.bind(t, (self.gateway == null ? [] : [{"address": self.gateway, "is": "the gateway"}]) + self.dns.map(a, {"address": a, "is": "a DNS server"}) + (self.boot == null || self.boot.server == null ? [] : [{"address": self.boot.server, "is": "boot's server"}]), cel.bind(p, self.pools.filter(p, !(t.all(x, !(ip(p.first).compare(ip(x.address)) <= 0 && ip(x.address).compare(ip(p.last)) <= 0))))[0], cel.bind(x, t.filter(x, !(!(ip(p.first).compare(ip(x.address)) <= 0 && ip(x.address).compare(ip(p.last)) <= 0)))[0], "the pool " + p.first + "-" + p.last + " holds " + x.address + ", " + x.is)))

Message of rule 6:

cel.bind(c, cidr(self.subnet), cel.bind(r, self.reservations.filter(r, !(c.contains(ip(r.address))))[0], "the reservation of " + r.mac + ", " + r.address + "," + " lies outside the subnet " + string(c)))

Expression of rule 7:

self.reservations.all(r, self.pools.all(p, !(ip(p.first).compare(ip(r.address)) <= 0 && ip(r.address).compare(ip(p.last)) <= 0)))

Message of rule 7:

cel.bind(r, self.reservations.filter(r, !(self.pools.all(p, !(ip(p.first).compare(ip(r.address)) <= 0 && ip(r.address).compare(ip(p.last)) <= 0))))[0], cel.bind(p, self.pools.filter(p, !(!(ip(p.first).compare(ip(r.address)) <= 0 && ip(r.address).compare(ip(p.last)) <= 0)))[0], "the reservation of " + r.mac + ", " + r.address + "," + " lies in " + "the pool " + p.first + "-" + p.last + "; reserve addresses outside the pools"))

Expression of rule 8:

cel.bind(c, cidr(self.subnet), self.reservations.all(r, !(ip(r.address) == c.ip(0) || c.ip(0).family() == "ipv4" && ip(r.address) == c.last())))

Message of rule 8:

cel.bind(c, cidr(self.subnet), cel.bind(r, self.reservations.filter(r, !(!(ip(r.address) == c.ip(0) || c.ip(0).family() == "ipv4" && ip(r.address) == c.last())))[0], "the reservation of " + r.mac + ", " + r.address + "," + " is the " + (ip(r.address) != c.ip(0) ? "broadcast address" : c.ip(0).family() == "ipv4" ? "network address" : "subnet-router anycast address") + " of the subnet " + string(c)))

Expression of rule 9:

cel.bind(t, (self.gateway == null ? [] : [{"address": self.gateway, "is": "the gateway"}]) + self.dns.map(a, {"address": a, "is": "a DNS server"}) + (self.boot == null || self.boot.server == null ? [] : [{"address": self.boot.server, "is": "boot's server"}]), self.reservations.all(r, t.all(x, ip(x.address) != ip(r.address))))

Message of rule 9:

cel.bind(t, (self.gateway == null ? [] : [{"address": self.gateway, "is": "the gateway"}]) + self.dns.map(a, {"address": a, "is": "a DNS server"}) + (self.boot == null || self.boot.server == null ? [] : [{"address": self.boot.server, "is": "boot's server"}]), cel.bind(r, self.reservations.filter(r, !(t.all(x, ip(x.address) != ip(r.address))))[0], cel.bind(x, t.filter(x, !(ip(x.address) != ip(r.address)))[0], "the reservation of " + r.mac + ", " + r.address + "," + " is " + x.is)))

Message of rule 11:

cel.bind(c, cidr(self.subnet), "the gateway " + self.gateway + " lies outside the subnet " + string(c))

Expression of rule 12:

cel.bind(c, cidr(self.subnet), self.gateway == null || !(c.ip(0).family() == "ipv4") || !(ip(self.gateway) == c.ip(0) || c.ip(0).family() == "ipv4" && ip(self.gateway) == c.last()))

Message of rule 12:

cel.bind(c, cidr(self.subnet), "the gateway, " + self.gateway + ", is the " + (ip(self.gateway) != c.ip(0) ? "broadcast address" : c.ip(0).family() == "ipv4" ? "network address" : "subnet-router anycast address") + " of the subnet " + string(c))

Expression of rule 13:

cel.bind(c, cidr(self.subnet), self.dns.all(a, ip(a).family() == c.ip(0).family() && !cidr("::ffff:0:0/96").contains(ip(a))))

Message of rule 13:

cel.bind(c, cidr(self.subnet), cel.bind(a, self.dns.filter(a, !(ip(a).family() == c.ip(0).family() && !cidr("::ffff:0:0/96").contains(ip(a))))[0], "the DNS server " + a + " is no " + (c.ip(0).family() == "ipv4" ? "IPv4" : "IPv6") + " address"))

Expression of rule 16:

cel.bind(c, cidr(self.subnet), self.prefixDelegation == null || cel.bind(d, cidr(self.prefixDelegation.prefix), !c.contains(d.ip(0)) && !d.contains(c.ip(0))))

Message of rule 16:

cel.bind(c, cidr(self.subnet), "prefixDelegation's prefix " + self.prefixDelegation.prefix + " overlaps the subnet " + string(c))

Message of rule 17:

cel.bind(c, cidr(self.subnet), "an IPv6 subnet is served on one link, the one Kea's subnet names; give each of " + self.interfaces.join(", ") + " a DHCPSubnet of its own")

Expression of rule 21:

int(self.substring(0, size(self) - 1)) * {"s": 1, "m": 60, "h": 3600, "d": 86400}[self.substring(size(self) - 1)] <= 4294967295

Expression of rule 22:

self == null || cel.bind(d, cidr(self.prefix), d.ip(0).family() == "ipv6" && !["::/8", "fe80::/10", "ff00::/8"].exists(r, cidr(r).contains(d.ip(0)) || d.contains(cidr(r).ip(0))) && self.length > d.prefix())

Message of rule 22:

"prefixDelegation's prefix " + self.prefix + " is no IPv6 range shorter than " + string(self.length) + " bits apart from ::/8, fe80::/10 and ff00::/8"

Expression of rule 23:

cel.bind(c, cidr(self), c.ip(0).family() == "ipv4" ? c.prefix() <= 30 && !["0.0.0.0/8", "127.0.0.0/8", "169.254.0.0/16", "224.0.0.0/3"].exists(r, cidr(r).contains(c.ip(0)) || c.contains(cidr(r).ip(0))) : c.prefix() <= 120 && !["::/8", "fe80::/10", "ff00::/8"].exists(r, cidr(r).contains(c.ip(0)) || c.contains(cidr(r).ip(0))))

Message of rule 23:

"the subnet " + self + " is no IPv4 range of 30 bits at most or IPv6 range of 120 bits at most of addresses a DHCP server leases"

FirewallPolicy

Rule Field Guards Takes Expression Message
1 — A FirewallPolicy comes from a FirewallZone, not from local. refuse documents.all(n, documents[n].spec.from != "local") after the table
2 spec.rules A rule's source and destination each name an AddressSet or address ranges, one of them. refuse self.all(r, [r.source, r.destination].all(m, m == null || (m.set == null) != (m.cidrs == null))) a rule's source or destination names both set and cidrs, or neither; give one, or leave the field out to match every address
3 spec.rules A rule with a family has addresses and sets of that family alone. refuse after the table a rule has addresses or a set of another family than its own
4 spec.rules A rule matches IPv4 or IPv6: its family, protocol, addresses and sets leave one. refuse after the table a rule matches no connection: its family, protocol, addresses and sets leave neither IPv4 nor IPv6
5 spec.rules Ports go with tcp, udp or sctp, ICMP types with icmp or icmpv6, and packet-too-big with icmpv6. refuse after the table a rule has ports without the protocol tcp, udp or sctp, or ICMP types its protocol lacks

Message of rule 1:

documents.filter(n, documents[n].spec.from == "local").map(n, "FirewallPolicy " + n).join(", ") + " comes from local, the router itself, whose own connections the firewall accepts; a policy comes from a FirewallZone"

Expression of rule 3:

self.all(r, r.family == null || (r.source == null || (r.source.set != null ? document("AddressSet", r.source.set).spec.family == r.family : r.source.cidrs == null || r.source.cidrs.all(a, cidr(a).ip(0).family() == r.family))) && (r.destination == null || (r.destination.set != null ? document("AddressSet", r.destination.set).spec.family == r.family : r.destination.cidrs == null || r.destination.cidrs.all(a, cidr(a).ip(0).family() == r.family))))

Expression of rule 4:

self.all(r, ((r.family == null || r.family == "ipv4") && r.protocol != "icmpv6" && (r.source == null || (r.source.set != null ? document("AddressSet", r.source.set).spec.family == "ipv4" : r.source.cidrs == null || r.source.cidrs.exists(a, cidr(a).ip(0).family() == "ipv4"))) && (r.destination == null || (r.destination.set != null ? document("AddressSet", r.destination.set).spec.family == "ipv4" : r.destination.cidrs == null || r.destination.cidrs.exists(a, cidr(a).ip(0).family() == "ipv4")))) || ((r.family == null || r.family == "ipv6") && r.protocol != "icmp" && (r.source == null || (r.source.set != null ? document("AddressSet", r.source.set).spec.family == "ipv6" : r.source.cidrs == null || r.source.cidrs.exists(a, cidr(a).ip(0).family() == "ipv6"))) && (r.destination == null || (r.destination.set != null ? document("AddressSet", r.destination.set).spec.family == "ipv6" : r.destination.cidrs == null || r.destination.cidrs.exists(a, cidr(a).ip(0).family() == "ipv6")))))

Expression of rule 5:

self.all(r, (size(r.sourcePorts) == 0 && size(r.destinationPorts) == 0 || r.protocol in ["tcp", "udp", "sctp"]) && (size(r.icmpTypes) == 0 || r.protocol in ["icmp", "icmpv6"]) && !(r.protocol == "icmp" && "packet-too-big" in r.icmpTypes))

FirewallZone

Rule Field Guards Takes Expression Message
1 — No FirewallZone is named local, the router itself. refuse !("local" in documents) a FirewallZone is named local, which is the router itself: FirewallPolicy documents name it without a document, so give the zone another name
2 — A FirewallZone names an interface or a VRF. refuse documents.all(n, size(documents[n].spec.interfaces) > 0 || size(documents[n].spec.vrfs) > 0) after the table

Message of rule 2:

documents.filter(n, size(documents[n].spec.interfaces) == 0 && size(documents[n].spec.vrfs) == 0).map(n, "FirewallZone " + n).join(", ") + ": a FirewallZone names an interface or a VRF; give it interfaces, vrfs or both"

NAT64

Rule Field Guards Takes Expression Message
1 — A NAT64's name has 11 characters at most, as its link n64-<name> is an interface's name of 15. refuse documents.all(n, size(n) <= 11) after the table
2 — No NAT64's pool holds a static address a Network document gives a link, which the router answers itself. refuse after the table after the table
3 — Beside NAT64s, no Network document gives a link a static address in 169.254.64.0/18, the range of the NAT64s' links. refuse after the table after the table
4 spec.pool4 A pool's entries are IPv4 ranges of 65536 addresses at most. refuse self.all(a, cidr(a.prefix).ip(0).family() == "ipv4" && cidr(a.prefix).prefix() >= 16) after the table
5 spec.pool4 A pool's entries hold no unspecified, loopback, multicast or broadcast address. refuse after the table after the table
6 spec.pool4 A pool's entries hold no link-local address; the NAT64s' links take 169.254.64.0/18. refuse self.all(a, !cidr("169.254.0.0/16").contains(cidr(a.prefix).ip(0))) after the table
7 spec.pool4 A pool entry's ports leave out the kernel's ephemeral ports, 32768 to 60999. refuse self.all(a, portRange(a.ports).last < 32768 || portRange(a.ports).first > 60999) after the table
8 spec.pool4 No two entries of a pool share a protocol, addresses and ports. refuse after the table after the table
9 spec.prefix A NAT64 prefix is an IPv6 range of 32, 40, 48, 56, 64 or 96 bits of no link-local, multicast or unspecified addresses, whose bits 64 to 71 are zero, as RFC 6052 gives them. refuse after the table after the table

Message of rule 1:

documents.filter(n, size(n) > 11).map(n, "NAT64 " + n).join(", ") + " has a name of more than 11 characters, which its link n64-<name> does not take as an interface's name; give it a shorter one"

Expression of rule 2:

cel.bind(e, documents.map(n, documents[n].spec.pool4.map(a, a.prefix)).flatten(), cel.bind(nets, (("networkd.chalkos.dev/v1alpha1" in config && "Network" in config["networkd.chalkos.dev/v1alpha1"]) ? config["networkd.chalkos.dev/v1alpha1"].Network : {}), cel.bind(net, nets.map(n, has(nets[n].spec.network) ? (type(nets[n].spec.network) == list ? nets[n].spec.network : [nets[n].spec.network]) : []).flatten(), cel.bind(addr, nets.map(n, has(nets[n].spec.address) ? (type(nets[n].spec.address) == list ? nets[n].spec.address : [nets[n].spec.address]) : []).flatten(), cel.bind(dhcp, nets.map(n, has(nets[n].spec.dhcpServer) ? (type(nets[n].spec.dhcpServer) == list ? nets[n].spec.dhcpServer : [nets[n].spec.dhcpServer]) : []).flatten(), cel.bind(values, dyn(net.map(s, has(s.address) ? (type(s.address) == list ? s.address : [s.address]) : []).flatten() + addr.map(s, has(s.address) ? (type(s.address) == list ? s.address : [s.address]) : []).flatten() + dhcp.map(s, has(s.serverAddress) ? (type(s.serverAddress) == list ? s.serverAddress : [s.serverAddress]) : []).flatten()), cel.bind(statics, values.filter(v, type(v) == string && v.trim().matches("^(25[0-5]|2[0-4][0-9]|1[0-9][0-9]|[1-9]?[0-9])([.](25[0-5]|2[0-4][0-9]|1[0-9][0-9]|[1-9]?[0-9])){3}(/(3[0-2]|[12]?[0-9]))?$")).map(v, v.trim().split("/")[0]), e.all(x, statics.all(a, !cidr(x).contains(ip(a)))))))))))

Message of rule 2:

cel.bind(e, documents.map(n, documents[n].spec.pool4.map(a, a.prefix)).flatten(), cel.bind(nets, (("networkd.chalkos.dev/v1alpha1" in config && "Network" in config["networkd.chalkos.dev/v1alpha1"]) ? config["networkd.chalkos.dev/v1alpha1"].Network : {}), cel.bind(net, nets.map(n, has(nets[n].spec.network) ? (type(nets[n].spec.network) == list ? nets[n].spec.network : [nets[n].spec.network]) : []).flatten(), cel.bind(addr, nets.map(n, has(nets[n].spec.address) ? (type(nets[n].spec.address) == list ? nets[n].spec.address : [nets[n].spec.address]) : []).flatten(), cel.bind(dhcp, nets.map(n, has(nets[n].spec.dhcpServer) ? (type(nets[n].spec.dhcpServer) == list ? nets[n].spec.dhcpServer : [nets[n].spec.dhcpServer]) : []).flatten(), cel.bind(values, dyn(net.map(s, has(s.address) ? (type(s.address) == list ? s.address : [s.address]) : []).flatten() + addr.map(s, has(s.address) ? (type(s.address) == list ? s.address : [s.address]) : []).flatten() + dhcp.map(s, has(s.serverAddress) ? (type(s.serverAddress) == list ? s.serverAddress : [s.serverAddress]) : []).flatten()), cel.bind(statics, values.filter(v, type(v) == string && v.trim().matches("^(25[0-5]|2[0-4][0-9]|1[0-9][0-9]|[1-9]?[0-9])([.](25[0-5]|2[0-4][0-9]|1[0-9][0-9]|[1-9]?[0-9])){3}(/(3[0-2]|[12]?[0-9]))?$")).map(v, v.trim().split("/")[0]), cel.bind(p, e.filter(x, statics.exists(a, cidr(x).contains(ip(a))))[0], "NAT64 " + documents.filter(n, documents[n].spec.pool4.exists(a, a.prefix == p))[0] + ": the pool entry " + string(cidr(p)) + " holds " + string(ip(statics.filter(a, cidr(p).contains(ip(a)))[0])) + ", an address a Network document gives a link; the router answers it itself, so leave pool4 empty to take the address of the link the connections leave through"))))))))

Expression of rule 3:

size(documents) == 0 || cel.bind(nets, (("networkd.chalkos.dev/v1alpha1" in config && "Network" in config["networkd.chalkos.dev/v1alpha1"]) ? config["networkd.chalkos.dev/v1alpha1"].Network : {}), cel.bind(net, nets.map(n, has(nets[n].spec.network) ? (type(nets[n].spec.network) == list ? nets[n].spec.network : [nets[n].spec.network]) : []).flatten(), cel.bind(addr, nets.map(n, has(nets[n].spec.address) ? (type(nets[n].spec.address) == list ? nets[n].spec.address : [nets[n].spec.address]) : []).flatten(), cel.bind(dhcp, nets.map(n, has(nets[n].spec.dhcpServer) ? (type(nets[n].spec.dhcpServer) == list ? nets[n].spec.dhcpServer : [nets[n].spec.dhcpServer]) : []).flatten(), cel.bind(values, dyn(net.map(s, has(s.address) ? (type(s.address) == list ? s.address : [s.address]) : []).flatten() + addr.map(s, has(s.address) ? (type(s.address) == list ? s.address : [s.address]) : []).flatten() + dhcp.map(s, has(s.serverAddress) ? (type(s.serverAddress) == list ? s.serverAddress : [s.serverAddress]) : []).flatten()), cel.bind(statics, values.filter(v, type(v) == string && v.trim().matches("^(25[0-5]|2[0-4][0-9]|1[0-9][0-9]|[1-9]?[0-9])([.](25[0-5]|2[0-4][0-9]|1[0-9][0-9]|[1-9]?[0-9])){3}(/(3[0-2]|[12]?[0-9]))?$")).map(v, v.trim().split("/")[0]), statics.all(a, !cidr("169.254.64.0/18").contains(ip(a)))))))))

Message of rule 3:

cel.bind(nets, (("networkd.chalkos.dev/v1alpha1" in config && "Network" in config["networkd.chalkos.dev/v1alpha1"]) ? config["networkd.chalkos.dev/v1alpha1"].Network : {}), cel.bind(net, nets.map(n, has(nets[n].spec.network) ? (type(nets[n].spec.network) == list ? nets[n].spec.network : [nets[n].spec.network]) : []).flatten(), cel.bind(addr, nets.map(n, has(nets[n].spec.address) ? (type(nets[n].spec.address) == list ? nets[n].spec.address : [nets[n].spec.address]) : []).flatten(), cel.bind(dhcp, nets.map(n, has(nets[n].spec.dhcpServer) ? (type(nets[n].spec.dhcpServer) == list ? nets[n].spec.dhcpServer : [nets[n].spec.dhcpServer]) : []).flatten(), cel.bind(values, dyn(net.map(s, has(s.address) ? (type(s.address) == list ? s.address : [s.address]) : []).flatten() + addr.map(s, has(s.address) ? (type(s.address) == list ? s.address : [s.address]) : []).flatten() + dhcp.map(s, has(s.serverAddress) ? (type(s.serverAddress) == list ? s.serverAddress : [s.serverAddress]) : []).flatten()), cel.bind(statics, values.filter(v, type(v) == string && v.trim().matches("^(25[0-5]|2[0-4][0-9]|1[0-9][0-9]|[1-9]?[0-9])([.](25[0-5]|2[0-4][0-9]|1[0-9][0-9]|[1-9]?[0-9])){3}(/(3[0-2]|[12]?[0-9]))?$")).map(v, v.trim().split("/")[0]), "a Network document gives a link the address " + string(ip(statics.filter(a, cidr("169.254.64.0/18").contains(ip(a)))[0])) + ", which lies in 169.254.64.0/18, the range of the NAT64s' links; give the link another address"))))))

Message of rule 4:

"the pool entry " + self.filter(a, !(cidr(a.prefix).ip(0).family() == "ipv4" && cidr(a.prefix).prefix() >= 16))[0].prefix + " is no IPv4 range of 16 bits or more"

Expression of rule 5:

self.all(a, cel.bind(c, cidr(a.prefix), c.ip(0).family() != "ipv4" || c.ip(0) != ip("0.0.0.0") && !cidr("127.0.0.0/8").contains(c.ip(0)) && !cidr("224.0.0.0/4").contains(c.ip(0)) && !c.contains(ip("255.255.255.255"))))

Message of rule 5:

"the pool entry " + self.filter(a, !cel.bind(c, cidr(a.prefix), c.ip(0).family() != "ipv4" || c.ip(0) != ip("0.0.0.0") && !cidr("127.0.0.0/8").contains(c.ip(0)) && !cidr("224.0.0.0/4").contains(c.ip(0)) && !c.contains(ip("255.255.255.255"))))[0].prefix + " holds addresses no connection leaves from: the unspecified address, loopback, multicast or broadcast"

Message of rule 6:

"the pool entry " + self.filter(a, cidr("169.254.0.0/16").contains(cidr(a.prefix).ip(0)))[0].prefix + " holds link-local addresses, which the NAT64s' links take"

Message of rule 7:

"a pool entry takes the ports " + string(self.filter(a, !(portRange(a.ports).last < 32768 || portRange(a.ports).first > 60999))[0].ports) + ", which touch the kernel's ephemeral ports, 32768 to 60999, which Jool refuses; give ports from 1 to 32767 or from 61000 to 65535"

Expression of rule 8:

cel.bind(e, self.map(a, ["tcp", "udp", "icmp"].filter(p, p in a.protocols).map(p, [p, a.prefix, portRange(a.ports).first, portRange(a.ports).last])).flatten(), e.all(x, size(e.filter(y, x[0] == y[0] && (cidr(x[1]).contains(cidr(y[1]).ip(0)) || cidr(y[1]).contains(cidr(x[1]).ip(0))) && x[2] <= y[3] && y[2] <= x[3])) <= 1))

Message of rule 8:

cel.bind(e, self.map(a, ["tcp", "udp", "icmp"].filter(p, p in a.protocols).map(p, [p, a.prefix, portRange(a.ports).first, portRange(a.ports).last])).flatten(), cel.bind(x, e.filter(x, size(e.filter(y, x[0] == y[0] && (cidr(x[1]).contains(cidr(y[1]).ip(0)) || cidr(y[1]).contains(cidr(x[1]).ip(0))) && x[2] <= y[3] && y[2] <= x[3])) > 1)[0], "the pool entry " + x[1] + " shares " + x[0] + " addresses and ports with another; give each entry of a protocol addresses or ports of its own"))

Expression of rule 9:

cidr(self).ip(0).family() == "ipv6" && cidr(self).prefix() in [32, 40, 48, 56, 64, 96] && !cidr("::ffff:0:0/96").contains(cidr(self).ip(0)) && cel.bind(x, cidr(self).ip(0), x != ip("::") && !cidr("fe80::/10").contains(x) && !cidr("ff00::/8").contains(x)) && cel.bind(a, string(cidr(self).ip(0)), cidr(a + "/72").ip(0) == cidr(a + "/64").ip(0))

Message of rule 9:

!(cidr(self).ip(0).family() == "ipv6" && cidr(self).prefix() in [32, 40, 48, 56, 64, 96] && !cidr("::ffff:0:0/96").contains(cidr(self).ip(0))) ? "the prefix " + self + " is no NAT64 prefix; give an IPv6 range of 32, 40, 48, 56, 64 or 96 bits, such as 64:ff9b::/96" : !cel.bind(x, cidr(self).ip(0), x != ip("::") && !cidr("fe80::/10").contains(x) && !cidr("ff00::/8").contains(x)) ? "the prefix " + self + " holds link-local, multicast or unspecified addresses" : "the prefix " + self + " sets bits 64 to 71, which RFC 6052 keeps zero"

NATRule

Rule Field Guards Takes Expression Message
1 — masquerade and snat name out alone, dnat names in alone. refuse after the table after the table
2 — out and in name a zone or an interface, one of them. refuse after the table after the table
3 — snat and dnat give to, masquerade does not. refuse documents.all(n, (documents[n].spec.type == "masquerade") == (documents[n].spec.to == null)) after the table
4 — A NATRule's addresses are of its family. refuse after the table after the table
5 — Ports go with match.protocol. refuse after the table after the table

Expression of rule 1:

documents.all(n, cel.bind(s, documents[n].spec, s.type == "dnat" ? s["in"] != null && s.out == null : s.out != null && s["in"] == null))

Message of rule 1:

documents.filter(n, cel.bind(s, documents[n].spec, !(s.type == "dnat" ? s["in"] != null && s.out == null : s.out != null && s["in"] == null))).map(n, "NATRule " + n).join(", ") + ": a masquerade or snat rule names out alone, a dnat rule in alone"

Expression of rule 2:

documents.all(n, [documents[n].spec.out, documents[n].spec["in"]].all(p, p == null || (p.zone == null) != (p.interface == null)))

Message of rule 2:

documents.filter(n, ![documents[n].spec.out, documents[n].spec["in"]].all(p, p == null || (p.zone == null) != (p.interface == null))).map(n, "NATRule " + n).join(", ") + ": out and in name a zone or an interface, one of them"

Message of rule 3:

documents.filter(n, (documents[n].spec.type == "masquerade") != (documents[n].spec.to == null)).map(n, "NATRule " + n).join(", ") + ": snat and dnat translate to the address of to, masquerade to that of the interface and has no to"

Expression of rule 4:

documents.all(n, cel.bind(s, documents[n].spec, (s.match.source + s.match.destination).all(a, cidr(a).ip(0).family() == s.family) && (s.to == null || ip(s.to.address).family() == s.family)))

Message of rule 4:

documents.filter(n, cel.bind(s, documents[n].spec, !((s.match.source + s.match.destination).all(a, cidr(a).ip(0).family() == s.family) && (s.to == null || ip(s.to.address).family() == s.family)))).map(n, "NATRule " + n + " has addresses of another family than " + documents[n].spec.family).join("; ")

Expression of rule 5:

documents.all(n, cel.bind(s, documents[n].spec, s.match.protocol != null || size(s.match.destinationPorts) == 0 && (s.to == null || s.to.port == null)))

Message of rule 5:

documents.filter(n, cel.bind(s, documents[n].spec, s.match.protocol == null && (size(s.match.destinationPorts) > 0 || s.to != null && s.to.port != null))).map(n, "NATRule " + n).join(", ") + ": ports need match.protocol"

NextHop

Rule Field Guards Takes Expression Message
1 spec.address A NextHop's address is a unicast address: not unspecified, loopback, multicast, broadcast or IPv4-mapped IPv6. refuse after the table after the table
2 spec.interface A NextHop's interface is not lo. refuse self != "lo" the interface is lo, which no next hop is on; name the link the next hop is on
3 spec.table A NextHop's table is none of 253, 254 and 255, the kernel's own. refuse !(self in [253, 254, 255]) the table is 253, 254 or 255, the kernel's own; give the NextHop a table of its own
4 spec.table A NextHop's table is no VRF's table. refuse after the table after the table

Expression of rule 1:

cel.bind(x, ip(self), x != ip("0.0.0.0") && x != ip("::") && !cidr("127.0.0.0/8").contains(x) && x != ip("::1") && !cidr("224.0.0.0/4").contains(x) && !cidr("ff00::/8").contains(x) && x != ip("255.255.255.255") && !cidr("::ffff:0:0/96").contains(x))

Message of rule 1:

"the next hop " + self + " is no unicast address of a router, or is an IPv4-mapped IPv6 address; give the router's address, an IPv4 one as IPv4"

Expression of rule 4:

cel.bind(v, (("router.chalkos.dev/v1alpha1" in config && "VRF" in config["router.chalkos.dev/v1alpha1"]) ? config["router.chalkos.dev/v1alpha1"].VRF : {}), cel.bind(tables, v.map(n, v[n].spec.table), !(self in tables)))

Message of rule 4:

cel.bind(v, (("router.chalkos.dev/v1alpha1" in config && "VRF" in config["router.chalkos.dev/v1alpha1"]) ? config["router.chalkos.dev/v1alpha1"].VRF : {}), "the table is that of VRF " + v.filter(n, v[n].spec.table == self)[0] + "; give the NextHop a table of its own")

PolicyRoute

Rule Field Guards Takes Expression Message
1 — A PolicyRoute's in names a zone or interfaces, one of them. refuse after the table after the table
2 spec.rules A rule's source and destination each name an AddressSet or address ranges, one of them. refuse after the table a rule's source or destination names both set and cidrs, or neither; give one, or leave the field out to match every address
3 spec.rules A rule with a family has addresses and sets of that family alone. refuse after the table a rule has addresses or a set of another family than its own
4 spec.rules A rule matches IPv4 or IPv6: its family, protocol, addresses and sets leave one. refuse after the table a rule matches no packet: its family, protocol, addresses and sets leave neither IPv4 nor IPv6
5 spec.rules Ports go with tcp, udp or sctp. refuse after the table a rule has ports without the protocol tcp, udp or sctp
6 spec.rules A rule matches by one term at least. refuse after the table a rule has an empty match, which would take every packet; to send every packet, say so, such as with source:
7 spec.rules A rule's to names a VRF, a table or a next hop, one of them. refuse after the table a rule's to names a VRF, a table or a next hop, one of them
8 spec.rules A rule with a next hop matches packets of the NextHop's family. refuse after the table a rule's next hop is of another family than the packets the rule matches
9 spec.rules A rule's table is not 255, the kernel's local table, and no VRF's table. refuse after the table a rule's table is 255, the kernel's local table, or a VRF's table; name the VRF in vrf, or take another table
10 spec.rules A rule's table is no NextHop's table, which holds the NextHop's routes alone. refuse after the table after the table

Expression of rule 1:

documents.all(n, [dyn(documents[n].spec["in"])].all(i, i == null || (i.zone == null) != (size(i.interfaces) == 0)))

Message of rule 1:

documents.filter(n, [dyn(documents[n].spec["in"])].exists(i, i != null && (i.zone == null) == (size(i.interfaces) == 0))).map(n, "PolicyRoute " + n).join(", ") + ": in names a zone or interfaces, one of them; leave in out for traffic from every link"

Expression of rule 2:

self.all(p, cel.bind(r, p.match, [r.source, r.destination].all(m, m == null || (m.set == null) != (m.cidrs == null))))

Expression of rule 3:

self.all(p, cel.bind(r, p.match, r.family == null || (r.source == null || (r.source.set != null ? document("AddressSet", r.source.set).spec.family == r.family : r.source.cidrs == null || r.source.cidrs.all(a, cidr(a).ip(0).family() == r.family))) && (r.destination == null || (r.destination.set != null ? document("AddressSet", r.destination.set).spec.family == r.family : r.destination.cidrs == null || r.destination.cidrs.all(a, cidr(a).ip(0).family() == r.family)))))

Expression of rule 4:

self.all(p, cel.bind(r, p.match, ((r.family == null || r.family == "ipv4") && r.protocol != "icmpv6" && (r.source == null || (r.source.set != null ? document("AddressSet", r.source.set).spec.family == "ipv4" : r.source.cidrs == null || r.source.cidrs.exists(a, cidr(a).ip(0).family() == "ipv4"))) && (r.destination == null || (r.destination.set != null ? document("AddressSet", r.destination.set).spec.family == "ipv4" : r.destination.cidrs == null || r.destination.cidrs.exists(a, cidr(a).ip(0).family() == "ipv4")))) || ((r.family == null || r.family == "ipv6") && r.protocol != "icmp" && (r.source == null || (r.source.set != null ? document("AddressSet", r.source.set).spec.family == "ipv6" : r.source.cidrs == null || r.source.cidrs.exists(a, cidr(a).ip(0).family() == "ipv6"))) && (r.destination == null || (r.destination.set != null ? document("AddressSet", r.destination.set).spec.family == "ipv6" : r.destination.cidrs == null || r.destination.cidrs.exists(a, cidr(a).ip(0).family() == "ipv6"))))))

Expression of rule 5:

self.all(p, cel.bind(r, p.match, size(r.sourcePorts) == 0 && size(r.destinationPorts) == 0 || r.protocol in ["tcp", "udp", "sctp"]))

Expression of rule 6:

self.all(p, cel.bind(r, p.match, r.family != null || r.protocol != null || r.source != null || r.destination != null || size(r.sourcePorts) > 0 || size(r.destinationPorts) > 0 || size(r.dscp) > 0))

Expression of rule 7:

self.all(p, cel.bind(r, p.match, (p.to.vrf == null ? 0 : 1) + (p.to.table == null ? 0 : 1) + (p.to.nextHop == null ? 0 : 1) == 1))

Expression of rule 8:

self.all(p, cel.bind(r, p.match, p.to.nextHop == null || (ip(document("NextHop", p.to.nextHop).spec.address).family() == "ipv4" ? ((r.family == null || r.family == "ipv4") && r.protocol != "icmpv6" && (r.source == null || (r.source.set != null ? document("AddressSet", r.source.set).spec.family == "ipv4" : r.source.cidrs == null || r.source.cidrs.exists(a, cidr(a).ip(0).family() == "ipv4"))) && (r.destination == null || (r.destination.set != null ? document("AddressSet", r.destination.set).spec.family == "ipv4" : r.destination.cidrs == null || r.destination.cidrs.exists(a, cidr(a).ip(0).family() == "ipv4")))) : ((r.family == null || r.family == "ipv6") && r.protocol != "icmp" && (r.source == null || (r.source.set != null ? document("AddressSet", r.source.set).spec.family == "ipv6" : r.source.cidrs == null || r.source.cidrs.exists(a, cidr(a).ip(0).family() == "ipv6"))) && (r.destination == null || (r.destination.set != null ? document("AddressSet", r.destination.set).spec.family == "ipv6" : r.destination.cidrs == null || r.destination.cidrs.exists(a, cidr(a).ip(0).family() == "ipv6")))))))

Expression of rule 9:

cel.bind(v, (("router.chalkos.dev/v1alpha1" in config && "VRF" in config["router.chalkos.dev/v1alpha1"]) ? config["router.chalkos.dev/v1alpha1"].VRF : {}), cel.bind(tables, v.map(n, v[n].spec.table), self.all(p, p.to.table == null || p.to.table != 255 && !(p.to.table in tables))))

Expression of rule 10:

cel.bind(h, (("router.chalkos.dev/v1alpha1" in config && "NextHop" in config["router.chalkos.dev/v1alpha1"]) ? config["router.chalkos.dev/v1alpha1"].NextHop : {}), cel.bind(tables, h.map(n, h[n].spec.table), self.all(p, p.to.table == null || !(p.to.table in tables))))

Message of rule 10:

cel.bind(h, (("router.chalkos.dev/v1alpha1" in config && "NextHop" in config["router.chalkos.dev/v1alpha1"]) ? config["router.chalkos.dev/v1alpha1"].NextHop : {}), cel.bind(tables, h.map(n, h[n].spec.table), cel.bind(t, self.filter(p, p.to.table != null && p.to.table in tables)[0].to.table, "a rule's table " + string(t) + " is the table of NextHop " + h.filter(n, h[n].spec.table == t)[0] + "; name the NextHop in nextHop, or take another table")))

PrefixList

Rule Field Guards Takes Expression Message
1 — A PrefixList's entries are of its family, with ge and le from the prefix length to the family's longest prefix, ge no more than le. refuse after the table after the table

Expression of rule 1:

documents.all(n, cel.bind(s, documents[n].spec, s.entries.all(e, cel.bind(c, cidr(e.prefix), cel.bind(max, s.family == "ipv4" ? 32 : 128, c.ip(0).family() == s.family && (e.ge == null || e.ge >= c.prefix() && e.ge <= max) && (e.le == null || e.le >= c.prefix() && e.le <= max) && (e.ge == null || e.le == null || e.ge <= e.le))))))

Message of rule 1:

documents.filter(n, cel.bind(s, documents[n].spec, !s.entries.all(e, cel.bind(c, cidr(e.prefix), cel.bind(max, s.family == "ipv4" ? 32 : 128, c.ip(0).family() == s.family && (e.ge == null || e.ge >= c.prefix() && e.ge <= max) && (e.le == null || e.le >= c.prefix() && e.le <= max) && (e.ge == null || e.le == null || e.ge <= e.le)))))).map(n, "PrefixList " + n).join(", ") + " has an entry of another family, or a ge or le outside its range: both lie from the prefix length to 32 for IPv4 or 128 for IPv6, and ge no higher than le"

Resolver

Rule Field Guards Takes Expression Message
1 — A Resolver listens on an address of a family its clients' ranges are of. refuse after the table after the table
2 — With DNS64, no local zone holds ipv4only.arpa, which Unbound would answer before DNS64. refuse after the table after the table
3 spec.dns64 A NAT64 prefix is an IPv6 range of 32, 40, 48, 56, 64 or 96 bits of no link-local, multicast or unspecified addresses, whose bits 64 to 71 are zero, as RFC 6052 gives them. refuse after the table after the table
4 spec.forwarders The resolver forwards to unicast addresses. refuse after the table after the table
5 spec.listen The resolver listens on unicast addresses. refuse after the table after the table
6 spec.localZones A local zone's records are of the zone's name or names below it. refuse self.all(z, z.records.all(r, r.name == z.name || r.name.endsWith("." + z.name))) after the table
7 spec.localZones The names of local zones and their records are DNS names of 253 characters at most. refuse self.all(z, isDNSName(z.name)) && self.map(z, z.records).flatten().all(r, isDNSName(r.name)) after the table
8 spec.localZones A record holds data of its type: an address of its family for A and AAAA, a DNS name for CNAME and PTR, numbers and a DNS name for MX and SRV, and text for TXT. refuse self.map(z, z.records).flatten().all(r, isRecordData(r.type, r.value)) after the table
9 spec.localZones A redirect zone's records are of the zone's name, which Unbound answers for every name below it. refuse self.all(z, z.type != "redirect" || z.records.all(r, r.name == z.name)) after the table

Expression of rule 1:

documents.all(n, cel.bind(s, documents[n].spec, ["ipv4", "ipv6"].exists(f, s.listen.exists(a, ip(a).family() == f) && s.allow.exists(p, cidr(p).ip(0).family() == f))))

Message of rule 1:

documents.filter(n, !cel.bind(s, documents[n].spec, ["ipv4", "ipv6"].exists(f, s.listen.exists(a, ip(a).family() == f) && s.allow.exists(p, cidr(p).ip(0).family() == f)))).map(n, "Resolver " + n).join(", ") + " listens on no address of a family its clients' ranges are of, so it would answer no one; give listen and allow a family in common"

Expression of rule 2:

documents.all(n, cel.bind(s, documents[n].spec, s.dns64 == null || !s.localZones.exists(z, (z.name == "ipv4only.arpa" || z.name.endsWith(".ipv4only.arpa") || "ipv4only.arpa".endsWith("." + z.name)))))

Message of rule 2:

documents.filter(n, cel.bind(s, documents[n].spec, s.dns64 != null && s.localZones.exists(z, (z.name == "ipv4only.arpa" || z.name.endsWith(".ipv4only.arpa") || "ipv4only.arpa".endsWith("." + z.name))))).map(n, "Resolver " + n).join(", ") + " has a local zone over ipv4only.arpa, which Unbound would answer before DNS64; drop the zone or DNS64"

Expression of rule 3:

self == null || (cidr(self.prefix).ip(0).family() == "ipv6" && cidr(self.prefix).prefix() in [32, 40, 48, 56, 64, 96] && !cidr("::ffff:0:0/96").contains(cidr(self.prefix).ip(0)) && cel.bind(x, cidr(self.prefix).ip(0), x != ip("::") && !cidr("fe80::/10").contains(x) && !cidr("ff00::/8").contains(x)) && cel.bind(a, string(cidr(self.prefix).ip(0)), cidr(a + "/72").ip(0) == cidr(a + "/64").ip(0)))

Message of rule 3:

!(cidr(self.prefix).ip(0).family() == "ipv6" && cidr(self.prefix).prefix() in [32, 40, 48, 56, 64, 96] && !cidr("::ffff:0:0/96").contains(cidr(self.prefix).ip(0))) ? "the prefix " + self.prefix + " is no NAT64 prefix; give an IPv6 range of 32, 40, 48, 56, 64 or 96 bits, such as 64:ff9b::/96" : !cel.bind(x, cidr(self.prefix).ip(0), x != ip("::") && !cidr("fe80::/10").contains(x) && !cidr("ff00::/8").contains(x)) ? "the prefix " + self.prefix + " holds link-local, multicast or unspecified addresses" : "the prefix " + self.prefix + " sets bits 64 to 71, which RFC 6052 keeps zero"

Expression of rule 4:

self.all(a, cel.bind(x, ip(a), x != ip("0.0.0.0") && x != ip("::") && !cidr("127.0.0.0/8").contains(x) && x != ip("::1") && !cidr("169.254.0.0/16").contains(x) && !cidr("fe80::/10").contains(x) && !cidr("224.0.0.0/4").contains(x) && !cidr("ff00::/8").contains(x) && !cidr("::ffff:0:0/96").contains(x)))

Message of rule 4:

"the forwarder " + self.filter(a, !cel.bind(x, ip(a), x != ip("0.0.0.0") && x != ip("::") && !cidr("127.0.0.0/8").contains(x) && x != ip("::1") && !cidr("169.254.0.0/16").contains(x) && !cidr("fe80::/10").contains(x) && !cidr("224.0.0.0/4").contains(x) && !cidr("ff00::/8").contains(x) && !cidr("::ffff:0:0/96").contains(x)))[0] + " is no unicast address"

Expression of rule 5:

self.all(a, cel.bind(x, ip(a), x != ip("0.0.0.0") && x != ip("::") && !cidr("127.0.0.0/8").contains(x) && x != ip("::1") && !cidr("169.254.0.0/16").contains(x) && !cidr("fe80::/10").contains(x) && !cidr("224.0.0.0/4").contains(x) && !cidr("ff00::/8").contains(x) && !cidr("::ffff:0:0/96").contains(x)))

Message of rule 5:

"the address " + self.filter(a, !cel.bind(x, ip(a), x != ip("0.0.0.0") && x != ip("::") && !cidr("127.0.0.0/8").contains(x) && x != ip("::1") && !cidr("169.254.0.0/16").contains(x) && !cidr("fe80::/10").contains(x) && !cidr("224.0.0.0/4").contains(x) && !cidr("ff00::/8").contains(x) && !cidr("::ffff:0:0/96").contains(x)))[0] + " is no unicast address the resolver can listen on"

Message of rule 6:

cel.bind(z, self.filter(z, !z.records.all(r, r.name == z.name || r.name.endsWith("." + z.name)))[0], "the local zone " + z.name + " holds a record of " + z.records.filter(r, !(r.name == z.name || r.name.endsWith("." + z.name)))[0].name + ", which is outside it")

Message of rule 7:

"the name " + (self.map(z, z.name) + self.map(z, z.records).flatten().map(r, r.name)).filter(n, !isDNSName(n))[0] + " holds more than 253 characters"

Message of rule 8:

cel.bind(r, self.map(z, z.records).flatten().filter(r, !isRecordData(r.type, r.value))[0], "the " + r.type + " record of " + r.name + " holds " + r.value + ", which is no " + {"A": "IPv4 address", "AAAA": "IPv6 address", "CNAME": "DNS name in lower case without the root's dot", "PTR": "DNS name in lower case without the root's dot", "MX": "preference from 0 to 65535 and DNS name, a single space apart", "SRV": "priority, weight and port from 0 to 65535 and DNS name, a single space apart", "TXT": "text of 1 to 255 printable characters without quotes or backslashes"}[r.type])

Message of rule 9:

cel.bind(z, self.filter(z, z.type == "redirect" && !z.records.all(r, r.name == z.name))[0], "the redirect zone " + z.name + " holds a record of " + z.records.filter(r, r.name != z.name)[0].name + "; a redirect zone's records are of its own name, which Unbound answers for every name below it")

Router

Rule Field Guards Takes Expression Message
1 spec.management.interfaces A delivery that keeps the management interfaces keeps a Network naming each management interface that a running Network names, in a [Match] section's Name=; a glob names every interface its prefix starts, so with * a delivery keeps one Network at least. refuse after the table after the table

Expression of rule 1:

self != oldSelf || oldSelf == null || cel.bind(was, cel.bind(nets, (("networkd.chalkos.dev/v1alpha1" in oldConfig && "Network" in oldConfig["networkd.chalkos.dev/v1alpha1"]) ? oldConfig["networkd.chalkos.dev/v1alpha1"].Network : {}), cel.bind(matches, dyn(nets.map(n, "match" in nets[n].spec ? (type(nets[n].spec.match) == list ? nets[n].spec.match : [nets[n].spec.match]) : []).flatten()), " " + dyn(matches.map(m, "name" in m ? (type(m.name) == list ? m.name : [m.name]) : []).flatten()).join(" ").replace("\t", " ") + " ")), cel.bind(gets, cel.bind(nets, (("networkd.chalkos.dev/v1alpha1" in config && "Network" in config["networkd.chalkos.dev/v1alpha1"]) ? config["networkd.chalkos.dev/v1alpha1"].Network : {}), cel.bind(matches, dyn(nets.map(n, "match" in nets[n].spec ? (type(nets[n].spec.match) == list ? nets[n].spec.match : [nets[n].spec.match]) : []).flatten()), " " + dyn(matches.map(m, "name" in m ? (type(m.name) == list ? m.name : [m.name]) : []).flatten()).join(" ").replace("\t", " ") + " ")), cel.bind(lost, oldSelf.filter(i, cel.bind(globs, [0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15].filter(k, k < size(i) || k == size(i) && !i.endsWith("*")).map(k, i.substring(0, k).replace(".", "[.]")).join("|"), (was.contains(" " + i + " ") || i.endsWith("*") && (size(i) > 1 ? was.contains(" " + i.substring(0, size(i) - 1)) : was.trim() != "") || was.matches(" (" + globs + ")[*] ")) && !(gets.contains(" " + i + " ") || i.endsWith("*") && (size(i) > 1 ? gets.contains(" " + i.substring(0, size(i) - 1)) : gets.trim() != "") || gets.matches(" (" + globs + ")[*] ")))), size(lost) == 0)))

Message of rule 1:

cel.bind(was, cel.bind(nets, (("networkd.chalkos.dev/v1alpha1" in oldConfig && "Network" in oldConfig["networkd.chalkos.dev/v1alpha1"]) ? oldConfig["networkd.chalkos.dev/v1alpha1"].Network : {}), cel.bind(matches, dyn(nets.map(n, "match" in nets[n].spec ? (type(nets[n].spec.match) == list ? nets[n].spec.match : [nets[n].spec.match]) : []).flatten()), " " + dyn(matches.map(m, "name" in m ? (type(m.name) == list ? m.name : [m.name]) : []).flatten()).join(" ").replace("\t", " ") + " ")), cel.bind(gets, cel.bind(nets, (("networkd.chalkos.dev/v1alpha1" in config && "Network" in config["networkd.chalkos.dev/v1alpha1"]) ? config["networkd.chalkos.dev/v1alpha1"].Network : {}), cel.bind(matches, dyn(nets.map(n, "match" in nets[n].spec ? (type(nets[n].spec.match) == list ? nets[n].spec.match : [nets[n].spec.match]) : []).flatten()), " " + dyn(matches.map(m, "name" in m ? (type(m.name) == list ? m.name : [m.name]) : []).flatten()).join(" ").replace("\t", " ") + " ")), cel.bind(lost, oldSelf.filter(i, cel.bind(globs, [0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15].filter(k, k < size(i) || k == size(i) && !i.endsWith("*")).map(k, i.substring(0, k).replace(".", "[.]")).join("|"), (was.contains(" " + i + " ") || i.endsWith("*") && (size(i) > 1 ? was.contains(" " + i.substring(0, size(i) - 1)) : was.trim() != "") || was.matches(" (" + globs + ")[*] ")) && !(gets.contains(" " + i + " ") || i.endsWith("*") && (size(i) > 1 ? gets.contains(" " + i.substring(0, size(i) - 1)) : gets.trim() != "") || gets.matches(" (" + globs + ")[*] ")))), "the config leaves the management interfaces " + lost.join(", ") + " without a Network document that matches them, so the router would no longer configure them; keep a Network that matches each, or change spec.management.interfaces in the same delivery")))

RoutingPolicy

Rule Field Guards Takes Expression Message
1 spec.terms A RoutingPolicy holds 6000 terms at most. refuse size(self) <= 6000 after the table
2 spec.terms A term's asPath holds 200 characters at most. refuse self.all(t, t.match.asPath == null || size(t.match.asPath) <= 200) a term's asPath holds more than 200 characters
3 spec.terms A RoutingPolicy's PrefixLists are of one family. refuse after the table the terms match PrefixLists of both families; a policy serves the routes of one family, so give each family a policy of its own
4 spec.terms A term that rejects sets nothing. refuse after the table a term that rejects routes sets local preference, MED, communities or a prepend, which no route it rejects keeps; drop them or accept

Message of rule 1:

"the policy holds " + string(size(self)) + " terms; a route-map holds 6000 terms at most, numbered 10, 20 and on below its default's 65535"

Expression of rule 3:

cel.bind(families, self.filter(t, t.match.prefixList != null).map(t, document("PrefixList", t.match.prefixList).spec.family), families.all(f, f == families[0]))

Expression of rule 4:

self.all(t, t["then"].action == "accept" || t["then"].localPref == null && t["then"].med == null && size(t["then"].addCommunities) == 0 && size(t["then"].removeCommunities) == 0 && t["then"].prepend == null)

TimeServer

Rule Field Guards Takes Expression Message
1 — A TimeServer listens on an address of a family its clients' ranges are of. refuse after the table after the table
2 spec.listen The time server listens on unicast addresses. refuse after the table after the table

Expression of rule 1:

documents.all(n, cel.bind(s, documents[n].spec, ["ipv4", "ipv6"].exists(f, s.listen.exists(a, ip(a).family() == f) && s.allow.exists(p, cidr(p).ip(0).family() == f))))

Message of rule 1:

documents.filter(n, !cel.bind(s, documents[n].spec, ["ipv4", "ipv6"].exists(f, s.listen.exists(a, ip(a).family() == f) && s.allow.exists(p, cidr(p).ip(0).family() == f)))).map(n, "TimeServer " + n).join(", ") + " listens on no address of a family its clients' ranges are of, so it would answer no one; give listen and allow a family in common"

Expression of rule 2:

self.all(a, cel.bind(x, ip(a), x != ip("0.0.0.0") && x != ip("::") && !cidr("127.0.0.0/8").contains(x) && x != ip("::1") && !cidr("169.254.0.0/16").contains(x) && !cidr("fe80::/10").contains(x) && !cidr("224.0.0.0/4").contains(x) && !cidr("ff00::/8").contains(x) && !cidr("::ffff:0:0/96").contains(x)))

Message of rule 2:

"the address " + self.filter(a, !cel.bind(x, ip(a), x != ip("0.0.0.0") && x != ip("::") && !cidr("127.0.0.0/8").contains(x) && x != ip("::1") && !cidr("169.254.0.0/16").contains(x) && !cidr("fe80::/10").contains(x) && !cidr("224.0.0.0/4").contains(x) && !cidr("ff00::/8").contains(x) && !cidr("::ffff:0:0/96").contains(x)))[0] + " is no unicast address the time server can listen on"

VRF

Rule Field Guards Takes Expression Message
1 — A VRF is named as its device, in 15 characters at most, and not default. refuse documents.all(n, n != "default" && size(n) <= 15) after the table
2 — A VRF's name does not start with n64-, which starts the names of the NAT64s' links. refuse documents.all(n, !n.startsWith("n64-")) after the table
3 — A VRF's table is none of the kernel's own: 253, 254 and 255. refuse documents.all(n, !(documents[n].spec.table in [253, 254, 255])) after the table
4 — While the node API answers on every interface, a Network document names a link that no VRF holds; globs match as globs. refuse after the table every link the Network documents name is in a VRF, and chalkd answers in the default VRF alone, on every interface while Router.spec.management.interfaces is null; keep the link you reach the router through out of every VRF
5 — A VRF with a conntrack zone neither imports routes from another VRF nor gives its routes to one, through BGP. refuse after the table after the table

Message of rule 1:

documents.filter(n, n == "default" || size(n) > 15).map(n, "VRF " + n).join(", ") + ": a VRF is named as its device, in 15 characters at most, and default names the VRF of every link no VRF holds"

Message of rule 2:

documents.filter(n, n.startsWith("n64-")).map(n, "VRF " + n).join(", ") + ": n64- starts the names of the NAT64s' links; give the VRF another name"

Message of rule 3:

documents.filter(n, documents[n].spec.table in [253, 254, 255]).map(n, "VRF " + n).join(", ") + " uses table 253, 254 or 255, which the kernel keeps for the default VRF; give it another number"

Expression of rule 4:

size(documents) == 0 || cel.bind(routers, (("router.chalkos.dev/v1alpha1" in config && "Router" in config["router.chalkos.dev/v1alpha1"]) ? config["router.chalkos.dev/v1alpha1"].Router : {}), routers.exists(k, routers[k].spec.management.interfaces != null)) || cel.bind(held, documents.map(n, documents[n].spec.interfaces).flatten(), !cel.bind(nets, (("networkd.chalkos.dev/v1alpha1" in config && "Network" in config["networkd.chalkos.dev/v1alpha1"]) ? config["networkd.chalkos.dev/v1alpha1"].Network : {}), cel.bind(matches, dyn(nets.map(n, "match" in nets[n].spec ? (type(nets[n].spec.match) == list ? nets[n].spec.match : [nets[n].spec.match]) : []).flatten()), " " + dyn(matches.map(m, "name" in m ? (type(m.name) == list ? m.name : [m.name]) : []).flatten()).join(" ").replace("\t", " ") + " ")).matches("^( +(" + held.map(i, i.replace(".", "[.]").replace("*", "[^ ]*")).join("|") + "|![^ ]*))* *$"))

Expression of rule 5:

cel.bind(bgps, (("router.chalkos.dev/v1alpha1" in config && "BGP" in config["router.chalkos.dev/v1alpha1"]) ? config["router.chalkos.dev/v1alpha1"].BGP : {}), cel.bind(families, bgps.map(n, [bgps[n].spec["import"].ipv4, bgps[n].spec["import"].ipv6]).flatten(), cel.bind(importers, bgps.filter(n, bgps[n].spec["import"].ipv4 != null || bgps[n].spec["import"].ipv6 != null).map(n, bgps[n].spec.vrf), cel.bind(imported, families.filter(f, f != null).map(f, f.vrfs).flatten(), documents.all(n, documents[n].spec.conntrackZone == null || !(n in importers) && !(n in imported))))))

Message of rule 5:

cel.bind(bgps, (("router.chalkos.dev/v1alpha1" in config && "BGP" in config["router.chalkos.dev/v1alpha1"]) ? config["router.chalkos.dev/v1alpha1"].BGP : {}), cel.bind(families, bgps.map(n, [bgps[n].spec["import"].ipv4, bgps[n].spec["import"].ipv6]).flatten(), cel.bind(importers, bgps.filter(n, bgps[n].spec["import"].ipv4 != null || bgps[n].spec["import"].ipv6 != null).map(n, bgps[n].spec.vrf), cel.bind(imported, families.filter(f, f != null).map(f, f.vrfs).flatten(), documents.filter(n, documents[n].spec.conntrackZone != null && (n in importers || n in imported)).map(n, "VRF " + n).join(", ") + ": a VRF with a conntrack zone leaks no routes through a BGP import, as its connections would answer in another zone; drop the zone or the import"))))

WireGuard

Rule Field Guards Takes Expression Message
1 — A WireGuard is named as its interface, in 15 characters at most. refuse documents.all(n, size(n) <= 15) after the table
2 — A WireGuard's name does not start with n64-, which starts the names of the NAT64s' links. refuse documents.all(n, !n.startsWith("n64-")) after the table
3 — A WireGuard does not take the name of a VRF, whose device has it. refuse after the table after the table
4 spec.privateKey A WireGuard key names its Secret and key as credentials' names. refuse after the table the Secret's name and key of privateKey hold letters, digits, '.', '_' and '-' alone, as the names of systemd-networkd's credentials do

Message of rule 1:

documents.filter(n, size(n) > 15).map(n, "WireGuard " + n).join(", ") + " has a name of more than 15 characters, which is no interface's name; give it a shorter one"

Message of rule 2:

documents.filter(n, n.startsWith("n64-")).map(n, "WireGuard " + n).join(", ") + ": n64- starts the names of the NAT64s' links; give the WireGuard another name"

Expression of rule 3:

cel.bind(vrfs, (("router.chalkos.dev/v1alpha1" in config && "VRF" in config["router.chalkos.dev/v1alpha1"]) ? config["router.chalkos.dev/v1alpha1"].VRF : {}), documents.all(n, !(n in vrfs)))

Message of rule 3:

cel.bind(vrfs, (("router.chalkos.dev/v1alpha1" in config && "VRF" in config["router.chalkos.dev/v1alpha1"]) ? config["router.chalkos.dev/v1alpha1"].VRF : {}), documents.filter(n, n in vrfs).map(n, "WireGuard " + n).join(", ") + " takes the name of a VRF, whose device has it; give the WireGuard another name")

Expression of rule 4:

self == null || self.secretRef.name.matches("^[A-Za-z0-9._-]+$") && self.secretRef.key.matches("^[A-Za-z0-9._-]+$")

WireGuardPeer

Rule Field Guards Takes Expression Message
1 spec.presharedKey A WireGuard key names its Secret and key as credentials' names. refuse after the table the Secret's name and key of presharedKey hold letters, digits, '.', '_' and '-' alone, as the names of systemd-networkd's credentials do

Expression of rule 1:

self == null || self.secretRef.name.matches("^[A-Za-z0-9._-]+$") && self.secretRef.key.matches("^[A-Za-z0-9._-]+$")

Facts

A fact is node state that change rules and the when of effects read as facts.<name>. A file fact is the JSON content of a file, and null while the file is missing; a command fact is the JSON a program prints.

Every image

The facts every image declares.

Fact Reads Read by
disks What chalkos-storage-facts disks prints. The rules of Volume.
fallback What chalkos-storage-facts fallback prints, given the fallback secret. The rules of Volume.
recorded File /state/storage/storage.json. The rules of SystemDisk and Volume.

Images with Kubernetes

The facts images with Kubernetes add.

Fact Reads Read by
cluster File /run/chalkos/kubernetes/cluster.json. The effects chalkd-cluster, chalkd-share and kubernetes.
share The key kind of the file /state/kubernetes/share.json, and the SHA-256 of each other key. The rules of Cluster and Node, and the effects chalkd-share and kubernetes.

Router images

None.

Validators

A validator checks what several documents mean together, which no rule of one kind sees, after the change rules and before the outputs render. Validate config with a program describes them. Each table gives the kinds a validator reads and the command chalkd runs it as. chalkctl validate runs the validators it links, the router layer's router, whose refusals the pages of Run a router list.

Every image

None.

Images with Kubernetes

None.

Router images

The validators router images add.

Validator Inputs Command
router AddressSet, BGP, BGPPeer, CommunityList, DHCPRelay, DHCPSubnet, FirewallPolicy, FirewallZone, NAT64, NATRule, NextHop, PolicyRoute, PrefixList, Resolver, Router, RoutingPolicy, TimeServer, VRF, WireGuard, WireGuardPeer, Network chalkos-render validate router

Outputs

An output is a set of config files that chalkd renders from the node's documents at every delivery and boot. Render config files describes them. Each table gives the kinds an output reads, the directory services read its files in, its renderer, and whether a check runs on the rendered files before a delivery changes anything.

Every image

The outputs every image renders.

Output Inputs Directory Renderer Check
chrony TimeSync /run/chalkos/outputs/chrony Go template servers.sources.tmpl yes
networkd Link, NetDev, Network /run/systemd/network Command chalkos-render networkd chalkos-networkd-schemas no

Images with Kubernetes

The outputs images with Kubernetes add.

Output Inputs Directory Renderer Check
bgp BGPPeer, BGPSpeaker, Node /run/chalkos/outputs/bgp Command chalkos-render kubernetes-frr yes
cluster-registry ClusterRegistry, Network /run/chalkos/outputs/cluster-registry Command chalkos-render cluster-registry 0x04000000 yes

Router images

The outputs router images add, and the output networkd of every image as router images declare it.

Output Inputs Directory Renderer Check
chrony-server TimeServer /run/chalkos/outputs/chrony-server Command chalkos-render chrony-server yes
dhcp-relay DHCPRelay, VRF, Network, DHCPSubnet, NAT64 /run/chalkos/outputs/dhcp-relay Command chalkos-render dhcp-relay yes
frr BGP, BGPPeer, CommunityList, PrefixList, RoutingPolicy, Network, VRF, WireGuard /run/chalkos/outputs/frr Command chalkos-render frr yes
jool NAT64, VRF, Network /run/chalkos/outputs/jool Command chalkos-render jool yes
kea DHCPSubnet, VRF, Network, NAT64 /run/chalkos/outputs/kea Command chalkos-render kea chalkos-dhcp6-pd yes
networkd Link, NetDev, Network, NAT64, VRF, NextHop, PolicyRoute, WireGuard, WireGuardPeer /run/systemd/network Command chalkos-render router-networkd chalkos-networkd-schemas no
router-nftables Router, AddressSet, FirewallPolicy, FirewallZone, NATRule, BGPPeer, Resolver, DHCPSubnet, DHCPRelay, WireGuard, TimeServer, VRF, Network, NAT64, NextHop, PolicyRoute /run/chalkos/outputs/router-nftables Command chalkos-render router-nftables 50000 yes
router-sysctl Router /run/sysctl.d Command chalkos-render router-sysctl no
unbound Resolver, VRF, Network /run/chalkos/outputs/unbound Command chalkos-render unbound root.key ipv4only.arpa.zone yes

Effects

An effect is what a delivery does to the node's services once it is applied. React to changes describes them and the order chalkd takes them in. A when too long for its row follows the table.

Every image

The effects every image declares.

Effect Fires when Does
chrony The output chrony changed. Runs chalkos-chrony-reload-sources.
chrony-dhcp The when after the table holds, which reads the documents of TimeSync. Restarts chalkos-chrony-dhcp.service.
links The documents of Link, or a value of a Secret they reference, changed. Runs after networkd when those effects are due. Restarts chalkos-links.service, and starts them when they are stopped.
networkd The output networkd changed. Reloads systemd-networkd.service.

when of chrony-dhcp:

cel.bind(d, (("time.chalkos.dev/v1alpha1" in config && "TimeSync" in config["time.chalkos.dev/v1alpha1"]) ? config["time.chalkos.dev/v1alpha1"].TimeSync : {}), d.map(n, d[n].spec)) != cel.bind(d, (("time.chalkos.dev/v1alpha1" in oldConfig && "TimeSync" in oldConfig["time.chalkos.dev/v1alpha1"]) ? oldConfig["time.chalkos.dev/v1alpha1"].TimeSync : {}), d.map(n, d[n].spec))

Images with Kubernetes

The effects images with Kubernetes add.

Effect Fires when Does
bgp The output bgp changed. Runs after networkd and links when those effects are due. Reloads frr.service.
chalkd-cluster The when after the table holds, which reads the documents of Cluster and Flannel and the fact cluster. Runs after kubernetes when those effects are due. Runs chalkd's action kubernetes:restart.
chalkd-share The when after the table holds, which reads the documents of Addon, Cluster, Flannel and Node and the facts cluster and share. Runs after kubernetes when those effects are due. Runs chalkd's action kubernetes:reload.
cluster-registry The output cluster-registry changed, or the when after the table holds, which reads the documents of Volume. Restarts chalkos-registry.service, and starts them when they are stopped.
containerd-config The when after the table holds, which reads the documents of Cluster. Restarts chalkos-containerd-config.service and containerd.service.
controlplane-ports The when after the table holds, which reads the documents of Node. Restarts chalkos-controlplane.service.
kubernetes The when after the table holds, which reads the documents of Cluster, Flannel, Host, Network and Node and the facts cluster and share. Runs after networkd, links, controlplane-ports, cluster-registry and registry-mirrors when those effects are due. Restarts chalkos-kubernetes.service and kubelet.service, and starts them when they are stopped.
registry-credentials The documents of Registry, or a value of a Secret they reference, changed. Restarts chalkos-registry-credentials.service and kubelet.service.
registry-mirrors The when after the table holds, which reads the documents of ClusterRegistry, Mirror, Network and Registry. Restarts chalkos-registry-mirrors.service.

when of chalkd-cluster:

facts.cluster != oldFacts.cluster || cel.bind(d, (("kubernetes.chalkos.dev/v1alpha1" in config && "Cluster" in config["kubernetes.chalkos.dev/v1alpha1"]) ? config["kubernetes.chalkos.dev/v1alpha1"].Cluster : {}), d.map(n, d[n].spec)) != cel.bind(d, (("kubernetes.chalkos.dev/v1alpha1" in oldConfig && "Cluster" in oldConfig["kubernetes.chalkos.dev/v1alpha1"]) ? oldConfig["kubernetes.chalkos.dev/v1alpha1"].Cluster : {}), d.map(n, d[n].spec)) || cel.bind(d, (("kubernetes.chalkos.dev/v1alpha1" in config && "Flannel" in config["kubernetes.chalkos.dev/v1alpha1"]) ? config["kubernetes.chalkos.dev/v1alpha1"].Flannel : {}), d.map(n, d[n].spec)) != cel.bind(d, (("kubernetes.chalkos.dev/v1alpha1" in oldConfig && "Flannel" in oldConfig["kubernetes.chalkos.dev/v1alpha1"]) ? oldConfig["kubernetes.chalkos.dev/v1alpha1"].Flannel : {}), d.map(n, d[n].spec))

when of chalkd-share:

(cel.bind(was, oldFacts.share, cel.bind(gets, facts.share, was == null || gets == null ? was != gets : was.filter(k, k != "nodeCA").map(k, k + "=" + was[k]) != gets.filter(k, k != "nodeCA").map(k, k + "=" + gets[k]))) || (cel.bind(d, (("kubernetes.chalkos.dev/v1alpha1" in config && "Node" in config["kubernetes.chalkos.dev/v1alpha1"]) ? config["kubernetes.chalkos.dev/v1alpha1"].Node : {}), d.exists(n, d[n].spec.type == "controlplane")) && cel.bind(d, (("kubernetes.chalkos.dev/v1alpha1" in config && "Addon" in config["kubernetes.chalkos.dev/v1alpha1"]) ? config["kubernetes.chalkos.dev/v1alpha1"].Addon : {}), d.map(n, d[n].spec)).map(s, s.objects).flatten() != cel.bind(d, (("kubernetes.chalkos.dev/v1alpha1" in oldConfig && "Addon" in oldConfig["kubernetes.chalkos.dev/v1alpha1"]) ? oldConfig["kubernetes.chalkos.dev/v1alpha1"].Addon : {}), d.map(n, d[n].spec)).map(s, s.objects).flatten())) && !(facts.cluster != oldFacts.cluster || cel.bind(d, (("kubernetes.chalkos.dev/v1alpha1" in config && "Cluster" in config["kubernetes.chalkos.dev/v1alpha1"]) ? config["kubernetes.chalkos.dev/v1alpha1"].Cluster : {}), d.map(n, d[n].spec)) != cel.bind(d, (("kubernetes.chalkos.dev/v1alpha1" in oldConfig && "Cluster" in oldConfig["kubernetes.chalkos.dev/v1alpha1"]) ? oldConfig["kubernetes.chalkos.dev/v1alpha1"].Cluster : {}), d.map(n, d[n].spec)) || cel.bind(d, (("kubernetes.chalkos.dev/v1alpha1" in config && "Flannel" in config["kubernetes.chalkos.dev/v1alpha1"]) ? config["kubernetes.chalkos.dev/v1alpha1"].Flannel : {}), d.map(n, d[n].spec)) != cel.bind(d, (("kubernetes.chalkos.dev/v1alpha1" in oldConfig && "Flannel" in oldConfig["kubernetes.chalkos.dev/v1alpha1"]) ? oldConfig["kubernetes.chalkos.dev/v1alpha1"].Flannel : {}), d.map(n, d[n].spec)))

when of cluster-registry:

cel.bind(d, (("storage.chalkos.dev/v1alpha1" in config && "Volume" in config["storage.chalkos.dev/v1alpha1"]) ? config["storage.chalkos.dev/v1alpha1"].Volume : {}), d.map(n, d[n].spec)).filter(s, s.mountPoint != null && (s.mountPoint == "/var/lib/chalkos-registry" || "/var/lib/chalkos-registry".startsWith(s.mountPoint + "/"))) != cel.bind(d, (("storage.chalkos.dev/v1alpha1" in oldConfig && "Volume" in oldConfig["storage.chalkos.dev/v1alpha1"]) ? oldConfig["storage.chalkos.dev/v1alpha1"].Volume : {}), d.map(n, d[n].spec)).filter(s, s.mountPoint != null && (s.mountPoint == "/var/lib/chalkos-registry" || "/var/lib/chalkos-registry".startsWith(s.mountPoint + "/")))

when of containerd-config:

cel.bind(d, (("kubernetes.chalkos.dev/v1alpha1" in config && "Cluster" in config["kubernetes.chalkos.dev/v1alpha1"]) ? config["kubernetes.chalkos.dev/v1alpha1"].Cluster : {}), d.map(n, d[n].spec)).map(s, s.images.pause) != cel.bind(d, (("kubernetes.chalkos.dev/v1alpha1" in oldConfig && "Cluster" in oldConfig["kubernetes.chalkos.dev/v1alpha1"]) ? oldConfig["kubernetes.chalkos.dev/v1alpha1"].Cluster : {}), d.map(n, d[n].spec)).map(s, s.images.pause)

when of controlplane-ports:

cel.bind(d, (("kubernetes.chalkos.dev/v1alpha1" in config && "Node" in config["kubernetes.chalkos.dev/v1alpha1"]) ? config["kubernetes.chalkos.dev/v1alpha1"].Node : {}), d.map(n, d[n].spec)) != cel.bind(d, (("kubernetes.chalkos.dev/v1alpha1" in oldConfig && "Node" in oldConfig["kubernetes.chalkos.dev/v1alpha1"]) ? oldConfig["kubernetes.chalkos.dev/v1alpha1"].Node : {}), d.map(n, d[n].spec))

when of kubernetes:

cel.bind(d, (("kubernetes.chalkos.dev/v1alpha1" in config && "Node" in config["kubernetes.chalkos.dev/v1alpha1"]) ? config["kubernetes.chalkos.dev/v1alpha1"].Node : {}), d.map(n, d[n].spec)) != cel.bind(d, (("kubernetes.chalkos.dev/v1alpha1" in oldConfig && "Node" in oldConfig["kubernetes.chalkos.dev/v1alpha1"]) ? oldConfig["kubernetes.chalkos.dev/v1alpha1"].Node : {}), d.map(n, d[n].spec)) || cel.bind(d, (("chalkos.dev/v1alpha1" in config && "Host" in config["chalkos.dev/v1alpha1"]) ? config["chalkos.dev/v1alpha1"].Host : {}), d.map(n, d[n].spec)) != cel.bind(d, (("chalkos.dev/v1alpha1" in oldConfig && "Host" in oldConfig["chalkos.dev/v1alpha1"]) ? oldConfig["chalkos.dev/v1alpha1"].Host : {}), d.map(n, d[n].spec)) || cel.bind(d, (("networkd.chalkos.dev/v1alpha1" in config && "Network" in config["networkd.chalkos.dev/v1alpha1"]) ? config["networkd.chalkos.dev/v1alpha1"].Network : {}), d.map(n, has(d[n].spec.network) ? (type(d[n].spec.network) == list ? d[n].spec.network : [d[n].spec.network]).map(s, type(s) == map && has(s.address) ? s.address : null) : [])) != cel.bind(d, (("networkd.chalkos.dev/v1alpha1" in oldConfig && "Network" in oldConfig["networkd.chalkos.dev/v1alpha1"]) ? oldConfig["networkd.chalkos.dev/v1alpha1"].Network : {}), d.map(n, has(d[n].spec.network) ? (type(d[n].spec.network) == list ? d[n].spec.network : [d[n].spec.network]).map(s, type(s) == map && has(s.address) ? s.address : null) : [])) || facts.cluster != oldFacts.cluster || cel.bind(d, (("kubernetes.chalkos.dev/v1alpha1" in config && "Cluster" in config["kubernetes.chalkos.dev/v1alpha1"]) ? config["kubernetes.chalkos.dev/v1alpha1"].Cluster : {}), d.map(n, d[n].spec)) != cel.bind(d, (("kubernetes.chalkos.dev/v1alpha1" in oldConfig && "Cluster" in oldConfig["kubernetes.chalkos.dev/v1alpha1"]) ? oldConfig["kubernetes.chalkos.dev/v1alpha1"].Cluster : {}), d.map(n, d[n].spec)) || cel.bind(d, (("kubernetes.chalkos.dev/v1alpha1" in config && "Flannel" in config["kubernetes.chalkos.dev/v1alpha1"]) ? config["kubernetes.chalkos.dev/v1alpha1"].Flannel : {}), d.map(n, d[n].spec)) != cel.bind(d, (("kubernetes.chalkos.dev/v1alpha1" in oldConfig && "Flannel" in oldConfig["kubernetes.chalkos.dev/v1alpha1"]) ? oldConfig["kubernetes.chalkos.dev/v1alpha1"].Flannel : {}), d.map(n, d[n].spec)) || cel.bind(was, oldFacts.share, cel.bind(gets, facts.share, was == null || gets == null ? was != gets : was.filter(k, k != "nodeCA").map(k, k + "=" + was[k]) != gets.filter(k, k != "nodeCA").map(k, k + "=" + gets[k])))

when of registry-mirrors:

cel.bind(d, (("oci.chalkos.dev/v1alpha1" in config && "Mirror" in config["oci.chalkos.dev/v1alpha1"]) ? config["oci.chalkos.dev/v1alpha1"].Mirror : {}), d.map(n, d[n].spec)) != cel.bind(d, (("oci.chalkos.dev/v1alpha1" in oldConfig && "Mirror" in oldConfig["oci.chalkos.dev/v1alpha1"]) ? oldConfig["oci.chalkos.dev/v1alpha1"].Mirror : {}), d.map(n, d[n].spec)) || cel.bind(d, (("oci.chalkos.dev/v1alpha1" in config && "Registry" in config["oci.chalkos.dev/v1alpha1"]) ? config["oci.chalkos.dev/v1alpha1"].Registry : {}), d.map(n, d[n].spec)) != cel.bind(d, (("oci.chalkos.dev/v1alpha1" in oldConfig && "Registry" in oldConfig["oci.chalkos.dev/v1alpha1"]) ? oldConfig["oci.chalkos.dev/v1alpha1"].Registry : {}), d.map(n, d[n].spec)) || cel.bind(d, (("kubernetes.chalkos.dev/v1alpha1" in config && "ClusterRegistry" in config["kubernetes.chalkos.dev/v1alpha1"]) ? config["kubernetes.chalkos.dev/v1alpha1"].ClusterRegistry : {}), d.map(n, d[n].spec)) != cel.bind(d, (("kubernetes.chalkos.dev/v1alpha1" in oldConfig && "ClusterRegistry" in oldConfig["kubernetes.chalkos.dev/v1alpha1"]) ? oldConfig["kubernetes.chalkos.dev/v1alpha1"].ClusterRegistry : {}), d.map(n, d[n].spec)) || (size((("kubernetes.chalkos.dev/v1alpha1" in config && "ClusterRegistry" in config["kubernetes.chalkos.dev/v1alpha1"]) ? config["kubernetes.chalkos.dev/v1alpha1"].ClusterRegistry : {})) > 0 && cel.bind(d, (("networkd.chalkos.dev/v1alpha1" in config && "Network" in config["networkd.chalkos.dev/v1alpha1"]) ? config["networkd.chalkos.dev/v1alpha1"].Network : {}), d.map(n, has(d[n].spec.network) ? (type(d[n].spec.network) == list ? d[n].spec.network : [d[n].spec.network]).map(s, type(s) == map && has(s.address) ? s.address : null) : [])) != cel.bind(d, (("networkd.chalkos.dev/v1alpha1" in oldConfig && "Network" in oldConfig["networkd.chalkos.dev/v1alpha1"]) ? oldConfig["networkd.chalkos.dev/v1alpha1"].Network : {}), d.map(n, has(d[n].spec.network) ? (type(d[n].spec.network) == list ? d[n].spec.network : [d[n].spec.network]).map(s, type(s) == map && has(s.address) ? s.address : null) : [])))

Router images

The effects router images add, and the effect networkd of every image as router images declare it.

Effect Fires when Does
chrony-server The output chrony-server changed. Runs after router-nftables when those effects are due. Restarts chronyd.service.
dhcp One of the outputs kea and networkd changed. Runs after networkd, links and router-nftables when those effects are due. Reloads chalkos-dhcp.service.
dhcp-relay One of the outputs dhcp-relay and networkd changed. Runs after networkd, links and router-nftables when those effects are due. Reloads chalkos-dhcp-relays.service.
frr The output frr changed. Runs after networkd, links and router-nftables when those effects are due. Reloads frr.service.
jool The output jool changed. Runs after networkd and router-nftables when those effects are due. Reloads chalkos-nat64.service.
networkd The output networkd changed. Runs after vrf when those effects are due. Reloads systemd-networkd.service.
resolvers One of the outputs unbound and networkd changed. Runs after vrf, networkd, router-nftables and jool when those effects are due. Waits up to 15 seconds for VRFs used by the rendered resolvers to exist with their configured routing tables. Reloads chalkos-resolvers.service.
router-nftables The output router-nftables changed. Reloads chalkos-firewall.service.
router-sysctl The output router-sysctl changed. Restarts systemd-sysctl.service.
unbound The output unbound changed. Runs after router-nftables when those effects are due. Reloads unbound.service.
unbound-start The when after the table holds, which reads the documents of Resolver. Runs after router-nftables when those effects are due. Restarts unbound.service, and starts them when they are stopped.
vrf The output networkd changed. Reloads chalkos-vrf.service.

when of unbound-start:

cel.bind(r, (("router.chalkos.dev/v1alpha1" in config && "Resolver" in config["router.chalkos.dev/v1alpha1"]) ? config["router.chalkos.dev/v1alpha1"].Resolver : {}), size(r.filter(n, r[n].spec.vrf == "default"))) != cel.bind(r, (("router.chalkos.dev/v1alpha1" in oldConfig && "Resolver" in oldConfig["router.chalkos.dev/v1alpha1"]) ? oldConfig["router.chalkos.dev/v1alpha1"].Resolver : {}), size(r.filter(n, r[n].spec.vrf == "default")))

Diagnostics

A diagnostic is a read-only command of the image that chalkd runs on the node for a client, in a transient systemd unit with a sandbox of its own, as chalkctl node diag does. Each table gives what a diagnostic shows and the command it runs, its parameters, the least client role that runs it and the capabilities its run gets. A script of several lines follows the table.

Every image

The diagnostics every image declares.

Diagnostic Does Parameters Role Capabilities
addresses The addresses of the node's interfaces, as ip -json address show prints them. Runs ip -json address show. — reader —
dns-query Looks up a name in DNS, through the node's resolver or the server given. Runs drill {name} {type} @{server}. name, hostname; type, enum of A, AAAA, CAA, CNAME, DS, DNSKEY, MX, NS, PTR, SOA, SRV or TXT, optional; server, address, optional operator —
ip-rules The routing policy rules of one family, as ip -json rule show prints them: which table the kernel looks a packet's route up in, in the order of their priorities. Runs ip -json -family {family} rule show. family, enum of inet or inet6, default inet reader —
links The node's network interfaces and their state, as ip -json link show prints them. Runs ip -json link show. — reader —
neighbours The neighbour table of IPv4 ARP and IPv6 neighbour discovery, as ip -json neighbour show prints it. Runs ip -json neighbour show. — reader —
nft-ruleset The node's nftables ruleset, as nft list ruleset prints it. Runs nft list ruleset. — operator CAP_NET_ADMIN
ping Sends ICMP echo requests to an address and prints the replies, for at most 10 seconds. Runs ping -n -w 10 -c {count} {address}. address, address; count, int from 1 to 10, default 4 operator CAP_NET_RAW
route-get The route the kernel takes to an address. Runs ip -json route get {address}. address, address reader —
routes The routes of one family in one routing table, as ip -json route show prints them. Runs ip -json -family {family} route show table {table}. family, enum of inet or inet6, default inet; table, pattern ^(main|local|default|all|[0-9]+)$, default main reader —
tcp-connect Opens a TCP connection to an address and port, closes it again and says whether it connected. Runs bash -c <script> tcp-connect {address} {port}, with the script after the table. address, address; port, int from 1 to 65535 operator —

Script of tcp-connect:

if timeout 5 bash -c ': <>"/dev/tcp/$1/$2"' tcp-connect "$1" "$2"; then
  echo "connected to $1 port $2"
else
  status=$?
  if [ "$status" = 124 ]; then
    echo "no connection to $1 port $2 within 5 seconds" >&2
  fi
  exit "$status"
fi

Images with Kubernetes

The diagnostics images with Kubernetes add.

Diagnostic Does Parameters Role Capabilities
bfd-peers One VRF's BFD sessions and their state, as show bfd peers prints them. Runs vtysh -c show bfd vrf {vrf} peers. vrf, pattern ^[a-z0-9]([-a-z0-9.]{0,13}[a-z0-9])?$, default default reader —
bgp-neighbor One BGP session in detail, as show bgp neighbors prints it: its state, timers, capabilities and routes. Runs vtysh -c show bgp vrf {vrf} neighbors {peer}. peer, pattern ^([0-9A-Fa-f:.]+|[A-Za-z0-9_.:@-]{1,15})$; vrf, pattern ^[a-z0-9]([-a-z0-9.]{0,13}[a-z0-9])?$, default default reader —
bgp-route One VRF's BGP paths to a prefix, as show bgp prints them: each path's AS path, next hop and attributes, and the best. Runs vtysh -c show bgp vrf {vrf} {family} unicast {prefix}. prefix, prefix; vrf, pattern ^[a-z0-9]([-a-z0-9.]{0,13}[a-z0-9])?$, default default; family, enum of ipv4 or ipv6, default ipv6 reader —
bgp-summary One VRF's BGP sessions of each address family, as show bgp summary prints them. Runs vtysh -c show bgp vrf {vrf} summary. vrf, pattern ^[a-z0-9]([-a-z0-9.]{0,13}[a-z0-9])?$, default default reader —
cluster-registry Lists the repositories of the cluster registry the node serves, as its catalog does, or says why it does not answer. Runs chalkos-registry catalog {port}. port, int from 1024 to 65535, default 5000 reader —

Router images

The diagnostics router images add.

Diagnostic Does Parameters Role Capabilities
bfd-peers One VRF's BFD sessions and their state, as show bfd peers prints them. Runs vtysh -c show bfd vrf {vrf} peers. vrf, pattern ^[a-z0-9]([-a-z0-9.]{0,13}[a-z0-9])?$, default default reader —
bgp-neighbor One BGP session in detail, as show bgp neighbors prints it: its state, timers, capabilities and routes. Runs vtysh -c show bgp vrf {vrf} neighbors {peer}. peer, pattern ^([0-9A-Fa-f:.]+|[A-Za-z0-9_.:@-]{1,15})$; vrf, pattern ^[a-z0-9]([-a-z0-9.]{0,13}[a-z0-9])?$, default default reader —
bgp-route One VRF's BGP paths to a prefix, as show bgp prints them: each path's AS path, next hop and attributes, and the best. Runs vtysh -c show bgp vrf {vrf} {family} unicast {prefix}. prefix, prefix; vrf, pattern ^[a-z0-9]([-a-z0-9.]{0,13}[a-z0-9])?$, default default; family, enum of ipv4 or ipv6, default ipv6 reader —
bgp-summary One VRF's BGP sessions of each address family, as show bgp summary prints them. Runs vtysh -c show bgp vrf {vrf} summary. vrf, pattern ^[a-z0-9]([-a-z0-9.]{0,13}[a-z0-9])?$, default default reader —
dhcp-leases The leases of the DHCPv4 and DHCPv6 servers of every VRF, or of one subnet or MAC address: each lease's VRF, subnet, address or delegated prefix, MAC address, host name and end, as Kea's lease commands report them. Runs bash -c <script> dhcp-leases --subnet={subnet} --mac={mac}, with the script after the table. subnet, pattern ^[a-z0-9]([-a-z0-9.]*[a-z0-9])?$, optional; mac, pattern ^[0-9a-f]{2}(:[0-9a-f]{2}){5}$, optional operator —
nat64-sessions A NAT64 instance's sessions, as jool session display prints them: each translated TCP, UDP and ICMP connection's IPv6 and IPv4 addresses and ports, and when it expires. Runs bash -c <script> nat64-sessions {instance}, with the script after the table. instance, pattern ^[a-z0-9]([-a-z0-9.]{0,9}[a-z0-9])?$ operator CAP_NET_ADMIN
ntp-clients The NTP clients the router's time server answered, as chronyc -n clients prints them, and its counts of requests, as chronyc serverstats prints them. Runs bash -c <script>, with the script after the table. — reader —
traceroute The routers on the path to an address, as traceroute -n prints them: one probe a hop, 30 hops at most. Runs traceroute -n -m 30 -q 1 -w 2 {address}. address, address operator —
wireguard The router's WireGuard interfaces and their peers, as wg show prints them: public keys, endpoints, allowed IPs, the latest handshakes and the bytes sent and received. It shows no private or preshared key. Runs wg show {interface}. interface, pattern ^[a-z0-9]([-a-z0-9.]{0,13}[a-z0-9])?$, optional reader CAP_NET_ADMIN

Script of dhcp-leases:

set -euo pipefail
subnet= mac=
for a in "$@"; do
  case $a in
  --subnet=*) subnet=${a#--subnet=} ;;
  --mac=*) mac=${a#--mac=} ;;
  esac
done
# The answer of the server of the socket $1 to the command $2; fails unless it is a JSON object.
ask() {
  local answer
  answer=$(printf '%s' "$2" | socat -T 2 -t 2 - "UNIX-CONNECT:$1" 2>/dev/null) || return 1
  jq -e 'type == "object"' <<<"$answer" >/dev/null 2>&1 || return 1
  printf '%s' "$answer"
}
printf 'VRF\tSUBNET\tADDRESS\tMAC\tHOSTNAME\tENDS\n'
shopt -s nullglob
for socket in /run/kea/dhcp4.sock /run/kea/dhcp4-*.sock /run/kea/dhcp6.sock /run/kea/dhcp6-*.sock; do
  # dhcp4.sock and dhcp6.sock are no patterns, so nullglob keeps them whether they exist or not.
  [[ -S $socket ]] || continue
  family=${socket#/run/kea/dhcp}
  family=${family:0:1}
  vrf=${socket#/run/kea/dhcp"$family"}
  vrf=${vrf%.sock}
  vrf=${vrf#-}
  vrf=${vrf:-default}
  if ((SECONDS >= 24)); then
    echo "the DHCPv$family server of VRF $vrf was not asked: the others took too long" >&2
    continue
  fi
  if ! config=$(ask "$socket" '{"command": "config-get"}') || ! leases=$(ask "$socket" "{\"command\": \"lease$family-get-all\"}"); then
    echo "the DHCPv$family server of VRF $vrf does not answer" >&2
    continue
  fi
  # A delegated prefix is its address and length.
  jq -rn --argjson c "$config" --argjson l "$leases" --arg vrf "$vrf" --arg subnet "$subnet" --arg mac "$mac" '
    (($c.arguments.Dhcp4.subnet4 // $c.arguments.Dhcp6.subnet6) | map({key: (.id | tostring), value: .["user-context"].name}) | from_entries) as $names
    | ($l.arguments.leases // [])[]
    | ($names[.["subnet-id"] | tostring] // "-") as $name
    | select(($subnet == "" or $name == $subnet) and ($mac == "" or .["hw-address"] == $mac))
    | [$vrf, $name, (if .type == "IA_PD" then "\(.["ip-address"])/\(.["prefix-len"])" else .["ip-address"] end),
      (if (.["hw-address"] // "") == "" then "-" else .["hw-address"] end),
      (if (.hostname // "") == "" then "-" else .hostname end), (.cltt + .["valid-lft"] | todate)]
    | @tsv' || echo "the DHCPv$family server of VRF $vrf answered without its subnets or leases" >&2
done

Script of nat64-sessions:

for protocol in --tcp --udp --icmp; do
  jool -i "$1" session display --numeric "$protocol" || exit
done

Script of ntp-clients:

chronyc -h 127.0.0.1,::1 -n clients
echo
exec chronyc -h 127.0.0.1,::1 serverstats

Sources: the schemas, facts.json, validators.json, outputs.json, effects.json and diagnostics.json that an image holds in /etc/chalkos, of an image with the Kubernetes layer, of one without a layer and of a router image, which the node modules in modules/node/ declare.