@mark1russell7/kind 0.11.11 → 0.12.0

package/build/{judge-0ku_4dsJ.d.ts → judge-BH4WtL3f.d.ts}

@@ -4,9 +4,17 @@ import { Coupling, Gate, Poll, Stage, Timing } from "@mark1russell7/service";
 import { RedisKnobs } from "@mark1russell7/service/redis";
 import { SessionCheckKnobs } from "@mark1russell7/service/http-client";
 //#region src/scenario.d.ts
-/** A kube-proxy mode is the dataplane of each node: iptables (the default of kind), IPVS or nftables. */
+/** A kube-proxy mode is the mode of kube-proxy on each node: iptables (the default of kind), IPVS or nftables. */
 type KubeProxyMode = "iptables" | "ipvs" | "nftables";
 declare const KUBE_PROXY_MODES: readonly KubeProxyMode[];
+/**
+ * A dataplane is the path of a Service on each node, and the mode of a cell. It is kube-proxy in one
+ * of its modes, or `cilium`: Cilium is the CNI and replaces kube-proxy (`cilium.ts`).
+ */
+type Dataplane = KubeProxyMode | "cilium";
+declare const DATAPLANES: readonly Dataplane[];
+/** This function tells if a dataplane is a mode of kube-proxy. */
+declare const isKubeProxyMode: (mode: Dataplane) => mode is KubeProxyMode;
 /** A node image is the kind node image of one Kubernetes version, pinned by digest. */
 interface NodeImage {
   readonly kubernetes: string;
@@ -20,8 +28,8 @@ interface NodeImage {
 declare const NODE_IMAGES: Readonly<Record<string, NodeImage>>;
 /**
  * A scenario is one kind cluster as data. The lab generates the configuration of kind from it, and
- * nothing comes from a default of kind. The scenario gives the node count, the version, the mode
- * of kube-proxy and its sync periods, the CNI and the subnets.
+ * nothing comes from a default of kind. The scenario gives the node count, the version, the
+ * dataplane, the sync periods of kube-proxy, the CNI and the subnets.
  */
 interface KindScenario {
   /** This name names the cluster and its Docker network: lowercase letters, digits and dashes. */
@@ -30,15 +38,18 @@ interface KindScenario {
   readonly kubernetes: string;
   /** This count is the number of workers. The cluster also has one control plane. */
   readonly workers: number;
+  /** This dataplane is the path of a Service on each node. */
+  readonly dataplane: Dataplane;
+  /** This is kube-proxy and its sync periods, or null when Cilium replaces kube-proxy. */
   readonly kubeProxy: {
     readonly mode: KubeProxyMode;
     /** This time is the shortest interval between two syncs of the rules. */
     readonly minSyncPeriod: Quantity;
     /** This time is the interval of the full sync of the rules. */
     readonly syncPeriod: Quantity;
-  };
-  /** This CNI is kindnet, the CNI of kind. Cilium comes later. */
-  readonly cni: "kindnet";
+  } | null;
+  /** This CNI is kindnet, the CNI of kind, beside kube-proxy. The CNI of the dataplane `cilium` is Cilium. */
+  readonly cni: "kindnet" | "cilium";
   readonly podSubnet: string;
   readonly serviceSubnet: string;
   /**
@@ -55,15 +66,21 @@ declare const ZONE_KEPT = "zone-a";
 declare const ZONE_LOST = "zone-b";
 /** This function gives the zone of the node at the position `at` of `nodeNames`, in a cluster of `count` nodes. */
 declare const zoneOf: (at: number, count: number) => string;
-/** This function gives a scenario with the defaults of Kubernetes for kube-proxy, as explicit values. */
-declare const scenario: (name: string, mode: KubeProxyMode, workers: number, kubernetes?: string, zoned?: boolean) => KindScenario;
-/** This function gives the problems of a scenario: a name that kind refuses, no image for the version, or a count out of range. */
+/**
+ * This function gives a scenario with the defaults of Kubernetes for kube-proxy, as explicit values.
+ * The dataplane `cilium` has no kube-proxy, and its CNI is Cilium.
+ */
+declare const scenario: (name: string, mode: Dataplane, workers: number, kubernetes?: string, zoned?: boolean) => KindScenario;
+/**
+ * This function gives the problems of a scenario. A problem is a name that kind refuses, no image for
+ * the version, or a count out of range. A kube-proxy or a CNI that does not agree with the dataplane is a problem too.
+ */
 declare const scenarioProblems: (s: KindScenario) => string[];
 /** This function gives the names of the node containers, as kind names them: the control plane, then each worker. */
 declare const nodeNames: (s: KindScenario) => string[];
 /** This function gives a duration as kube-proxy reads it, in whole milliseconds: `1s`, `500ms`. */
 declare const goDuration: (amount: Quantity) => string;
-/** This function gives the KubeProxyConfiguration patch of a scenario, as kubeadm reads it. */
+/** This function gives the KubeProxyConfiguration patch of a scenario, as kubeadm reads it. It refuses a scenario with no kube-proxy. */
 declare const kubeProxyPatch: (s: KindScenario) => string;
 /** A kind configuration is the cluster file that `kind create cluster --config` reads. JSON is YAML, thus the lab writes it as JSON. */
 interface KindConfig {
@@ -71,7 +88,8 @@ interface KindConfig {
   readonly apiVersion: "kind.x-k8s.io/v1alpha4";
   readonly networking: {
     readonly ipFamily: "ipv4";
-    readonly kubeProxyMode: KubeProxyMode;
+    /** This mode is the mode of kube-proxy, or `none` for no kube-proxy. */
+    readonly kubeProxyMode: KubeProxyMode | "none";
     readonly disableDefaultCNI: boolean;
     readonly podSubnet: string;
     readonly serviceSubnet: string;
@@ -83,7 +101,12 @@ interface KindConfig {
   }>;
   readonly kubeadmConfigPatches: readonly string[];
 }
-/** This function generates the configuration of kind from a scenario. It refuses a scenario with a problem. */
+/**
+ * This function generates the configuration of kind from a scenario. It refuses a scenario with a
+ * problem. The dataplane `cilium` gets no kindnet, as the kind guide of Cilium 1.20.4 tells
+ * (`Documentation/installation/kind-configure.rst`). It also gets no kube-proxy, because Cilium
+ * replaces it (`Documentation/network/kubernetes/kubeproxy-free.rst`).
+ */
 declare const kindConfig: (s: KindScenario) => KindConfig;
 /** This function gives the first and the last address of an IPv4 CIDR, as numbers. */
 declare const cidrRange: (cidr: string) => [number, number];
@@ -300,6 +323,14 @@ interface Declaration {
    * With `http/1.1` or no value, the edge is `node:http`.
    */
   readonly protocol?: EdgeProtocol | undefined;
+  /**
+   * This flag is the shared gate (S6, candidate E). With true, the readiness probe that the kubelet
+   * reads leaves out each check of Redis, a dependency that each replica shares. Thus a failure of
+   * Redis keeps each replica in the endpoints. The controller still reads the checks of Redis, thus
+   * the service refuses each request at once with a 503. With false or no value, each check that
+   * gates readiness also gates the probe. A declaration with the gate needs Redis.
+   */
+  readonly sharedGate?: boolean | undefined;
 }
 /** An edge protocol is the protocol of the HTTP edge of the service: HTTP/1.1, or HTTP/2 without TLS (`h2c`). */
 type EdgeProtocol = "http/1.1" | "h2c";
@@ -545,7 +576,8 @@ interface KindCell<A = Quantity> {
   readonly mesh?: Mesh | undefined;
   /** This text names a system of the plan that the cell replaces with the service of this repository, or null. */
   readonly substitutes: string | null;
-  readonly mode: KubeProxyMode;
+  /** This mode is the dataplane of the cluster of the cell: a mode of kube-proxy, or Cilium. */
+  readonly mode: Dataplane;
   readonly workers: number;
   readonly trigger: Trigger<A>;
   readonly pod: PodSettings;
@@ -1148,5 +1180,5 @@ declare const quantileOf: (sorted: readonly number[], p: number) => number;
  */
 declare const medianInterval: (sorted: readonly number[]) => [number, number];
 //#endregion
-export { unitOf as $, secondsOf as $t, TriggerV1 as A, NodeImage as An, restartsAt as At, RunCheck as B, scenario as Bn, stoppingOf as Bt, KindCellResult as C, WindowPrediction as Cn, kernelCounts as Ct, PredictionV1 as D, KindScenario as Dn, recordsOf as Dt, LoadSample as E, KindConfig as En, podsOf as Et, KIND_NOISE as F, cidrRange as Fn, sliceEmptyOf as Ft, factsOf as G, CLIENT as Gt, checkRun as H, zoneOf as Hn, tunnelsOf as Ht, KindDecision as I, goDuration as In, sliceReadyAt as It, observationEnd as J, PORT as Jt, judgeKind as K, HEALTH_PORT as Kt, KindVerdict as L, kindConfig as Ln, sliceReadyOf as Lt, upgrade as M, ZONE_LABEL as Mn, signalOf as Mt, upgradeCell as N, ZONE_LOST as Nn, signalsOf as Nt, RunCheckV1 as O, KubeProxyMode as On, requestsOf as Ot, Deleted as P, cidrOverlap as Pn, sliceDropOf as Pt, reusesReset as Q, seconds as Qt, LAST_SLACK as R, kubeProxyPatch as Rn, slicesOf as Rt, KindCellRecordV1 as S, TriggerKind as Sn, isTunnelState as St, KindVerdictV1 as T, KUBE_PROXY_MODES as Tn, podsAt as Tt, cyclesOf as U, ztunnelPodsOf as Ut, RunFacts as V, scenarioProblems as Vn, transitionOf as Vt, deletionsOf as W, ztunnelReplaced as Wt, propagationSource as X, SERVER as Xt, propagationOf as Y, REDIS as Yt, referenceOf as Z, bandOf as Zt, ClusterManifest as _, Replica as _n, deletionOf as _t, STAGES as a, Flap as an, PropagationSource as at, FORMAT_V1 as b, Template as bn, failuresOf as bt, readRecord as c, KubeletProbe as cn, RulesLine as ct, calibrationOf as d, MeshMode as dn, TCP_STATE as dt, showBand as en, updatesOf as et, cellsTable as f, NonePrediction as fn, TunnelLine as ft, BandV1 as g, Reference as gn, byNode as gt, timeSpread as h, RedisDeclaration as hn, byClients as ht, quantileOf as i, EdgeProtocol as in, PodLine as it, judge as j, ZONE_KEPT as jn, rulesOf as jt, RunFactsV1 as k, NODE_IMAGES as kn, restartOf as kt, Judged as l, Mesh as ln, SliceLine as lt, predictionText as m, Prediction as mn, backendsAt as mt, medianInterval as n, Cycle as nn, HBONE_PORT as nt, kindCellRecordSchema as o, KindCell as on, RecordLine as ot, medianText as p, PodSettings as pn, ZtunnelPodLine as pt, observationAfter as q, LOG_LABEL as qt, middle as r, Declaration as rn, Line as rt, kindCellRecordV1Schema as s, KindRun as sn, Request as st, RELATIVE as t, Band as tn, Endpoint as tt, TimeSpread as u, MeshFlavor as un, SocketLine as ut, EnvironmentManifest as v, ResetReuse as vn, dropOf as vt, KindCellV1 as w, Workload as wn, outcomesOf as wt, KindCellRecord as x, Trigger as xn, intakeOf as xt, FORMAT as y, Stack as yn, emptyOf as yt, Propagated as z, nodeNames as zn, socketsOf as zt };
-//# sourceMappingURL=judge-0ku_4dsJ.d.ts.map
+export { unitOf as $, secondsOf as $t, TriggerV1 as A, KubeProxyMode as An, restartsAt as At, RunCheck as B, kindConfig as Bn, stoppingOf as Bt, KindCellResult as C, WindowPrediction as Cn, kernelCounts as Ct, PredictionV1 as D, KUBE_PROXY_MODES as Dn, recordsOf as Dt, LoadSample as E, Dataplane as En, podsOf as Et, KIND_NOISE as F, ZONE_LOST as Fn, sliceEmptyOf as Ft, factsOf as G, zoneOf as Gn, CLIENT as Gt, checkRun as H, nodeNames as Hn, tunnelsOf as Ht, KindDecision as I, cidrOverlap as In, sliceReadyAt as It, observationEnd as J, PORT as Jt, judgeKind as K, HEALTH_PORT as Kt, KindVerdict as L, cidrRange as Ln, sliceReadyOf as Lt, upgrade as M, NodeImage as Mn, signalOf as Mt, upgradeCell as N, ZONE_KEPT as Nn, signalsOf as Nt, RunCheckV1 as O, KindConfig as On, requestsOf as Ot, Deleted as P, ZONE_LABEL as Pn, sliceDropOf as Pt, reusesReset as Q, seconds as Qt, LAST_SLACK as R, goDuration as Rn, slicesOf as Rt, KindCellRecordV1 as S, TriggerKind as Sn, isTunnelState as St, KindVerdictV1 as T, DATAPLANES as Tn, podsAt as Tt, cyclesOf as U, scenario as Un, ztunnelPodsOf as Ut, RunFacts as V, kubeProxyPatch as Vn, transitionOf as Vt, deletionsOf as W, scenarioProblems as Wn, ztunnelReplaced as Wt, propagationSource as X, SERVER as Xt, propagationOf as Y, REDIS as Yt, referenceOf as Z, bandOf as Zt, ClusterManifest as _, Replica as _n, deletionOf as _t, STAGES as a, Flap as an, PropagationSource as at, FORMAT_V1 as b, Template as bn, failuresOf as bt, readRecord as c, KubeletProbe as cn, RulesLine as ct, calibrationOf as d, MeshMode as dn, TCP_STATE as dt, showBand as en, updatesOf as et, cellsTable as f, NonePrediction as fn, TunnelLine as ft, BandV1 as g, Reference as gn, byNode as gt, timeSpread as h, RedisDeclaration as hn, byClients as ht, quantileOf as i, EdgeProtocol as in, PodLine as it, judge as j, NODE_IMAGES as jn, rulesOf as jt, RunFactsV1 as k, KindScenario as kn, restartOf as kt, Judged as l, Mesh as ln, SliceLine as lt, predictionText as m, Prediction as mn, backendsAt as mt, medianInterval as n, Cycle as nn, HBONE_PORT as nt, kindCellRecordSchema as o, KindCell as on, RecordLine as ot, medianText as p, PodSettings as pn, ZtunnelPodLine as pt, observationAfter as q, LOG_LABEL as qt, middle as r, Declaration as rn, Line as rt, kindCellRecordV1Schema as s, KindRun as sn, Request as st, RELATIVE as t, Band as tn, Endpoint as tt, TimeSpread as u, MeshFlavor as un, SocketLine as ut, EnvironmentManifest as v, ResetReuse as vn, dropOf as vt, KindCellV1 as w, Workload as wn, outcomesOf as wt, KindCellRecord as x, Trigger as xn, intakeOf as xt, FORMAT as y, Stack as yn, emptyOf as yt, Propagated as z, isKubeProxyMode as zn, socketsOf as zt };
+//# sourceMappingURL=judge-BH4WtL3f.d.ts.map

package/build/{judge-CLBiWALR.js → judge-CMQeiw8k.js}

@@ -1328,11 +1328,12 @@ const TRIGGERS = [
 	"zone-loss",
 	"latency"
 ];
-const MODES = [
+const KUBE_PROXY = [
 	"iptables",
 	"ipvs",
 	"nftables"
 ];
+const MODES = [...KUBE_PROXY, "cilium"];
 const time = quantitySchema("time");
 const extent = extentSchema("time");
 const count = z.number().int().nonnegative();
@@ -1401,7 +1402,8 @@ const declaration = z.object({
 		threshold: time
 	}).nullable(),
 	lameDuck: z.boolean().optional(),
-	protocol: z.enum(["http/1.1", "h2c"]).optional()
+	protocol: z.enum(["http/1.1", "h2c"]).optional(),
+	sharedGate: z.boolean().optional()
 });
 const replica = z.object({
 	pod: z.string(),
@@ -1443,15 +1445,19 @@ const manifest = z.object({
 		name: z.string(),
 		kubernetes: z.string(),
 		workers: count,
+		dataplane: z.enum(MODES).optional(),
 		kubeProxy: z.object({
-			mode: z.enum(MODES),
+			mode: z.enum(KUBE_PROXY),
 			minSyncPeriod: time,
 			syncPeriod: time
-		}),
-		cni: z.literal("kindnet"),
+		}).nullable(),
+		cni: z.enum(["kindnet", "cilium"]),
 		podSubnet: z.string(),
 		serviceSubnet: z.string()
-	}),
+	}).transform(({ dataplane, ...rest }) => ({
+		...rest,
+		dataplane: dataplane ?? rest.kubeProxy?.mode ?? "cilium"
+	})),
 	cluster: z.object({
 		kind: z.string(),
 		nodeImage: z.string(),
@@ -1712,4 +1718,4 @@ const readRecord = (data) => {
 //#endregion
 export { rulesOf as $, RELATIVE as A, dropOf as B, observationEnd as C, reusesReset as D, referenceOf as E, TCP_STATE as F, kernelCounts as G, failuresOf as H, backendsAt as I, podsOf as J, outcomesOf as K, byClients as L, middle as M, quantileOf as N, unitOf as O, HBONE_PORT as P, restartsAt as Q, byNode as R, observationAfter as S, showBand as St, propagationSource as T, intakeOf as U, emptyOf as V, isTunnelState as W, requestsOf as X, recordsOf as Y, restartOf as Z, checkRun as _, REDIS as _t, calibrationOf as a, sliceReadyOf as at, factsOf as b, seconds as bt, predictionText as c, stoppingOf as ct, FORMAT_V1 as d, ztunnelPodsOf as dt, signalOf as et, judge as f, ztunnelReplaced as ft, LAST_SLACK as g, PORT as gt, KIND_NOISE as h, LOG_LABEL as ht, readRecord as i, sliceReadyAt as it, medianInterval as j, updatesOf as k, timeSpread as l, transitionOf as lt, upgradeCell as m, HEALTH_PORT as mt, kindCellRecordSchema as n, sliceDropOf as nt, cellsTable as o, slicesOf as ot, upgrade as p, CLIENT as pt, podsAt as q, kindCellRecordV1Schema as r, sliceEmptyOf as rt, medianText as s, socketsOf as st, STAGES as t, signalsOf as tt, FORMAT as u, tunnelsOf as ut, cyclesOf as v, SERVER as vt, propagationOf as w, judgeKind as x, secondsOf as xt, deletionsOf as y, bandOf as yt, deletionOf as z };
 
-//# sourceMappingURL=judge-CLBiWALR.js.map
+//# sourceMappingURL=judge-CMQeiw8k.js.map