@intentius/chant-lexicon-k8s 0.0.18 → 0.0.24

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (54) hide show
  1. package/dist/integrity.json +9 -4
  2. package/dist/manifest.json +1 -1
  3. package/dist/skills/chant-k8s-aks.md +146 -0
  4. package/{src/skills/kubernetes-patterns.md → dist/skills/chant-k8s-deployment-strategies.md} +1 -1
  5. package/dist/skills/chant-k8s-eks.md +156 -0
  6. package/dist/skills/chant-k8s-gke.md +246 -0
  7. package/{src/skills/kubernetes-security.md → dist/skills/chant-k8s-security.md} +1 -1
  8. package/dist/skills/chant-k8s.md +66 -3
  9. package/package.json +20 -2
  10. package/src/composites/adot-collector.ts +34 -22
  11. package/src/composites/agic-ingress.ts +14 -6
  12. package/src/composites/aks-external-dns-agent.ts +29 -18
  13. package/src/composites/alb-ingress.ts +14 -6
  14. package/src/composites/autoscaled-service.ts +25 -20
  15. package/src/composites/azure-disk-storage-class.ts +14 -6
  16. package/src/composites/azure-file-storage-class.ts +14 -6
  17. package/src/composites/azure-monitor-collector.ts +34 -22
  18. package/src/composites/batch-job.ts +25 -17
  19. package/src/composites/cockroachdb-cluster.ts +148 -58
  20. package/src/composites/composites.test.ts +369 -363
  21. package/src/composites/config-connector-context.ts +15 -8
  22. package/src/composites/configured-app.ts +21 -15
  23. package/src/composites/cron-workload.ts +25 -20
  24. package/src/composites/ebs-storage-class.ts +14 -6
  25. package/src/composites/efs-storage-class.ts +14 -6
  26. package/src/composites/external-dns-agent.ts +26 -20
  27. package/src/composites/filestore-storage-class.ts +14 -6
  28. package/src/composites/fluent-bit-agent.ts +30 -24
  29. package/src/composites/gce-ingress.ts +14 -6
  30. package/src/composites/gce-pd-storage-class.ts +14 -6
  31. package/src/composites/gke-external-dns-agent.ts +34 -21
  32. package/src/composites/gke-fluent-bit-agent.ts +34 -22
  33. package/src/composites/gke-gateway.ts +19 -12
  34. package/src/composites/gke-otel-collector.ts +34 -22
  35. package/src/composites/irsa-service-account.ts +22 -14
  36. package/src/composites/metrics-server.ts +41 -26
  37. package/src/composites/monitored-service.ts +26 -19
  38. package/src/composites/namespace-env.ts +26 -17
  39. package/src/composites/network-isolated-app.ts +21 -16
  40. package/src/composites/node-agent.ts +33 -22
  41. package/src/composites/secure-ingress.ts +19 -11
  42. package/src/composites/sidecar-app.ts +17 -12
  43. package/src/composites/stateful-app.ts +21 -12
  44. package/src/composites/web-app.ts +25 -21
  45. package/src/composites/worker-pool.ts +40 -26
  46. package/src/composites/workload-identity-sa.ts +22 -14
  47. package/src/composites/workload-identity-service-account.ts +22 -16
  48. package/src/plugin.ts +130 -614
  49. package/src/serializer.ts +3 -0
  50. package/src/skills/chant-k8s-deployment-strategies.md +183 -0
  51. package/src/skills/chant-k8s-gke.md +55 -0
  52. package/src/skills/chant-k8s-patterns.md +245 -0
  53. package/src/skills/chant-k8s-security.md +237 -0
  54. package/src/skills/chant-k8s.md +305 -0
package/src/composites/workload-identity-sa.ts CHANGED
@@ -5,6 +5,9 @@
5
5
  * annotation and `azure.workload.identity/use: "true"` label for AKS Workload Identity.
6
6
  */
7
7
 
8
+ import { Composite, mergeDefaults } from "@intentius/chant";
9
+ import { ServiceAccount, Role, RoleBinding } from "../generated";
10
+
8
11
  export interface WorkloadIdentityServiceAccountProps {
9
12
  /** ServiceAccount name — used in metadata and labels. */
10
13
  name: string;
@@ -20,12 +23,18 @@ export interface WorkloadIdentityServiceAccountProps {
20
23
  labels?: Record<string, string>;
21
24
  /** Namespace for all resources. */
22
25
  namespace?: string;
26
+ /** Per-member defaults for fine-grained overrides. */
27
+ defaults?: {
28
+ serviceAccount?: Partial<Record<string, unknown>>;
29
+ role?: Partial<Record<string, unknown>>;
30
+ roleBinding?: Partial<Record<string, unknown>>;
31
+ };
23
32
  }
24
33
 
25
34
  export interface WorkloadIdentityServiceAccountResult {
26
- serviceAccount: Record<string, unknown>;
27
- role?: Record<string, unknown>;
28
- roleBinding?: Record<string, unknown>;
35
+ serviceAccount: InstanceType<typeof ServiceAccount>;
36
+ role?: InstanceType<typeof Role>;
37
+ roleBinding?: InstanceType<typeof RoleBinding>;
29
38
  }
30
39
 
31
40
  /**
@@ -46,13 +55,14 @@ export interface WorkloadIdentityServiceAccountResult {
46
55
  * });
47
56
  * ```
48
57
  */
49
- export function WorkloadIdentityServiceAccount(props: WorkloadIdentityServiceAccountProps): WorkloadIdentityServiceAccountResult {
58
+ export const WorkloadIdentityServiceAccount = Composite<WorkloadIdentityServiceAccountProps>((props) => {
50
59
  const {
51
60
  name,
52
61
  clientId,
53
62
  rbacRules,
54
63
  labels: extraLabels = {},
55
64
  namespace,
65
+ defaults: defs,
56
66
  } = props;
57
67
 
58
68
  const roleName = `${name}-role`;
@@ -64,7 +74,7 @@ export function WorkloadIdentityServiceAccount(props: WorkloadIdentityServiceAcc
64
74
  ...extraLabels,
65
75
  };
66
76
 
67
- const serviceAccountProps: Record<string, unknown> = {
77
+ const serviceAccount = new ServiceAccount(mergeDefaults({
68
78
  metadata: {
69
79
  name,
70
80
  ...(namespace && { namespace }),
@@ -77,23 +87,21 @@ export function WorkloadIdentityServiceAccount(props: WorkloadIdentityServiceAcc
77
87
  "azure.workload.identity/client-id": clientId,
78
88
  },
79
89
  },
80
- };
90
+ }, defs?.serviceAccount));
81
91
 
82
- const result: WorkloadIdentityServiceAccountResult = {
83
- serviceAccount: serviceAccountProps,
84
- };
92
+ const result: Record<string, any> = { serviceAccount };
85
93
 
86
94
  if (rbacRules && rbacRules.length > 0) {
87
- result.role = {
95
+ result.role = new Role(mergeDefaults({
88
96
  metadata: {
89
97
  name: roleName,
90
98
  ...(namespace && { namespace }),
91
99
  labels: { ...commonLabels, "app.kubernetes.io/component": "rbac" },
92
100
  },
93
101
  rules: rbacRules,
94
- };
102
+ }, defs?.role));
95
103
 
96
- result.roleBinding = {
104
+ result.roleBinding = new RoleBinding(mergeDefaults({
97
105
  metadata: {
98
106
  name: bindingName,
99
107
  ...(namespace && { namespace }),
@@ -111,8 +119,8 @@ export function WorkloadIdentityServiceAccount(props: WorkloadIdentityServiceAcc
111
119
  ...(namespace && { namespace }),
112
120
  },
113
121
  ],
114
- };
122
+ }, defs?.roleBinding));
115
123
  }
116
124
 
117
125
  return result;
118
- }
126
+ }, "WorkloadIdentityServiceAccount");
package/src/composites/workload-identity-service-account.ts CHANGED
@@ -5,6 +5,9 @@
5
5
  * annotation for GKE Workload Identity Federation.
6
6
  */
7
7
 
8
+ import { Composite, mergeDefaults } from "@intentius/chant";
9
+ import { ServiceAccount, Role, RoleBinding } from "../generated";
10
+
8
11
  export interface WorkloadIdentityServiceAccountProps {
9
12
  /** ServiceAccount name — used in metadata and labels. */
10
13
  name: string;
@@ -20,12 +23,18 @@ export interface WorkloadIdentityServiceAccountProps {
20
23
  labels?: Record<string, string>;
21
24
  /** Namespace for all resources. */
22
25
  namespace?: string;
26
+ /** Per-member defaults for fine-grained overrides. */
27
+ defaults?: {
28
+ serviceAccount?: Partial<Record<string, unknown>>;
29
+ role?: Partial<Record<string, unknown>>;
30
+ roleBinding?: Partial<Record<string, unknown>>;
31
+ };
23
32
  }
24
33
 
25
34
  export interface WorkloadIdentityServiceAccountResult {
26
- serviceAccount: Record<string, unknown>;
27
- role?: Record<string, unknown>;
28
- roleBinding?: Record<string, unknown>;
35
+ serviceAccount: InstanceType<typeof ServiceAccount>;
36
+ role?: InstanceType<typeof Role>;
37
+ roleBinding?: InstanceType<typeof RoleBinding>;
29
38
  }
30
39
 
31
40
  /**
@@ -46,15 +55,14 @@ export interface WorkloadIdentityServiceAccountResult {
46
55
  * });
47
56
  * ```
48
57
  */
49
- export function WorkloadIdentityServiceAccount(
50
- props: WorkloadIdentityServiceAccountProps,
51
- ): WorkloadIdentityServiceAccountResult {
58
+ export const WorkloadIdentityServiceAccount = Composite<WorkloadIdentityServiceAccountProps>((props) => {
52
59
  const {
53
60
  name,
54
61
  gcpServiceAccountEmail,
55
62
  rbacRules,
56
63
  labels: extraLabels = {},
57
64
  namespace,
65
+ defaults: defs,
58
66
  } = props;
59
67
 
60
68
  const roleName = `${name}-role`;
@@ -66,7 +74,7 @@ export function WorkloadIdentityServiceAccount(
66
74
  ...extraLabels,
67
75
  };
68
76
 
69
- const serviceAccountProps: Record<string, unknown> = {
77
+ const serviceAccount = new ServiceAccount(mergeDefaults({
70
78
  metadata: {
71
79
  name,
72
80
  ...(namespace && { namespace }),
@@ -75,23 +83,21 @@ export function WorkloadIdentityServiceAccount(
75
83
  "iam.gke.io/gcp-service-account": gcpServiceAccountEmail,
76
84
  },
77
85
  },
78
- };
86
+ }, defs?.serviceAccount));
79
87
 
80
- const result: WorkloadIdentityServiceAccountResult = {
81
- serviceAccount: serviceAccountProps,
82
- };
88
+ const result: Record<string, any> = { serviceAccount };
83
89
 
84
90
  if (rbacRules && rbacRules.length > 0) {
85
- result.role = {
91
+ result.role = new Role(mergeDefaults({
86
92
  metadata: {
87
93
  name: roleName,
88
94
  ...(namespace && { namespace }),
89
95
  labels: { ...commonLabels, "app.kubernetes.io/component": "rbac" },
90
96
  },
91
97
  rules: rbacRules,
92
- };
98
+ }, defs?.role));
93
99
 
94
- result.roleBinding = {
100
+ result.roleBinding = new RoleBinding(mergeDefaults({
95
101
  metadata: {
96
102
  name: bindingName,
97
103
  ...(namespace && { namespace }),
@@ -109,8 +115,8 @@ export function WorkloadIdentityServiceAccount(
109
115
  ...(namespace && { namespace }),
110
116
  },
111
117
  ],
112
- };
118
+ }, defs?.roleBinding));
113
119
  }
114
120
 
115
121
  return result;
116
- }
122
+ }, "WorkloadIdentityServiceAccount");