clever-tools 4.8.0 → 4.9.0

package/src/commands/k8s/k8s.nodegroups.update.command.js

@@ -0,0 +1,86 @@
+import { z } from 'zod';
+import { defineCommand } from '../../lib/define-command.js';
+import { defineOption } from '../../lib/define-option.js';
+import { k8sUpdateNodeGroup } from '../../lib/k8s.js';
+import { styleText } from '../../lib/style-text.js';
+import { Logger } from '../../logger.js';
+import { orgaIdOrNameOption } from '../global.options.js';
+import { k8sIdOrNameArg, k8sNodeGroupIdOrNameArg } from './k8s.args.js';
+
+export const k8sNodeGroupUpdateCommand = defineCommand({
+  description: 'Update a node group on a Kubernetes cluster',
+  since: '4.9.0',
+  options: {
+    count: defineOption({
+      name: 'count',
+      schema: z.coerce.number().int().min(0).max(256).optional(),
+      description: 'Target node count',
+      placeholder: 'count',
+    }),
+    min: defineOption({
+      name: 'min',
+      schema: z.coerce.number().int().min(0).max(256).optional(),
+      description: 'Minimum node count (autoscaling bound)',
+      placeholder: 'min',
+    }),
+    max: defineOption({
+      name: 'max',
+      schema: z.coerce.number().int().min(0).max(256).optional(),
+      description: 'Maximum node count (autoscaling bound)',
+      placeholder: 'max',
+    }),
+    autoscaling: defineOption({
+      name: 'autoscaling',
+      schema: z.boolean().default(false),
+      description: 'Enable the cluster autoscaler',
+    }),
+    disableAutoscaling: defineOption({
+      name: 'disable-autoscaling',
+      schema: z.boolean().default(false),
+      description: 'Disable the cluster autoscaler',
+    }),
+    description: defineOption({
+      name: 'description',
+      schema: z.string().max(4096).optional(),
+      description: 'Free-form node group description',
+      placeholder: 'description',
+    }),
+    tag: defineOption({
+      name: 'tag',
+      schema: z.string().max(1024).optional(),
+      description: 'Arbitrary tag attached to the node group',
+      placeholder: 'tag',
+    }),
+    org: orgaIdOrNameOption,
+  },
+  args: [k8sIdOrNameArg, k8sNodeGroupIdOrNameArg],
+  async handler(options, clusterIdOrName, nodeGroupIdOrName) {
+    const { org: orgIdOrName } = options;
+
+    if (options.autoscaling && options.disableAutoscaling) {
+      throw new Error('--autoscaling and --disable-autoscaling are mutually exclusive');
+    }
+
+    const updates = {};
+    if (options.count != null) updates.targetNodeCount = options.count;
+    if (options.min != null) updates.minNodeCount = options.min;
+    if (options.max != null) updates.maxNodeCount = options.max;
+    if (options.autoscaling) updates.autoscalingEnabled = true;
+    if (options.disableAutoscaling) updates.autoscalingEnabled = false;
+    if (options.description != null) updates.description = options.description;
+    if (options.tag != null) updates.tag = options.tag;
+
+    if (Object.keys(updates).length === 0) {
+      throw new Error(
+        'No update specified. Provide at least one of --count, --min, --max, --autoscaling, --disable-autoscaling, --description, --tag',
+      );
+    }
+
+    if (updates.minNodeCount != null && updates.maxNodeCount != null && updates.minNodeCount > updates.maxNodeCount) {
+      throw new Error('--min must be less than or equal to --max');
+    }
+
+    const nodeGroup = await k8sUpdateNodeGroup(orgIdOrName, clusterIdOrName, nodeGroupIdOrName, updates);
+    Logger.printSuccess(`Node group ${styleText('green', nodeGroup.name)} updated`);
+  },
+});

package/src/commands/k8s/k8s.quota.command.js

@@ -0,0 +1,77 @@
+import { defineCommand } from '../../lib/define-command.js';
+import { k8sGetQuota, k8sListUsage } from '../../lib/k8s.js';
+import { Logger } from '../../logger.js';
+import { humanJsonOutputFormatOption, orgaIdOrNameOption } from '../global.options.js';
+
+const BYTES_PER_GB = 1024 ** 3;
+const UNIT_TO_BYTES = {
+  B: 1,
+  KB: 1024,
+  MB: 1024 ** 2,
+  GB: BYTES_PER_GB,
+  TB: 1024 ** 4,
+  PB: 1024 ** 5,
+};
+
+export const k8sQuotaCommand = defineCommand({
+  description: 'Get the Kubernetes quota, usage and remaining of an organisation',
+  since: '4.9.0',
+  options: {
+    org: orgaIdOrNameOption,
+    format: humanJsonOutputFormatOption,
+  },
+  args: [],
+  async handler(options) {
+    const { format, org: orgIdOrName } = options;
+    const [quota, usageItems] = await Promise.all([k8sGetQuota(orgIdOrName), k8sListUsage(orgIdOrName)]);
+
+    const cpuQuota = quota.quotas?.find((i) => i.type === 'MillivCPUMaxLimit');
+    const ramQuota = quota.quotas?.find((i) => i.type === 'RamMaxUsage');
+    const usedMillicores = usageItems.reduce((sum, i) => sum + i.cpuMillicores, 0);
+    const usedBytes = usageItems.reduce((sum, i) => sum + i.ramBytes, 0);
+
+    switch (format) {
+      case 'json': {
+        const { quotas, ...quotaRest } = quota;
+        Logger.printJson({
+          quota: {
+            ...quotaRest,
+            vCPUMax: cpuQuota != null ? { maximum: cpuQuota.maximum, unit: 'mCPU' } : null,
+            ramMax: ramQuota != null ? { maximum: ramQuota.information.number, unit: ramQuota.information.unit } : null,
+          },
+          usage: { cpuMillicores: usedMillicores, ramBytes: usedBytes },
+          remaining: {
+            cpuMillicores: cpuQuota != null ? cpuQuota.maximum - usedMillicores : null,
+            ramBytes: ramQuota != null ? ramToBytes(ramQuota.information) - usedBytes : null,
+          },
+        });
+        break;
+      }
+      case 'human':
+      default: {
+        const ramQuotaBytes = ramQuota != null ? ramToBytes(ramQuota.information) : null;
+        console.table({
+          'Max CPU': {
+            Quota: cpuQuota != null ? `${cpuQuota.maximum / 1000} vCPU` : 'unlimited',
+            Usage: `${usedMillicores / 1000} vCPU`,
+            Remaining: cpuQuota != null ? `${(cpuQuota.maximum - usedMillicores) / 1000} vCPU` : 'unlimited',
+          },
+          'Max RAM': {
+            Quota: ramQuota != null ? `${ramQuota.information.number} ${ramQuota.information.unit}` : 'unlimited',
+            Usage: `${formatGb(usedBytes)} GB`,
+            Remaining: ramQuotaBytes != null ? `${formatGb(ramQuotaBytes - usedBytes)} GB` : 'unlimited',
+          },
+        });
+        break;
+      }
+    }
+  },
+});
+
+function ramToBytes({ number, unit }) {
+  return number * (UNIT_TO_BYTES[unit] ?? BYTES_PER_GB);
+}
+
+function formatGb(bytes) {
+  return Math.round((bytes / BYTES_PER_GB) * 100) / 100;
+}

package/src/commands/k8s/k8s.update.command.js

@@ -0,0 +1,72 @@
+import { z } from 'zod';
+import { defineCommand } from '../../lib/define-command.js';
+import { defineOption } from '../../lib/define-option.js';
+import { k8sUpdate } from '../../lib/k8s.js';
+import { styleText } from '../../lib/style-text.js';
+import { Logger } from '../../logger.js';
+import { tags } from '../../parsers.js';
+import { orgaIdOrNameOption } from '../global.options.js';
+import { k8sIdOrNameArg } from './k8s.args.js';
+
+export const k8sUpdateCommand = defineCommand({
+  description: 'Update a Kubernetes cluster metadata or features',
+  since: '4.9.0',
+  options: {
+    name: defineOption({
+      name: 'name',
+      schema: z.string().max(128).optional(),
+      description: 'Rename the cluster',
+      placeholder: 'name',
+    }),
+    description: defineOption({
+      name: 'description',
+      schema: z.string().max(4096).optional(),
+      description: 'Free-form cluster description',
+      placeholder: 'description',
+    }),
+    tag: defineOption({
+      name: 'tag',
+      schema: z.string().transform(tags).optional(),
+      description: 'Replace tags (comma-separated, e.g.: env:prod,team:platform)',
+      placeholder: 'tag[,tag...]',
+    }),
+    autoscaling: defineOption({
+      name: 'autoscaling',
+      schema: z.boolean().default(false),
+      description: 'Enable the cluster autoscaler',
+    }),
+    disableAutoscaling: defineOption({
+      name: 'disable-autoscaling',
+      schema: z.boolean().default(false),
+      description: 'Disable the cluster autoscaler',
+    }),
+    org: orgaIdOrNameOption,
+  },
+  args: [k8sIdOrNameArg],
+  async handler(options, clusterIdOrName) {
+    const { org: orgIdOrName } = options;
+
+    if (options.autoscaling && options.disableAutoscaling) {
+      throw new Error('--autoscaling and --disable-autoscaling are mutually exclusive');
+    }
+
+    const updates = {};
+    if (options.name != null) updates.name = options.name;
+    if (options.description != null) updates.description = options.description;
+    if (options.tag != null) updates.tags = options.tag;
+
+    const features = {};
+    if (options.autoscaling) features.autoscalingEnabled = true;
+    if (options.disableAutoscaling) features.autoscalingEnabled = false;
+    if (Object.keys(features).length > 0) updates.features = features;
+
+    if (Object.keys(updates).length === 0) {
+      throw new Error(
+        'No update specified. Provide at least one of --name, --description, --tag, --autoscaling, --disable-autoscaling',
+      );
+    }
+
+    const cluster = await k8sUpdate(orgIdOrName, clusterIdOrName, updates);
+    Logger.printSuccess(`Cluster ${styleText('green', cluster.name)} updated`);
+  },
+});

package/src/commands/k8s/k8s.version.check.command.js

@@ -0,0 +1,18 @@
+import { defineCommand } from '../../lib/define-command.js';
+import { k8sCheckVersion } from '../../lib/k8s.js';
+import { humanJsonOutputFormatOption, orgaIdOrNameOption } from '../global.options.js';
+import { k8sIdOrNameArg } from './k8s.args.js';
+
+export const k8sVersionCheckCommand = defineCommand({
+  description: 'Check a Kubernetes cluster deployed version',
+  since: '4.9.0',
+  options: {
+    org: orgaIdOrNameOption,
+    format: humanJsonOutputFormatOption,
+  },
+  args: [k8sIdOrNameArg],
+  async handler(options, clusterIdOrName) {
+    const { format, org: orgIdOrName } = options;
+    await k8sCheckVersion(orgIdOrName, clusterIdOrName, format);
+  },
+});

package/src/commands/k8s/k8s.version.command.js

@@ -0,0 +1,18 @@
+import { defineCommand } from '../../lib/define-command.js';
+import { k8sCheckVersion } from '../../lib/k8s.js';
+import { humanJsonOutputFormatOption, orgaIdOrNameOption } from '../global.options.js';
+import { k8sIdOrNameArg } from './k8s.args.js';
+
+export const k8sVersionCommand = defineCommand({
+  description: 'Check a Kubernetes cluster deployed version',
+  since: '4.9.0',
+  options: {
+    org: orgaIdOrNameOption,
+    format: humanJsonOutputFormatOption,
+  },
+  args: [k8sIdOrNameArg],
+  async handler(options, clusterIdOrName) {
+    const { format, org: orgIdOrName } = options;
+    await k8sCheckVersion(orgIdOrName, clusterIdOrName, format);
+  },
+});

package/src/commands/k8s/k8s.version.update.command.js

@@ -0,0 +1,18 @@
+import { defineCommand } from '../../lib/define-command.js';
+import { k8sUpdateVersion } from '../../lib/k8s.js';
+import { orgaIdOrNameOption, targetVersionOption } from '../global.options.js';
+import { k8sIdOrNameArg } from './k8s.args.js';
+
+export const k8sVersionUpdateCommand = defineCommand({
+  description: 'Update a Kubernetes cluster to a target version',
+  since: '4.9.0',
+  options: {
+    org: orgaIdOrNameOption,
+    target: targetVersionOption,
+  },
+  args: [k8sIdOrNameArg],
+  async handler(options, clusterIdOrName) {
+    const { target, org: orgIdOrName } = options;
+    await k8sUpdateVersion(orgIdOrName, clusterIdOrName, target);
+  },
+});

package/src/commands/oauth-consumers/oauth-consumers.docs.md

@@ -52,7 +52,7 @@ clever oauth-consumers delete <consumer-key|consumer-name> [options]
 
 |Name|Description|
 |---|---|
-|`-y`, `--yes`|Skip confirmation and proceed with deletion directly|
+|`-y`, `--yes`|Skip confirmation prompts|
 
 ## ➡️ `clever oauth-consumers get` <kbd>Since 4.8.0</kbd>
 

package/src/commands/otoroshi/otoroshi.docs.md

@@ -108,6 +108,20 @@ clever otoroshi open logs <addon-id|addon-name>
 |---|---|
 |`addon-id|addon-name`|Add-on ID (or name, if unambiguous)|
 
+## ➡️ `clever otoroshi open swaggerui` <kbd>Since 4.9.0</kbd>
+
+Open the Otoroshi Swagger UI in your browser
+
+```bash
+clever otoroshi open swaggerui <addon-id|addon-name>
+```
+
+### 📥 Arguments
+
+|Name|Description|
+|---|---|
+|`addon-id|addon-name`|Add-on ID (or name, if unambiguous)|
+
 ## ➡️ `clever otoroshi open webui` <kbd>Since 3.13.0</kbd>
 
 Open the Otoroshi admin console in your browser

package/src/commands/otoroshi/otoroshi.open.swaggerui.command.js

@@ -0,0 +1,13 @@
+import { defineCommand } from '../../lib/define-command.js';
+import { operatorOpenSwaggerUi } from '../../lib/operator-commands.js';
+import { addonIdOrNameArg } from '../global.args.js';
+
+export const otoroshiOpenSwaggeruiCommand = defineCommand({
+  description: 'Open the Otoroshi Swagger UI in your browser',
+  since: '4.9.0',
+  options: {},
+  args: [addonIdOrNameArg],
+  async handler(_options, addonIdOrName) {
+    await operatorOpenSwaggerUi(addonIdOrName);
+  },
+});