@codiac.io/codiac-cli 1.3.196 → 1.3.201

package/dist/commands/pvc/list.js

@@ -0,0 +1,138 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isPvcFileStore = void 0;
+const tslib_1 = require("tslib");
+const core_1 = require("@oclif/core");
+const YAML = require("yaml");
+const _ = require("lodash");
+const contracts_1 = require("../../apis/codiac-api/contracts");
+const command_base_exec_1 = require("../../command-base-exec");
+const prettify_1 = require("../../prettify");
+const output_format_enum_1 = require("../../cli-entities/output-format-enum");
+const type_safety_utils_1 = require("../../uilogic/type-safety-utils");
+const list_1 = require("../filestore/list");
+/** FileStoreDef types whose volume access semantics REQUIRE a PVC. Mirrors
+ *  K8sFileStoreRouter.PVC_NATIVE_TYPES on the relay side. */
+const PVC_NATIVE_TYPES = new Set([
+    contracts_1.FileStoreTypeEnum.azureDisk,
+    contracts_1.FileStoreTypeEnum.azureBlobStorage,
+    contracts_1.FileStoreTypeEnum.azureNetAppFiles,
+    contracts_1.FileStoreTypeEnum.awsEbs,
+]);
+/** Returns true when the FileStoreDef is provisioned via PersistentVolumeClaim
+ *  (vs the legacy inline CSI path). Mirrors K8sFileStoreRouter.isPvcFilestore on
+ *  the relay side. */
+function isPvcFileStore(fs) {
+    var _a;
+    if (PVC_NATIVE_TYPES.has(fs.type))
+        return true;
+    if (fs.storageClass)
+        return true;
+    if (fs.volumeName)
+        return true;
+    if (fs.storageRequest)
+        return true;
+    if (fs.accessModes && fs.accessModes.length > 0)
+        return true;
+    // Legacy POC convention: AzureFileStorage with shareName starting "pvc-".
+    if (fs.type === contracts_1.FileStoreTypeEnum.azureFileStorage && ((_a = fs.shareName) === null || _a === void 0 ? void 0 : _a.startsWith('pvc-')))
+        return true;
+    return false;
+}
+exports.isPvcFileStore = isPvcFileStore;
+class PvcList extends command_base_exec_1.CommandBaseExec {
+    captureArgs() {
+        var _a;
+        return tslib_1.__awaiter(this, void 0, void 0, function* () {
+            const { flags } = yield this.parse(PvcList);
+            const partial = {};
+            if (flags.enterprise)
+                partial.enterprise = flags.enterprise;
+            if (flags.type)
+                partial.type = type_safety_utils_1.TypeSafetyUtils.toEnum(contracts_1.FileStoreTypeEnum, flags.type);
+            if (flags.output)
+                partial.outputFormat = type_safety_utils_1.TypeSafetyUtils.toEnum(output_format_enum_1.OutputFormatEnum, flags.output);
+            const takeDefaults = (_a = flags['take-defaults']) !== null && _a !== void 0 ? _a : false;
+            return [partial, takeDefaults];
+        });
+    }
+    buildCandidate_silently(partial, rootMap) {
+        var _a;
+        return tslib_1.__awaiter(this, void 0, void 0, function* () {
+            const candidate = {
+                enterprise: partial.enterprise,
+                outputFormat: (_a = partial.outputFormat) !== null && _a !== void 0 ? _a : output_format_enum_1.OutputFormatEnum.auto,
+            };
+            if (partial.type)
+                candidate.type = partial.type;
+            if (!candidate.type)
+                candidate.all = true;
+            return candidate;
+        });
+    }
+    buildCandidate_interactively(partial, rootMap, takeDefaults) {
+        return tslib_1.__awaiter(this, void 0, void 0, function* () {
+            return this.buildCandidate_silently(partial, rootMap);
+        });
+    }
+    buildCommandString(candidate, cmd) {
+        if (candidate.type)
+            cmd.push("--type", candidate.type.toString());
+        if (candidate.outputFormat)
+            cmd.push("-o", candidate.outputFormat);
+        cmd.push("--silent");
+        return cmd;
+    }
+    executeTask(candidate) {
+        return tslib_1.__awaiter(this, void 0, void 0, function* () {
+            const req = Object.assign({}, _.omit(candidate, "enterprise", "outputFormat"));
+            const list = yield this._codiacApi.FileStoreDef.readMany(req);
+            // The criteria DSL doesn't express "is PVC-backed" cleanly, so filter client-side
+            // using the same predicate the relay router uses to route between PVC and inline CSI.
+            const pvcOnly = list.filter(isPvcFileStore);
+            const output = this.renderAs(pvcOnly, candidate.outputFormat, entity => list_1.FileStoreUiLogic.displayNameFor(entity, this._styler));
+            console.log(output);
+        });
+    }
+    renderAs(list, format, textFormatter) {
+        let output = "";
+        switch (format) {
+            case output_format_enum_1.OutputFormatEnum.json:
+                output = JSON.stringify(list, undefined, 2);
+                break;
+            case output_format_enum_1.OutputFormatEnum.yaml:
+                output = YAML.stringify(list, { indent: 2 });
+                break;
+            case output_format_enum_1.OutputFormatEnum.pretty:
+            case output_format_enum_1.OutputFormatEnum.auto:
+            default:
+                if (list.length > 0) {
+                    output = textFormatter ? list.map(x => textFormatter(x)).join("\n") : (0, prettify_1.prettify)(list);
+                }
+                else {
+                    output = "None found.";
+                }
+                break;
+        }
+        return output;
+    }
+}
+exports.default = PvcList;
+PvcList.description = 'Lists the PersistentVolumeClaim-backed filestore definitions for a given enterprise.';
+PvcList.aliases = ['pvc:list'];
+PvcList.examples = [
+    '<%= config.bin %> <%= command.id %>',
+    '<%= config.bin %> <%= command.id %> --type AzureBlobStorage',
+    '<%= config.bin %> <%= command.id %> -o yaml',
+];
+PvcList.flags = {
+    help: core_1.Flags.help({ char: 'h' }),
+    enterprise: core_1.Flags.string({ char: 'e', description: 'Code name identifying the enterprise (optional if there is only one).' }),
+    type: core_1.Flags.string({ char: 't', options: Object.values(contracts_1.FileStoreTypeEnum), required: false, description: 'Filter on the storage technology backing the PVC.' }),
+    output: core_1.Flags.string({ char: 'o', default: output_format_enum_1.OutputFormatEnum.auto, description: 'Format in which to render the data.', options: [output_format_enum_1.OutputFormatEnum.json, output_format_enum_1.OutputFormatEnum.yaml, output_format_enum_1.OutputFormatEnum.auto] }),
+    silent: core_1.Flags.boolean({ exclusive: ["echo", "to-script"], description: 'Non-Interactive mode; executes without any user interaction and fails on any missing or invalid arguments.' }),
+    echo: core_1.Flags.boolean({ exclusive: ["to-script", "silent"], description: 'Echo interaction mode; renders the equivalent non-interactive cli command for future use before final execution.' }),
+    "to-script": core_1.Flags.boolean({ exclusive: ["echo", "silent"], description: 'Toscript interaction mode; renders the equivalent non-interactive cli command WITHOUT any execution.' }),
+    "take-defaults": core_1.Flags.boolean({ exclusive: ["silent"], description: "Setting this to true prevents prompting for confirmation on parameters that were passed in or were automatically set to default values (Irrelevant in --silent mode)." }),
+};
+//# sourceMappingURL=list.js.map

package/dist/commands/pvc/list.js.map

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

package/dist/relay/relay-container.js

@@ -18,7 +18,7 @@ const entities_1 = require("../ops/entities");
 // Configuration defaults
 const DEFAULT_CONFIG = {
     IMAGE_NAME: "codiacimages/codiac-relay",
-    IMAGE_TAG: "1.6.149",
+    IMAGE_TAG: "1.6.150",
     CONTAINER_NAME: "codiac-relay",
     HEALTH_CHECK_URL: "http://localhost:5799/heartbeat-json",
     RETRY_TIMEOUT_MINUTES: 1,

package/oclif.manifest.json

@@ -1,5 +1,5 @@
 {
-  "version": "1.3.196",
+  "version": "1.3.201",
   "commands": {
     "branch": {
       "id": "branch",
@@ -6712,6 +6712,7 @@
             "AzureBlobStorage",
             "AzureDisk",
             "AzureFileStorage",
+            "AzureNetAppFiles",
             "HostMachineFolder"
           ]
         },
@@ -8036,6 +8037,496 @@
         }
       }
     },
+    "pvc:create": {
+      "id": "pvc:create",
+      "description": "Defines a new PersistentVolumeClaim-backed filestore for the given enterprise. The filestore is realized as a PVC in the target cabinet at deploy time, using either a Kubernetes StorageClass for dynamic provisioning or a pre-existing PersistentVolume for static binding.",
+      "strict": true,
+      "pluginName": "@codiac.io/codiac-cli",
+      "pluginAlias": "@codiac.io/codiac-cli",
+      "pluginType": "core",
+      "aliases": [
+        "pvc:create"
+      ],
+      "hiddenAliases": [],
+      "examples": [
+        {
+          "description": "Azure File share, dynamic provisioning, default size.",
+          "command": "<%= config.bin %> <%= command.id %> -e myEnt --name shared-files --type AzureFileStorage"
+        },
+        {
+          "description": "Azure Disk per-asset (block storage), 50Gi.",
+          "command": "<%= config.bin %> <%= command.id %> -e myEnt --name app-disk --type AzureDisk --size 50Gi"
+        },
+        {
+          "description": "Azure Blob (fuse), 100Gi, statically bound to a pre-existing PV.",
+          "command": "<%= config.bin %> <%= command.id %> -e myEnt --name pvc-blob --type AzureBlobStorage --size 100Gi --volume-name pv-blob-ingestion"
+        },
+        {
+          "description": "Azure NetApp Files, statically bound, 700Gi.",
+          "command": "<%= config.bin %> <%= command.id %> -e myEnt --name pvc-nfs41-document-vault --type AzureNetAppFiles --size 700Gi --volume-name pv-nfs41-document-vault"
+        },
+        {
+          "description": "Override the default storage class (e.g., the in-tree azurefile class) on a non-prefixed PVC name.",
+          "command": "<%= config.bin %> <%= command.id %> -e myEnt --name app-documents-share --type AzureFileStorage --size 700Gi --storage-class azurefile --access-modes ReadWriteMany"
+        },
+        {
+          "description": "Non-interactive (scripted) invocation.",
+          "command": "<%= config.bin %> <%= command.id %> -e myEnt --name shared-files --type AzureFileStorage --silent"
+        },
+        {
+          "description": "Renders the equivalent silent command and then executes.",
+          "command": "<%= config.bin %> <%= command.id %> -e myEnt --name shared-files --type AzureFileStorage --echo"
+        }
+      ],
+      "flags": {
+        "help": {
+          "name": "help",
+          "type": "boolean",
+          "char": "h",
+          "description": "Show CLI help.",
+          "allowNo": false
+        },
+        "enterprise": {
+          "name": "enterprise",
+          "type": "option",
+          "char": "e",
+          "description": "Code name identifying the enterprise that will own this filestore reference.",
+          "required": false,
+          "multiple": false
+        },
+        "name": {
+          "name": "name",
+          "type": "option",
+          "char": "n",
+          "description": "Name by which this filestore is identified within the enterprise. Used to derive the PVC name.",
+          "required": false,
+          "multiple": false
+        },
+        "provider": {
+          "name": "provider",
+          "type": "option",
+          "description": "Cloud provider hosting the underlying storage (defaults to azure; only Azure is supported at this time).",
+          "required": false,
+          "multiple": false,
+          "options": [
+            "artifactHub",
+            "aws",
+            "azure",
+            "dockerHub",
+            "localMachine",
+            "other"
+          ]
+        },
+        "type": {
+          "name": "type",
+          "type": "option",
+          "char": "t",
+          "description": "Storage technology backing the PVC (defaults to AzureFileStorage).",
+          "required": false,
+          "multiple": false,
+          "options": [
+            "AzureFileStorage",
+            "AzureDisk",
+            "AzureBlobStorage",
+            "AzureNetAppFiles"
+          ]
+        },
+        "share-name": {
+          "name": "share-name",
+          "type": "option",
+          "description": "Underlying physical share name (used by the legacy AzureFileStorage path; ignored for native PVC types). Defaults to the value of --name.",
+          "required": false,
+          "multiple": false
+        },
+        "storage-class": {
+          "name": "storage-class",
+          "type": "option",
+          "description": "Kubernetes StorageClass to bind to (e.g. 'azurefile', 'azureblob-fuse-premium', 'azure-netapp-files', 'managed-csi'). Defaults to a sensible per-type class when omitted.",
+          "required": false,
+          "multiple": false
+        },
+        "access-modes": {
+          "name": "access-modes",
+          "type": "option",
+          "description": "Comma-separated PVC access modes (e.g. 'ReadWriteMany' or 'ReadWriteOnce,ReadOnlyMany'). Defaults to RWO for block storage, RWM for file/object/NAS storage. Allowed values: ReadWriteOnce, ReadOnlyMany, ReadWriteMany, ReadWriteOncePod.",
+          "required": false,
+          "multiple": false
+        },
+        "size": {
+          "name": "size",
+          "type": "option",
+          "description": "Storage capacity request as a Kubernetes quantity (e.g. '5Gi', '100Gi', '700Gi'). Defaults to 500Mi.",
+          "required": false,
+          "multiple": false
+        },
+        "volume-name": {
+          "name": "volume-name",
+          "type": "option",
+          "description": "Name of a pre-existing PersistentVolume to bind to. When set, the PVC binds statically to that PV instead of triggering dynamic provisioning.",
+          "required": false,
+          "multiple": false
+        },
+        "silent": {
+          "name": "silent",
+          "type": "boolean",
+          "description": "Non-Interactive mode; executes without any user interaction and fails on any missing or invalid arguments.",
+          "required": false,
+          "allowNo": false,
+          "dependsOn": [
+            "enterprise",
+            "name"
+          ],
+          "exclusive": [
+            "echo",
+            "to-script"
+          ]
+        },
+        "echo": {
+          "name": "echo",
+          "type": "boolean",
+          "description": "Echo interaction mode; renders the equivalent non-interactive cli command for future use before final execution.",
+          "allowNo": false,
+          "exclusive": [
+            "to-script",
+            "silent"
+          ]
+        },
+        "to-script": {
+          "name": "to-script",
+          "type": "boolean",
+          "description": "Toscript interaction mode; renders the equivalent non-interactive cli command WITHOUT any execution.",
+          "allowNo": false,
+          "exclusive": [
+            "echo",
+            "silent"
+          ]
+        },
+        "take-defaults": {
+          "name": "take-defaults",
+          "type": "boolean",
+          "description": "Setting this to true prevents prompting for confirmation on parameters that were passed in or were automatically set to default values (Irrelevant in --silent mode).",
+          "allowNo": false,
+          "exclusive": [
+            "silent"
+          ]
+        }
+      },
+      "args": {},
+      "dependsOn": [
+        "enterprise",
+        "name"
+      ]
+    },
+    "pvc:delete": {
+      "id": "pvc:delete",
+      "description": "Deletes a PersistentVolumeClaim-backed filestore definition. Removes the FileStoreDef record in Codiac; physical PVCs in cabinets are reaped on the next deploy.",
+      "strict": true,
+      "pluginName": "@codiac.io/codiac-cli",
+      "pluginAlias": "@codiac.io/codiac-cli",
+      "pluginType": "core",
+      "aliases": [
+        "pvc:delete"
+      ],
+      "hiddenAliases": [],
+      "examples": [
+        {
+          "description": "Delete by name (interactive enterprise resolution).",
+          "command": "<%= config.bin %> <%= command.id %> --name shared-files"
+        },
+        {
+          "description": "Delete by name in a specific enterprise.",
+          "command": "<%= config.bin %> <%= command.id %> -e myEnt --name shared-files --silent"
+        },
+        {
+          "description": "Delete by id (when name is ambiguous).",
+          "command": "<%= config.bin %> <%= command.id %> --id <fileStoreDefId> --silent"
+        }
+      ],
+      "flags": {
+        "help": {
+          "name": "help",
+          "type": "boolean",
+          "char": "h",
+          "description": "Show CLI help.",
+          "allowNo": false
+        },
+        "enterprise": {
+          "name": "enterprise",
+          "type": "option",
+          "char": "e",
+          "description": "Code name identifying the enterprise that owns this filestore (optional if there is only one).",
+          "multiple": false
+        },
+        "name": {
+          "name": "name",
+          "type": "option",
+          "char": "n",
+          "description": "Name of the PVC filestore to delete.",
+          "required": false,
+          "multiple": false,
+          "exclusive": [
+            "id"
+          ]
+        },
+        "id": {
+          "name": "id",
+          "type": "option",
+          "description": "System id of the FileStoreDef record. Use this when --name is ambiguous.",
+          "required": false,
+          "multiple": false,
+          "exclusive": [
+            "name"
+          ]
+        },
+        "silent": {
+          "name": "silent",
+          "type": "boolean",
+          "description": "Non-Interactive mode; executes without any user interaction and fails on any missing or invalid arguments.",
+          "allowNo": false,
+          "exclusive": [
+            "echo",
+            "to-script"
+          ]
+        },
+        "echo": {
+          "name": "echo",
+          "type": "boolean",
+          "description": "Echo interaction mode; renders the equivalent non-interactive cli command for future use before final execution.",
+          "allowNo": false,
+          "exclusive": [
+            "to-script",
+            "silent"
+          ]
+        },
+        "to-script": {
+          "name": "to-script",
+          "type": "boolean",
+          "description": "Toscript interaction mode; renders the equivalent non-interactive cli command WITHOUT any execution.",
+          "allowNo": false,
+          "exclusive": [
+            "echo",
+            "silent"
+          ]
+        },
+        "take-defaults": {
+          "name": "take-defaults",
+          "type": "boolean",
+          "description": "Setting this to true prevents prompting for confirmation on parameters that were passed in or were automatically set to default values (Irrelevant in --silent mode).",
+          "allowNo": false,
+          "exclusive": [
+            "silent"
+          ]
+        }
+      },
+      "args": {}
+    },
+    "pvc:get": {
+      "id": "pvc:get",
+      "description": "Renders the FileStoreDef record for a single PVC-backed filestore. Useful for inspecting how a PVC will be provisioned (storage class, access modes, size, static vs dynamic binding).",
+      "strict": true,
+      "pluginName": "@codiac.io/codiac-cli",
+      "pluginAlias": "@codiac.io/codiac-cli",
+      "pluginType": "core",
+      "aliases": [
+        "pvc:get"
+      ],
+      "hiddenAliases": [],
+      "examples": [
+        "<%= config.bin %> <%= command.id %> --name shared-files",
+        "<%= config.bin %> <%= command.id %> --name pvc-blob -o yaml",
+        "<%= config.bin %> <%= command.id %> --name app-documents-share --silent -o json"
+      ],
+      "flags": {
+        "help": {
+          "name": "help",
+          "type": "boolean",
+          "char": "h",
+          "description": "Show CLI help.",
+          "allowNo": false
+        },
+        "enterprise": {
+          "name": "enterprise",
+          "type": "option",
+          "char": "e",
+          "description": "Code name identifying the enterprise (optional if there is only one).",
+          "required": false,
+          "multiple": false
+        },
+        "name": {
+          "name": "name",
+          "type": "option",
+          "char": "n",
+          "description": "Name of the PVC filestore to look up.",
+          "required": false,
+          "multiple": false
+        },
+        "output": {
+          "name": "output",
+          "type": "option",
+          "char": "o",
+          "description": "Format in which to render the data.",
+          "multiple": false,
+          "options": [
+            "json",
+            "yaml",
+            "auto"
+          ],
+          "default": "auto"
+        },
+        "silent": {
+          "name": "silent",
+          "type": "boolean",
+          "description": "Non-Interactive mode; executes without any user interaction and fails on any missing or invalid arguments.",
+          "allowNo": false,
+          "dependsOn": [
+            "enterprise",
+            "name"
+          ],
+          "exclusive": [
+            "echo",
+            "to-script"
+          ]
+        },
+        "echo": {
+          "name": "echo",
+          "type": "boolean",
+          "description": "Echo interaction mode; renders the equivalent non-interactive cli command for future use before final execution.",
+          "allowNo": false,
+          "exclusive": [
+            "to-script",
+            "silent"
+          ]
+        },
+        "to-script": {
+          "name": "to-script",
+          "type": "boolean",
+          "description": "Toscript interaction mode; renders the equivalent non-interactive cli command WITHOUT any execution.",
+          "allowNo": false,
+          "exclusive": [
+            "echo",
+            "silent"
+          ]
+        },
+        "take-defaults": {
+          "name": "take-defaults",
+          "type": "boolean",
+          "description": "Setting this to true prevents prompting for confirmation on parameters that were passed in or were automatically set to default values (Irrelevant in --silent mode).",
+          "allowNo": false,
+          "exclusive": [
+            "silent"
+          ]
+        }
+      },
+      "args": {},
+      "dependsOn": [
+        "enterprise",
+        "name"
+      ]
+    },
+    "pvc:list": {
+      "id": "pvc:list",
+      "description": "Lists the PersistentVolumeClaim-backed filestore definitions for a given enterprise.",
+      "strict": true,
+      "pluginName": "@codiac.io/codiac-cli",
+      "pluginAlias": "@codiac.io/codiac-cli",
+      "pluginType": "core",
+      "aliases": [
+        "pvc:list"
+      ],
+      "hiddenAliases": [],
+      "examples": [
+        "<%= config.bin %> <%= command.id %>",
+        "<%= config.bin %> <%= command.id %> --type AzureBlobStorage",
+        "<%= config.bin %> <%= command.id %> -o yaml"
+      ],
+      "flags": {
+        "help": {
+          "name": "help",
+          "type": "boolean",
+          "char": "h",
+          "description": "Show CLI help.",
+          "allowNo": false
+        },
+        "enterprise": {
+          "name": "enterprise",
+          "type": "option",
+          "char": "e",
+          "description": "Code name identifying the enterprise (optional if there is only one).",
+          "multiple": false
+        },
+        "type": {
+          "name": "type",
+          "type": "option",
+          "char": "t",
+          "description": "Filter on the storage technology backing the PVC.",
+          "required": false,
+          "multiple": false,
+          "options": [
+            "AwsEbs",
+            "AwsEfs",
+            "AwsS3Bucket",
+            "AzureBlobStorage",
+            "AzureDisk",
+            "AzureFileStorage",
+            "AzureNetAppFiles",
+            "HostMachineFolder"
+          ]
+        },
+        "output": {
+          "name": "output",
+          "type": "option",
+          "char": "o",
+          "description": "Format in which to render the data.",
+          "multiple": false,
+          "options": [
+            "json",
+            "yaml",
+            "auto"
+          ],
+          "default": "auto"
+        },
+        "silent": {
+          "name": "silent",
+          "type": "boolean",
+          "description": "Non-Interactive mode; executes without any user interaction and fails on any missing or invalid arguments.",
+          "allowNo": false,
+          "exclusive": [
+            "echo",
+            "to-script"
+          ]
+        },
+        "echo": {
+          "name": "echo",
+          "type": "boolean",
+          "description": "Echo interaction mode; renders the equivalent non-interactive cli command for future use before final execution.",
+          "allowNo": false,
+          "exclusive": [
+            "to-script",
+            "silent"
+          ]
+        },
+        "to-script": {
+          "name": "to-script",
+          "type": "boolean",
+          "description": "Toscript interaction mode; renders the equivalent non-interactive cli command WITHOUT any execution.",
+          "allowNo": false,
+          "exclusive": [
+            "echo",
+            "silent"
+          ]
+        },
+        "take-defaults": {
+          "name": "take-defaults",
+          "type": "boolean",
+          "description": "Setting this to true prevents prompting for confirmation on parameters that were passed in or were automatically set to default values (Irrelevant in --silent mode).",
+          "allowNo": false,
+          "exclusive": [
+            "silent"
+          ]
+        }
+      },
+      "args": {}
+    },
     "secretStore:capture": {
       "id": "secretStore:capture",
       "description": "Upserts a reference to an existing secretStore.",