@codiac.io/codiac-cli 1.3.262 → 1.3.264

package/dist/commands/noc/cluster/edit.js

@@ -0,0 +1,216 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+const core_1 = require("@oclif/core");
+const command_base_exec_tenant_1 = require("../../../command-base-exec-tenant");
+const prettify_1 = require("../../../prettify");
+/**
+ * Edits the mutable connection metadata on an existing cluster record (ClusterDef.instance).
+ *
+ * WHY this exists: `cluster define` refuses to touch a cluster that has a live instance ("destroy it
+ * first"), and `cluster capture` is the only other writer of `instance.serverUrl`.  So when a cluster's
+ * apiserver url was recorded wrong — or drifted, which is what happens when a cluster is destroyed and
+ * recreated under the same name — there was no in-CLI fix short of forgetting and re-capturing the
+ * cluster, which requires tearing down every cabinet and environment attached to it first.
+ *
+ * The cluster name is the record's identity (it is the join key that environments, cabinets and the
+ * kube-context cache all resolve against), so it is immutable here; renaming a cluster is a capture,
+ * not an edit.
+ *
+ * SIDE EFFECT worth knowing: `instance.serverUrl` is the value the ops kube-context cache stamps its
+ * entries with, so changing it here also invalidates the cached kube context for this cluster on every
+ * ops replica the next time each one connects.  That is the supported way to force a credential
+ * re-fetch without restarting pods.
+ */
+class NocClusterEdit extends command_base_exec_tenant_1.CommandBaseExecTenant {
+    captureArgs() {
+        var _a;
+        return tslib_1.__awaiter(this, void 0, void 0, function* () {
+            const { args, flags } = yield this.parse(NocClusterEdit);
+            // partial.name identifies WHICH cluster (immutable).  The requested edit rides along on
+            // partial.instance so that an omitted flag is distinguishable from an explicit clear.
+            const partial = { name: args.name };
+            if (flags['server-url'] !== undefined) {
+                partial.instance = { serverUrl: NocClusterEdit.normalizeServerUrl(flags['server-url']) };
+            }
+            else if (flags['clear-server-url']) {
+                partial.instance = { serverUrl: '' };
+            }
+            return [partial, (_a = flags['take-defaults']) !== null && _a !== void 0 ? _a : false];
+        });
+    }
+    buildCandidate_silently(partial, _rootMap) {
+        return tslib_1.__awaiter(this, void 0, void 0, function* () {
+            if (!partial.name)
+                throw new Error('A cluster name must be provided (run `cod cluster list` to see names).');
+            if (partial.instance === undefined) {
+                throw new Error('Nothing to edit. Provide --server-url <url>, or --clear-server-url to remove the recorded value.');
+            }
+            const existing = yield this.readClusterDefOrThrow(partial.name);
+            return this.applyEdits(existing, partial);
+        });
+    }
+    buildCandidate_interactively(partial, takeDefaults, _rootMap) {
+        var _a, _b, _c, _d, _e;
+        return tslib_1.__awaiter(this, void 0, void 0, function* () {
+            const name = (_a = partial.name) !== null && _a !== void 0 ? _a : yield this.promptForClusterName();
+            const existing = yield this.readClusterDefOrThrow(name);
+            this._ui.userMessage(`Editing cluster ${this._styler.bold(this._styler.hilite(existing.name))} ` +
+                `${this._styler.dim(`(current apiserver url: ${((_b = existing.instance) === null || _b === void 0 ? void 0 : _b.serverUrl) || '<none recorded>'})`)}`);
+            if (partial.instance === undefined) {
+                const entered = yield this._ui.prompt('server-url', 'Apiserver url:', true, (_d = (_c = existing.instance) === null || _c === void 0 ? void 0 : _c.serverUrl) !== null && _d !== void 0 ? _d : '');
+                partial.instance = { serverUrl: NocClusterEdit.normalizeServerUrl(entered !== null && entered !== void 0 ? entered : '') };
+            }
+            const candidate = this.applyEdits(existing, Object.assign(Object.assign({}, partial), { name }));
+            this._ui.userMessage('About to save:');
+            this._ui.userMessage((0, prettify_1.prettify)({ name: candidate.name, serverUrl: (_e = candidate.instance) === null || _e === void 0 ? void 0 : _e.serverUrl }));
+            this._ui.userMessage(this._styler.dim('This also invalidates the cached kube context for this cluster; credentials will be re-fetched from the cloud provider on next use.'));
+            const confirmed = takeDefaults || (yield this._ui.promptConfirm('confirm', 'Save changes?', false));
+            if (!confirmed)
+                return undefined;
+            return candidate;
+        });
+    }
+    buildCommandString(candidate, cmd) {
+        var _a;
+        cmd.push(candidate.name);
+        if ((_a = candidate.instance) === null || _a === void 0 ? void 0 : _a.serverUrl)
+            cmd.push('--server-url', candidate.instance.serverUrl);
+        else
+            cmd.push('--clear-server-url');
+        cmd.push('--silent');
+        return cmd;
+    }
+    executeTask(candidate) {
+        var _a, _b, _c;
+        return tslib_1.__awaiter(this, void 0, void 0, function* () {
+            const result = yield this._codiacApi.ClusterDef.tryUpdate(candidate);
+            if (result.error) {
+                const msg = `Error editing cluster [${candidate.name}]: ${result.error.name} ${(_a = result.error.message) !== null && _a !== void 0 ? _a : result.error.stack}`;
+                this.logger.error(msg, result.error);
+                this._ui.userMessage(`${this._styler.colorCritical('ERROR!')} ${msg}`);
+                throw result.error;
+            }
+            else if (!result.success) {
+                this._ui.userMessage(`${this._styler.colorCritical('FAILED!')} Failed to edit cluster [${candidate.name}]. ${(_b = result.message) !== null && _b !== void 0 ? _b : 'Check logs for details.'}`);
+            }
+            else {
+                const url = (_c = candidate.instance) === null || _c === void 0 ? void 0 : _c.serverUrl;
+                this._ui.userMessage(`${this._styler.colorGood('SUCCESS!')} Cluster [${this._styler.hilite(candidate.name)}] updated — apiserver url: ` +
+                    `${this._styler.hilite(url || '<none recorded>')}. The cached kube context for this cluster will be re-fetched on next use.`);
+            }
+        });
+    }
+    // ---------------------------------------------------------------------------
+    // Helpers
+    // ---------------------------------------------------------------------------
+    /** Overlays the requested edit onto the FULL existing record.
+     *
+     *  The whole ClusterDef is written back (this is a PUT, not a patch) precisely because the
+     *  `instance` sub-document is dropped by the backend when it arrives incomplete — so the record has
+     *  to be read unprojected and returned intact with only serverUrl changed. */
+    applyEdits(existing, partial) {
+        var _a, _b, _c;
+        if (existing.instance == undefined) {
+            throw new Error(`Cannot edit the apiserver url for cluster [${existing.name}]: it has no infrastructure record. ` +
+                `Run \`cod cluster capture\` to register the live cluster first.`);
+        }
+        const requested = (_b = (_a = partial.instance) === null || _a === void 0 ? void 0 : _a.serverUrl) !== null && _b !== void 0 ? _b : '';
+        const current = (_c = existing.instance.serverUrl) !== null && _c !== void 0 ? _c : '';
+        if (requested === current) {
+            throw new Error(`Nothing to edit for [${existing.name}]: the apiserver url is already [${current || '<none recorded>'}].`);
+        }
+        if (requested.length > 0)
+            NocClusterEdit.assertUsableServerUrl(requested);
+        const candidate = Object.assign({}, existing);
+        candidate.instance = Object.assign(Object.assign({}, existing.instance), { serverUrl: requested.length > 0 ? requested : undefined });
+        return candidate;
+    }
+    readClusterDefOrThrow(clusterName) {
+        return tslib_1.__awaiter(this, void 0, void 0, function* () {
+            // Read unprojected: applyEdits writes the whole record back, so every field has to be present.
+            const found = yield this._codiacApi.ClusterDef.readMany({ name: { $eq: clusterName } }, { throwNotFound: false });
+            const existing = found === null || found === void 0 ? void 0 : found[0];
+            if (!existing)
+                throw new Error(`No cluster named [${clusterName}] was found. Run \`cod cluster list\` to see the available clusters.`);
+            return existing;
+        });
+    }
+    promptForClusterName() {
+        return tslib_1.__awaiter(this, void 0, void 0, function* () {
+            const all = yield this._codiacApi.ClusterDef.readMany({ all: true }, { throwNotFound: false });
+            if (!all || all.length === 0)
+                throw new Error('Cannot edit: no clusters are defined yet.');
+            const chosen = yield this._ui.promptSelect('name', 'Which cluster do you want to edit?', all.map(c => c.name));
+            if (!chosen)
+                throw new Error('No cluster selected.');
+            return chosen;
+        });
+    }
+    static normalizeServerUrl(url) {
+        return (url !== null && url !== void 0 ? url : '').trim();
+    }
+    /** Fails fast on input that would leave the cluster unreachable, rather than storing it and
+     *  surfacing as a connection error on the next deploy. */
+    static assertUsableServerUrl(url) {
+        let parsed;
+        try {
+            parsed = new URL(url);
+        }
+        catch (_a) {
+            throw new Error(`[${url}] is not a valid url. Provide the full apiserver url, eg: https://my-cluster.hcp.centralus.azmk8s.io:443`);
+        }
+        if (parsed.protocol !== 'https:' && parsed.protocol !== 'http:') {
+            throw new Error(`[${url}] must be an http(s) url. The apiserver url is the remote target for kubectl, eg: https://10.110.128.10:443`);
+        }
+    }
+}
+exports.default = NocClusterEdit;
+NocClusterEdit.description = 'Changes the mutable connection metadata (apiserver url) on an existing cluster record. ' +
+    'DOES NOT modify any infrastructure; it only corrects what Codiac has recorded about the cluster. ' +
+    'The cluster name is immutable — use `cod cluster capture` to register a different cluster. ' +
+    'Changing the apiserver url also invalidates the cached kube context for this cluster, forcing a ' +
+    'fresh credential fetch from the cloud provider on next use.';
+NocClusterEdit.aliases = ['cluster:edit'];
+NocClusterEdit.examples = [
+    {
+        description: 'Edit a cluster interactively (select it, then change its apiserver url).',
+        command: '<%= config.bin %> <%= command.id %>',
+    },
+    {
+        description: "Correct the apiserver url Codiac has recorded for a cluster.",
+        command: '<%= config.bin %> <%= command.id %> my-cluster --server-url https://my-cluster.hcp.centralus.azmk8s.io:443 --silent',
+    },
+    {
+        description: 'Point a private cluster at its private-link address.',
+        command: '<%= config.bin %> <%= command.id %> my-cluster --server-url https://10.110.128.10:443 --silent',
+    },
+    {
+        description: 'Drop the recorded url so the next capture repopulates it from the cloud provider.',
+        command: '<%= config.bin %> <%= command.id %> my-cluster --clear-server-url --silent',
+    },
+    {
+        description: 'Renders the equivalent silent command without executing it.',
+        command: '<%= config.bin %> <%= command.id %> my-cluster --server-url https://10.110.128.10:443 --to-script',
+    },
+];
+NocClusterEdit.args = {
+    name: core_1.Args.string({ description: 'Name of the cluster whose record you want to edit. Run `cod cluster list` to see names.' }),
+};
+NocClusterEdit.flags = {
+    help: core_1.Flags.help({ char: 'h' }),
+    'server-url': core_1.Flags.string({
+        exclusive: ['clear-server-url'],
+        description: 'The apiserver url Codiac should record for this cluster (the remote target for kubectl), ' +
+            'eg: https://my-cluster.hcp.centralus.azmk8s.io:443. Omit to leave it unchanged.',
+    }),
+    'clear-server-url': core_1.Flags.boolean({
+        exclusive: ['server-url'],
+        description: 'Removes the recorded apiserver url, leaving it for the next `cod cluster capture` to repopulate.',
+    }),
+    'take-defaults': core_1.Flags.boolean({ description: 'Prevents prompting for confirmation on parameters that were passed in or defaulted.' }),
+    silent: core_1.Flags.boolean({ exclusive: ['echo', 'to-script'], description: 'Executes without any user interaction; fails on missing or invalid arguments.' }),
+    echo: core_1.Flags.boolean({ exclusive: ['to-script', 'silent'], description: 'Renders the equivalent non-interactive command for future use before executing.' }),
+    'to-script': core_1.Flags.boolean({ exclusive: ['echo', 'silent'], description: 'Renders the equivalent non-interactive command without executing it.' }),
+};
+//# sourceMappingURL=edit.js.map

package/dist/commands/noc/cluster/edit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"edit.js","sourceRoot":"","sources":["../../../../src/commands/noc/cluster/edit.ts"],"names":[],"mappings":"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"}

package/dist/uilogic/cloud-resource-configurators/asset-configurator.js

@@ -360,7 +360,7 @@ let AssetConfigurator = class AssetConfigurator {
             let output = Number.parseInt(parts[0]);
             const valid = this.portIsValid(output);
             if (typeof valid === 'object')
-                throw new Error("Invalid port number: ".concat((_a = valid.reason) !== null && _a !== void 0 ? _a : "Must be an integer between 0 and ".concat(this.MAX_PORT_NUMBER.toString())));
+                throw new Error("Invalid port number: ".concat((_a = valid.reason) !== null && _a !== void 0 ? _a : "Must be an integer between 1 and ".concat(this.MAX_PORT_NUMBER.toString())));
             return output;
         }
         else {
@@ -369,9 +369,9 @@ let AssetConfigurator = class AssetConfigurator {
             const extValid = this.portIsValid(output.external);
             const intValid = this.portIsValid(output.internal);
             if (typeof extValid === 'object')
-                throw new Error("Invalid external port number: ".concat((_b = extValid.reason) !== null && _b !== void 0 ? _b : "Must be an integer between 0 and ", this.MAX_PORT_NUMBER.toString()));
+                throw new Error("Invalid external port number: ".concat((_b = extValid.reason) !== null && _b !== void 0 ? _b : "Must be an integer between 1 and ", this.MAX_PORT_NUMBER.toString()));
             if (typeof intValid === 'object')
-                throw new Error("Invalid internal port number: ".concat((_c = intValid.reason) !== null && _c !== void 0 ? _c : "Must be an integer between 0 and ", this.MAX_PORT_NUMBER.toString()));
+                throw new Error("Invalid internal port number: ".concat((_c = intValid.reason) !== null && _c !== void 0 ? _c : "Must be an integer between 1 and ", this.MAX_PORT_NUMBER.toString()));
             return output;
         }
     }

package/oclif.manifest.json

@@ -1,5 +1,5 @@
 {
-  "version": "1.3.262",
+  "version": "1.3.264",
   "commands": {
     "branch": {
       "id": "branch",
@@ -1681,7 +1681,7 @@
           "name": "port",
           "type": "option",
           "char": "p",
-          "description": "The default port number (from 0 to 65535) to assign the asset when deployed to a cabinet (optional).  To specify port forwarding (betw the service and container), use format: `<service-port>:<container-port>`, eg: `3555:80`",
+          "description": "The default port number (from 1 to 65535) to assign the asset when deployed to a cabinet (optional).  To specify port forwarding (betw the service and container), use format: `<service-port>:<container-port>`, eg: `3555:80`",
           "required": false,
           "multiple": true
         },
@@ -7222,6 +7222,86 @@
         }
       }
     },
+    "host:recapture": {
+      "id": "host:recapture",
+      "description": "Re-reads a cluster's ingress (LoadBalancer) IP from the cluster and updates the cluster record, clearing a !MISSING! ingress IP in the host-naming map.",
+      "strict": true,
+      "pluginName": "@codiac.io/codiac-cli",
+      "pluginAlias": "@codiac.io/codiac-cli",
+      "pluginType": "core",
+      "aliases": [
+        "ingress:recapture"
+      ],
+      "hiddenAliases": [],
+      "examples": [
+        {
+          "description": "Recapture interactively (prompts for the cluster).",
+          "command": "<%= config.bin %> <%= command.id %>"
+        },
+        {
+          "description": "Recapture a specific cluster non-interactively.",
+          "command": "<%= config.bin %> <%= command.id %> my-cluster -e myEnterprise --silent"
+        },
+        {
+          "description": "Renders the equivalent silent command without executing.",
+          "command": "<%= config.bin %> <%= command.id %> my-cluster --to-script"
+        }
+      ],
+      "flags": {
+        "help": {
+          "name": "help",
+          "type": "boolean",
+          "char": "h",
+          "description": "Show CLI help.",
+          "allowNo": false
+        },
+        "enterprise": {
+          "name": "enterprise",
+          "type": "option",
+          "char": "e",
+          "description": "The enterprise whose rootmap contains the cluster (optional when there is only one enterprise).",
+          "required": false,
+          "multiple": false
+        },
+        "silent": {
+          "name": "silent",
+          "type": "boolean",
+          "description": "Executes without any user interaction; fails on missing or invalid arguments.",
+          "allowNo": false,
+          "exclusive": [
+            "echo",
+            "to-script"
+          ]
+        },
+        "echo": {
+          "name": "echo",
+          "type": "boolean",
+          "description": "Renders the equivalent non-interactive command for future use before executing.",
+          "allowNo": false,
+          "exclusive": [
+            "to-script",
+            "silent"
+          ]
+        },
+        "to-script": {
+          "name": "to-script",
+          "type": "boolean",
+          "description": "Renders the equivalent non-interactive command without executing it.",
+          "allowNo": false,
+          "exclusive": [
+            "echo",
+            "silent"
+          ]
+        }
+      },
+      "args": {
+        "cluster": {
+          "name": "cluster",
+          "description": "Name of the cluster whose ingress IP to recapture (optional when there is only one cluster).",
+          "required": false
+        }
+      }
+    },
     "host:view": {
       "id": "host:view",
       "description": "Retrieves the overall map of domain routes for the given enterprise, resulting from the current host mapping strategies, environments, and assets.",
@@ -10938,6 +11018,13 @@
           "required": false,
           "multiple": false
         },
+        "disabled": {
+          "name": "disabled",
+          "type": "boolean",
+          "description": "Keeps the definition on record but stops it being applied to the asset at deploy time. Pass --disabled to park a probe without deleting it; omit to leave it active.",
+          "required": false,
+          "allowNo": true
+        },
         "predefined": {
           "name": "predefined",
           "type": "option",
@@ -14991,6 +15078,109 @@
         }
       }
     },
+    "noc:cluster:edit": {
+      "id": "noc:cluster:edit",
+      "description": "Changes the mutable connection metadata (apiserver url) on an existing cluster record. DOES NOT modify any infrastructure; it only corrects what Codiac has recorded about the cluster. The cluster name is immutable — use `cod cluster capture` to register a different cluster. Changing the apiserver url also invalidates the cached kube context for this cluster, forcing a fresh credential fetch from the cloud provider on next use.",
+      "strict": true,
+      "pluginName": "@codiac.io/codiac-cli",
+      "pluginAlias": "@codiac.io/codiac-cli",
+      "pluginType": "core",
+      "aliases": [
+        "cluster:edit"
+      ],
+      "hiddenAliases": [],
+      "examples": [
+        {
+          "description": "Edit a cluster interactively (select it, then change its apiserver url).",
+          "command": "<%= config.bin %> <%= command.id %>"
+        },
+        {
+          "description": "Correct the apiserver url Codiac has recorded for a cluster.",
+          "command": "<%= config.bin %> <%= command.id %> my-cluster --server-url https://my-cluster.hcp.centralus.azmk8s.io:443 --silent"
+        },
+        {
+          "description": "Point a private cluster at its private-link address.",
+          "command": "<%= config.bin %> <%= command.id %> my-cluster --server-url https://10.110.128.10:443 --silent"
+        },
+        {
+          "description": "Drop the recorded url so the next capture repopulates it from the cloud provider.",
+          "command": "<%= config.bin %> <%= command.id %> my-cluster --clear-server-url --silent"
+        },
+        {
+          "description": "Renders the equivalent silent command without executing it.",
+          "command": "<%= config.bin %> <%= command.id %> my-cluster --server-url https://10.110.128.10:443 --to-script"
+        }
+      ],
+      "flags": {
+        "help": {
+          "name": "help",
+          "type": "boolean",
+          "char": "h",
+          "description": "Show CLI help.",
+          "allowNo": false
+        },
+        "server-url": {
+          "name": "server-url",
+          "type": "option",
+          "description": "The apiserver url Codiac should record for this cluster (the remote target for kubectl), eg: https://my-cluster.hcp.centralus.azmk8s.io:443. Omit to leave it unchanged.",
+          "multiple": false,
+          "exclusive": [
+            "clear-server-url"
+          ]
+        },
+        "clear-server-url": {
+          "name": "clear-server-url",
+          "type": "boolean",
+          "description": "Removes the recorded apiserver url, leaving it for the next `cod cluster capture` to repopulate.",
+          "allowNo": false,
+          "exclusive": [
+            "server-url"
+          ]
+        },
+        "take-defaults": {
+          "name": "take-defaults",
+          "type": "boolean",
+          "description": "Prevents prompting for confirmation on parameters that were passed in or defaulted.",
+          "allowNo": false
+        },
+        "silent": {
+          "name": "silent",
+          "type": "boolean",
+          "description": "Executes without any user interaction; fails on missing or invalid arguments.",
+          "allowNo": false,
+          "exclusive": [
+            "echo",
+            "to-script"
+          ]
+        },
+        "echo": {
+          "name": "echo",
+          "type": "boolean",
+          "description": "Renders the equivalent non-interactive command for future use before executing.",
+          "allowNo": false,
+          "exclusive": [
+            "to-script",
+            "silent"
+          ]
+        },
+        "to-script": {
+          "name": "to-script",
+          "type": "boolean",
+          "description": "Renders the equivalent non-interactive command without executing it.",
+          "allowNo": false,
+          "exclusive": [
+            "echo",
+            "silent"
+          ]
+        }
+      },
+      "args": {
+        "name": {
+          "name": "name",
+          "description": "Name of the cluster whose record you want to edit. Run `cod cluster list` to see names."
+        }
+      }
+    },
     "noc:cluster:forget": {
       "id": "noc:cluster:forget",
       "description": "Permanently removes the record of a cluster.  This command does NOT affect any infrastructure; it simply removes the cluster from the Codiac consciousness. You must remove all cabinets and environments in a cluster before forgetting it.",

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@codiac.io/codiac-cli",
   "description": "Local command line interface for managing enterprise assets and environments.",
-  "version": "1.3.262",
+  "version": "1.3.264",
   "author": "Codiac",
   "bin": {
     "codiac": "./bin/run",
@@ -173,6 +173,9 @@
       "@oclif/plugin-update"
     ],
     "update": {
+      "node": {
+        "version": "22.15.1"
+      },
       "s3": {
         "bucket": "installers-for-cli",
         "host": "https://installers-for-cli.s3.amazonaws.com"