@cat-indev/catops-cli 0.0.1-alpha.5

package/dist/services/kubectl.js

@@ -0,0 +1,266 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DeploymentGroupRolloutError = exports.DeploymentRolloutError = void 0;
+exports.apply = apply;
+exports.del = del;
+exports.delete = del;
+exports.get = get;
+exports.logs = logs;
+exports.rolloutStatus = rolloutStatus;
+exports.setImage = setImage;
+exports.waitForDeployment = waitForDeployment;
+exports.waitForDeploymentGroup = waitForDeploymentGroup;
+const shell_1 = require("./shell");
+function isKubectlOptions(value) {
+    return Boolean(value)
+        && typeof value === "object"
+        && !Array.isArray(value)
+        && ("kubeconfig" in value || "namespace" in value || Object.keys(value).length === 0);
+}
+function withGlobalFlags(args, options = {}) {
+    const result = [...args];
+    if (options.kubeconfig) {
+        result.push("--kubeconfig", options.kubeconfig);
+    }
+    if (options.namespace) {
+        result.push("-n", options.namespace);
+    }
+    return result;
+}
+function apply(file, options = {}) {
+    return shell_1.shell.exec("kubectl", ...withGlobalFlags(["apply", "-f", file], options));
+}
+function del(file, options = {}) {
+    return shell_1.shell.exec("kubectl", ...withGlobalFlags(["delete", "-f", file], options));
+}
+/**
+ * Igual que antes (`kubectl.get("pods", "-o", "wide")`), pero ahora también
+ * acepta KubectlOptions como último argumento:
+ *   kubectl.get("pods", "-o", "wide", { namespace: "prod" })
+ */
+function get(...rawArgs) {
+    let args = rawArgs;
+    let options = {};
+    const last = rawArgs[rawArgs.length - 1];
+    if (rawArgs.length && isKubectlOptions(last)) {
+        options = last;
+        args = rawArgs.slice(0, -1);
+    }
+    return shell_1.shell.exec("kubectl", "get", ...withGlobalFlags(args, options));
+}
+function logs(pod, options = {}) {
+    return shell_1.shell.exec("kubectl", ...withGlobalFlags(["logs", pod], options));
+}
+function rolloutStatus(deployment, options = {}) {
+    return shell_1.shell.exec("kubectl", ...withGlobalFlags(["rollout", "status", deployment], options));
+}
+function setImage(resource, image, options = {}) {
+    return shell_1.shell.exec("kubectl", ...withGlobalFlags(["set", "image", resource, image], options));
+}
+// ---------------------------------------------------------------------------
+// waitForDeployment — validación cíclica del rollout de un Deployment
+// ---------------------------------------------------------------------------
+function sleep(ms) {
+    return new Promise(resolve => setTimeout(resolve, ms));
+}
+/**
+ * Se lanza cuando `waitForDeployment` no llega a un rollout exitoso, ya sea
+ * por timeout global, por quedarse en estado Failed sin recuperarse, o por
+ * superar el máximo de reinicios permitido. Lleva `command: "kubectl"` para
+ * que `classifiers.byCommand({ kubectl: "kubernetes" })` lo clasifique
+ * automáticamente si usas el sistema de notificaciones.
+ */
+class DeploymentRolloutError extends Error {
+    constructor(message, info) {
+        super(message);
+        this.command = "kubectl";
+        this.name = "DeploymentRolloutError";
+        this.status = info.status;
+        this.deployment = info.deployment;
+        this.elapsedMs = info.elapsedMs;
+        this.restarts = info.restarts;
+    }
+}
+exports.DeploymentRolloutError = DeploymentRolloutError;
+async function readDeploymentJSON(name, options) {
+    const result = await get(`deployment/${name}`, "-o", "json", options);
+    return JSON.parse(result.stdout);
+}
+async function countPodRestarts(matchLabels, options) {
+    if (!matchLabels || !Object.keys(matchLabels).length) {
+        return 0;
+    }
+    const selector = Object.entries(matchLabels)
+        .map(([key, value]) => `${key}=${value}`)
+        .join(",");
+    const result = await get("pods", "-l", selector, "-o", "json", options);
+    const parsed = JSON.parse(result.stdout);
+    return (parsed.items ?? []).reduce((total, pod) => {
+        const podRestarts = (pod.status?.containerStatuses ?? [])
+            .reduce((sum, container) => sum + (container.restartCount ?? 0), 0);
+        return total + podRestarts;
+    }, 0);
+}
+function isProgressingFailed(conditions) {
+    const progressing = conditions.find(c => c.type === "Progressing");
+    if (progressing?.status === "False")
+        return true;
+    return conditions.some(c => c.type === "ReplicaFailure" && c.status === "True");
+}
+/**
+ * Valida cíclicamente el estado de un Deployment hasta que:
+ *   - llega a estado exitoso (replicas listas/actualizadas == replicas deseadas) -> resuelve,
+ *   - supera `maxRestarts` reinicios acumulados -> lanza DeploymentRolloutError,
+ *   - se queda en estado Failed más de `failedGracePeriod` sin recuperarse -> lanza DeploymentRolloutError,
+ *   - o se cumple `timeout` sin éxito -> lanza DeploymentRolloutError.
+ *
+ * En cualquier caso de error, el polling se detiene ("se mata el proceso")
+ * y el error se re-lanza, listo para que `ctx.run(...)` lo capture y lo
+ * reporte vía `ctx.notifier` si lo tienes configurado.
+ */
+async function waitForDeployment(options) {
+    const { deployment, timeout = 300000, pollInterval = 5000, failedGracePeriod = pollInterval * 6, maxRestarts, ...kubectlOptions } = options;
+    const startedAt = Date.now();
+    let failedSince = null;
+    while (true) {
+        const elapsedMs = Date.now() - startedAt;
+        if (elapsedMs >= timeout) {
+            const message = `Timeout esperando el rollout de "${deployment}" (${timeout}ms)`;
+            throw new DeploymentRolloutError(message, { status: "timeout", deployment, elapsedMs, restarts: -1 });
+        }
+        let json;
+        try {
+            json = await readDeploymentJSON(deployment, kubectlOptions);
+        }
+        catch {
+            // El recurso puede no existir todavía (justo después de un apply); reintenta.
+            await sleep(pollInterval);
+            continue;
+        }
+        const desired = json.spec?.replicas ?? 1;
+        const ready = json.status?.readyReplicas ?? 0;
+        const updated = json.status?.updatedReplicas ?? 0;
+        const conditions = json.status?.conditions ?? [];
+        const failed = isProgressingFailed(conditions);
+        const success = !failed && ready >= desired && updated >= desired;
+        let restarts = 0;
+        if (maxRestarts !== undefined) {
+            restarts = await countPodRestarts(json.spec?.selector?.matchLabels, kubectlOptions);
+            if (restarts > maxRestarts) {
+                const message = `Deployment "${deployment}" superó el máximo de reinicios permitido (${restarts} > ${maxRestarts})`;
+                throw new DeploymentRolloutError(message, { status: "failed", deployment, elapsedMs, restarts });
+            }
+        }
+        if (success) {
+            const message = `Deployment "${deployment}" alcanzó el estado esperado (${ready}/${desired} listas)`;
+            return { status: "success", deployment, elapsedMs, restarts, message };
+        }
+        if (failed) {
+            if (failedSince === null) {
+                failedSince = Date.now();
+            }
+            else if (Date.now() - failedSince >= failedGracePeriod) {
+                const message = `Deployment "${deployment}" quedó en estado Failed y no se recuperó en ${failedGracePeriod}ms`;
+                throw new DeploymentRolloutError(message, { status: "failed", deployment, elapsedMs, restarts });
+            }
+        }
+        else {
+            failedSince = null;
+        }
+        await sleep(pollInterval);
+    }
+}
+/**
+ * Se lanza cuando `waitForDeploymentGroup` no logra que TODAS las instancias
+ * del grupo lleguen a estado exitoso. Lleva `command: "kubectl"` para que
+ * `classifiers.byCommand({ kubectl: "kubernetes" })` lo clasifique solo.
+ */
+class DeploymentGroupRolloutError extends Error {
+    constructor(message, info) {
+        super(message);
+        this.command = "kubectl";
+        this.name = "DeploymentGroupRolloutError";
+        this.label = info.label;
+        this.elapsedMs = info.elapsedMs;
+        this.succeeded = info.succeeded;
+        this.failed = info.failed;
+    }
+}
+exports.DeploymentGroupRolloutError = DeploymentGroupRolloutError;
+function toSelectorString(label) {
+    if (typeof label === "string")
+        return label;
+    return Object.entries(label)
+        .map(([key, value]) => `${key}=${value}`)
+        .join(",");
+}
+async function listDeploymentNames(selector, options) {
+    const result = await get("deployments", "-l", selector, "-o", "json", options);
+    const parsed = JSON.parse(result.stdout);
+    return (parsed.items ?? [])
+        .map(item => item.metadata?.name)
+        .filter((name) => Boolean(name));
+}
+/**
+ * Descubre todos los Deployments que compartan el `label` dado (p. ej.
+ * todas las instancias GitOps de un mismo repo, marcadas con
+ * `deployment-group: repository-14`) y espera a que TODAS lleguen a estado
+ * exitoso, corriendo `waitForDeployment` por cada una en paralelo con el
+ * mismo `timeout` global.
+ *
+ * Si alguna instancia falla (timeout individual, Failed sin recuperarse, o
+ * maxRestarts superado), se espera a que terminen las demás y se lanza
+ * `DeploymentGroupRolloutError` con el detalle de cuáles fallaron y cuáles sí
+ * llegaron a estado exitoso — listo para que `ctx.run(...)` lo capture y lo
+ * reporte vía `ctx.notifier`.
+ */
+async function waitForDeploymentGroup(options) {
+    const { label, timeout = 300000, pollInterval = 5000, failedGracePeriod = pollInterval * 6, maxRestarts, ...kubectlOptions } = options;
+    const selector = toSelectorString(label);
+    const startedAt = Date.now();
+    const names = await listDeploymentNames(selector, kubectlOptions);
+    if (!names.length) {
+        const message = `No se encontraron deployments con el label "${selector}"`;
+        throw new DeploymentGroupRolloutError(message, {
+            label: selector,
+            elapsedMs: Date.now() - startedAt,
+            succeeded: [],
+            failed: []
+        });
+    }
+    const remainingMs = () => Math.max(0, timeout - (Date.now() - startedAt));
+    const settled = await Promise.allSettled(names.map(deployment => waitForDeployment({
+        deployment,
+        timeout: remainingMs(),
+        pollInterval,
+        failedGracePeriod,
+        maxRestarts,
+        ...kubectlOptions
+    })));
+    const succeeded = [];
+    const failed = [];
+    const deployments = [];
+    settled.forEach((outcome, index) => {
+        const name = names[index];
+        if (outcome.status === "fulfilled") {
+            succeeded.push(name);
+            deployments.push(outcome.value);
+            return;
+        }
+        const reason = outcome.reason;
+        failed.push({
+            deployment: name,
+            status: reason?.status ?? "failed",
+            message: reason?.message ?? String(outcome.reason)
+        });
+    });
+    const elapsedMs = Date.now() - startedAt;
+    if (failed.length) {
+        const summary = failed.map(f => `${f.deployment} (${f.status})`).join(", ");
+        const message = `${failed.length}/${names.length} deployments del grupo "${selector}" no llegaron a estado exitoso: ${summary}`;
+        throw new DeploymentGroupRolloutError(message, { label: selector, elapsedMs, succeeded, failed });
+    }
+    const message = `Los ${names.length} deployments del grupo "${selector}" alcanzaron el estado esperado`;
+    return { status: "success", label: selector, elapsedMs, deployments, message };
+}
+//# sourceMappingURL=kubectl.js.map

package/dist/services/kubectl.js.map

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

package/dist/services/npm.d.ts

@@ -0,0 +1,5 @@
+import type { ExecResult } from "../core/types";
+export declare function install(): Promise<ExecResult>;
+export declare function ci(): Promise<ExecResult>;
+export declare function run(script: string): Promise<ExecResult>;
+export declare function publish(): Promise<ExecResult>;

package/dist/services/npm.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.install = install;
+exports.ci = ci;
+exports.run = run;
+exports.publish = publish;
+const shell_1 = require("./shell");
+function install() {
+    return shell_1.shell.exec("npm", "install");
+}
+function ci() {
+    return shell_1.shell.exec("npm", "ci");
+}
+function run(script) {
+    return shell_1.shell.exec("npm", "run", script);
+}
+function publish() {
+    return shell_1.shell.exec("npm", "publish");
+}
+//# sourceMappingURL=npm.js.map

package/dist/services/npm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"npm.js","sourceRoot":"","sources":["../../src/services/npm.ts"],"names":[],"mappings":";;AAGA,0BAEC;AAED,gBAEC;AAED,kBAEC;AAED,0BAEC;AAjBD,mCAAgC;AAGhC,SAAgB,OAAO;IACnB,OAAO,aAAK,CAAC,IAAI,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;AACxC,CAAC;AAED,SAAgB,EAAE;IACd,OAAO,aAAK,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;AACnC,CAAC;AAED,SAAgB,GAAG,CAAC,MAAc;IAC9B,OAAO,aAAK,CAAC,IAAI,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;AAC5C,CAAC;AAED,SAAgB,OAAO;IACnB,OAAO,aAAK,CAAC,IAAI,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;AACxC,CAAC"}

package/dist/services/oc.d.ts

@@ -0,0 +1,146 @@
+import type { ExecResult } from "../core/types";
+export interface OcOptions {
+    /** Ruta al archivo kubeconfig. Se pasa como --kubeconfig <path>. */
+    kubeconfig?: string;
+    /** Namespace/proyecto destino. Se pasa como -n <namespace>. */
+    namespace?: string;
+}
+export interface OcLoginOptions extends OcOptions {
+    server: string;
+    token?: string;
+    username?: string;
+    password?: string;
+    insecureSkipTlsVerify?: boolean;
+}
+export interface OcStartBuildOptions extends OcOptions {
+    follow?: boolean;
+}
+export declare function login({ server, token, username, password, insecureSkipTlsVerify, ...options }: OcLoginOptions): Promise<ExecResult>;
+export declare function project(name: string, options?: OcOptions): Promise<ExecResult>;
+export declare function apply(file: string, options?: OcOptions): Promise<ExecResult>;
+/**
+ * Igual que antes (`oc.get("pods", "-o", "wide")`), pero ahora también
+ * acepta OcOptions como último argumento:
+ *   oc.get("pods", "-o", "wide", { namespace: "prod" })
+ */
+export declare function get(...rawArgs: Array<string | OcOptions>): Promise<ExecResult>;
+export declare function rollout(deployment: string, options?: OcOptions): Promise<ExecResult>;
+export declare function newApp(...args: string[]): Promise<ExecResult>;
+export declare function startBuild(buildConfig: string, { follow, ...options }?: OcStartBuildOptions): Promise<ExecResult>;
+export declare function logs(pod: string, options?: OcOptions): Promise<ExecResult>;
+export type DeploymentRolloutStatus = "success" | "failed" | "timeout";
+export interface DeploymentWatchResult {
+    status: DeploymentRolloutStatus;
+    deployment: string;
+    elapsedMs: number;
+    restarts: number;
+    message: string;
+}
+/**
+ * Se lanza cuando `waitForDeployment` no llega a un rollout exitoso. Lleva
+ * `command: "oc"` para que `classifiers.byCommand({ oc: "kubernetes" })`
+ * lo clasifique automáticamente si usas el sistema de notificaciones.
+ */
+export declare class DeploymentRolloutError extends Error {
+    readonly command = "oc";
+    readonly status: DeploymentRolloutStatus;
+    readonly deployment: string;
+    readonly elapsedMs: number;
+    readonly restarts: number;
+    constructor(message: string, info: Omit<DeploymentWatchResult, "message">);
+}
+export interface WaitForDeploymentOptions extends OcOptions {
+    /** Nombre del deployment/deploymentconfig, sin prefijo de recurso. */
+    deployment: string;
+    /** "deployment" (k8s nativo, default) o "dc" (DeploymentConfig clásico de OpenShift). */
+    resourceType?: "deployment" | "dc";
+    /** Milisegundos totales antes de abortar y reportar error. Default: 300000 (5 min). */
+    timeout?: number;
+    /** Milisegundos entre cada chequeo. Default: 5000. */
+    pollInterval?: number;
+    /**
+     * Si el recurso entra en estado Failed, milisegundos a esperar para ver
+     * si se recupera solo antes de darlo por fallido. Default: `pollInterval * 6`.
+     */
+    failedGracePeriod?: number;
+    /**
+     * Máximo de reinicios (sumados entre todos los pods/containers) tolerados
+     * antes de abortar inmediatamente. Si no se pasa, no se valida.
+     */
+    maxRestarts?: number;
+}
+/**
+ * Valida cíclicamente el estado de un Deployment/DeploymentConfig hasta que:
+ *   - llega a estado exitoso (replicas listas/actualizadas == replicas deseadas) -> resuelve,
+ *   - supera `maxRestarts` reinicios acumulados -> lanza DeploymentRolloutError,
+ *   - se queda en estado Failed más de `failedGracePeriod` sin recuperarse -> lanza DeploymentRolloutError,
+ *   - o se cumple `timeout` sin éxito -> lanza DeploymentRolloutError.
+ *
+ * El polling se detiene ("se mata el proceso") apenas se detecta cualquiera
+ * de las condiciones de fallo, re-lanzando el error para que `ctx.run(...)`
+ * lo capture y lo reporte vía `ctx.notifier` si lo tienes configurado.
+ */
+export declare function waitForDeployment(options: WaitForDeploymentOptions): Promise<DeploymentWatchResult>;
+export type DeploymentGroupStatus = "success" | "failed" | "timeout";
+export interface DeploymentGroupFailure {
+    deployment: string;
+    status: DeploymentRolloutStatus;
+    message: string;
+}
+export interface DeploymentGroupWatchResult {
+    status: "success";
+    label: string;
+    elapsedMs: number;
+    deployments: DeploymentWatchResult[];
+    message: string;
+}
+/**
+ * Se lanza cuando `waitForDeploymentGroup` no logra que TODAS las instancias
+ * del grupo lleguen a estado exitoso. Lleva `command: "oc"` para que
+ * `classifiers.byCommand({ oc: "kubernetes" })` lo clasifique solo.
+ */
+export declare class DeploymentGroupRolloutError extends Error {
+    readonly command = "oc";
+    readonly label: string;
+    readonly elapsedMs: number;
+    readonly succeeded: string[];
+    readonly failed: DeploymentGroupFailure[];
+    constructor(message: string, info: {
+        label: string;
+        elapsedMs: number;
+        succeeded: string[];
+        failed: DeploymentGroupFailure[];
+    });
+}
+export interface WaitForDeploymentGroupOptions extends OcOptions {
+    /**
+     * Label que agrupa todas las instancias del despliegue. Puede ser el
+     * selector ya armado ("deployment-group=repository-14") o un objeto
+     * ({ "deployment-group": "repository-14" }).
+     */
+    label: string | Record<string, string>;
+    /** "deployment" (k8s nativo, default) o "dc" (DeploymentConfig clásico de OpenShift). */
+    resourceType?: "deployment" | "dc";
+    /** Milisegundos totales antes de abortar el grupo entero. Default: 300000 (5 min). */
+    timeout?: number;
+    /** Milisegundos entre cada chequeo, por instancia. Default: 5000. */
+    pollInterval?: number;
+    /** Igual que en waitForDeployment, aplicado a cada instancia del grupo. */
+    failedGracePeriod?: number;
+    /** Igual que en waitForDeployment, aplicado a cada instancia del grupo. */
+    maxRestarts?: number;
+}
+/**
+ * Descubre todos los Deployments/DeploymentConfigs que compartan el `label`
+ * dado (p. ej. todas las instancias GitOps de un mismo repo, marcadas con
+ * `deployment-group: repository-14`) y espera a que TODAS lleguen a estado
+ * exitoso, corriendo `waitForDeployment` por cada una en paralelo con el
+ * mismo `timeout` global.
+ *
+ * Si alguna instancia falla (timeout individual, Failed sin recuperarse, o
+ * maxRestarts superado), se espera a que terminen las demás y se lanza
+ * `DeploymentGroupRolloutError` con el detalle de cuáles fallaron y cuáles sí
+ * llegaron a estado exitoso — listo para que `ctx.run(...)` lo capture y lo
+ * reporte vía `ctx.notifier`.
+ */
+export declare function waitForDeploymentGroup(options: WaitForDeploymentGroupOptions): Promise<DeploymentGroupWatchResult>;