ninedeploy 0.16.8 → 0.16.10

package/README.md

@@ -164,6 +164,23 @@ ninedeploy status-pages publish|unpublish|rm <id>
 ninedeploy status-pages notice <id> "Maintenance at 22:00"    # --clear removes it
 ```
 
+### 🐤 Canary Releases (0.16.9)
+```bash
+ninedeploy canary show web [--json]                     # Configuration, and the running canary: step, share, 5xx %, p95
+ninedeploy canary set web --steps 10,50 --max-p95 800   # Options not given keep their value; --max-p95 off stops judging it
+ninedeploy canary off web                               # The next deploy switches all traffic at once
+ninedeploy canary promote web [--deployment <id>]       # Skip the remaining steps; stop one with `deploys cancel`
+```
+
+### 📈 Autoscaling (0.16.10)
+```bash
+ninedeploy autoscale show web [--json]                        # Bounds, metric and target, containers serving, last value, desired count, last change
+ninedeploy autoscale set web --max 4 --target 70              # Turn it on (cpu by default); --metric memory|rps, --min, --up-seconds, --down-seconds
+ninedeploy autoscale set web --metric rps --target 200        # Options not given keep their value; rps needs traffic analytics
+ninedeploy autoscale off web                                  # The next deploy runs the fixed replicas again
+```
+Turning it on applies fully at the next deploy, which creates the spare containers.
+
 ---
 
 ## 📄 License

package/dist/commands/autoscale.d.ts

@@ -0,0 +1,38 @@
+import { type AutoscaleConfig, type AutoscaleConfigInput, type AutoscaleMetric } from '@ninedeploy/schemas';
+import type { NineDeployClient } from '../client.js';
+export interface AutoscaleSetOptions {
+    min?: string;
+    max?: string;
+    metric?: string;
+    target?: string;
+    upSeconds?: string;
+    downSeconds?: string;
+    json?: boolean;
+}
+/**
+ * The fields the user gave, as a partial autoscale configuration; null after
+ * printing why one is not valid. Ranges are left to the schema.
+ */
+export declare function autoscaleOptions(opts: AutoscaleSetOptions): Partial<AutoscaleConfigInput> | null;
+/**
+ * What `autoscale set` sends. A service that has a configuration keeps the
+ * values not given (the PATCH replaces the whole object). Without one, only
+ * the given values go and the server fills in the defaults; `--max` and
+ * `--target` have none, so they are named when missing.
+ */
+export declare function autoscaleBody(current: AutoscaleConfig | null | undefined, given: Partial<AutoscaleConfigInput>): {
+    body: AutoscaleConfigInput;
+} | {
+    missing: string[];
+};
+/** A metric value with its unit: `70%` for cpu and memory, `120 req/s` for rps. */
+export declare function fmtMetric(metric: AutoscaleMetric, v: number): string;
+/** `ninedeploy autoscale show <service> [--json]` */
+export declare function autoscaleShow(client: NineDeployClient, ref: string, opts?: {
+    json?: boolean;
+}): Promise<void>;
+/** `ninedeploy autoscale set <service> [...]` */
+export declare function autoscaleSet(client: NineDeployClient, ref: string, opts?: AutoscaleSetOptions): Promise<void>;
+/** `ninedeploy autoscale off <service>` */
+export declare function autoscaleOff(client: NineDeployClient, ref: string): Promise<void>;
+//# sourceMappingURL=autoscale.d.ts.map

package/dist/commands/autoscale.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"autoscale.d.ts","sourceRoot":"","sources":["../../src/commands/autoscale.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,eAAe,EACpB,KAAK,oBAAoB,EACzB,KAAK,eAAe,EAErB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAuBrD,MAAM,WAAW,mBAAmB;IAClC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAsBD;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,mBAAmB,GAAG,OAAO,CAAC,oBAAoB,CAAC,GAAG,IAAI,CAqBhG;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAC3B,OAAO,EAAE,eAAe,GAAG,IAAI,GAAG,SAAS,EAC3C,KAAK,EAAE,OAAO,CAAC,oBAAoB,CAAC,GACnC;IAAE,IAAI,EAAE,oBAAoB,CAAA;CAAE,GAAG;IAAE,OAAO,EAAE,MAAM,EAAE,CAAA;CAAE,CAKxD;AAOD,mFAAmF;AACnF,wBAAgB,SAAS,CAAC,MAAM,EAAE,eAAe,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAEpE;AA2BD,qDAAqD;AACrD,wBAAsB,aAAa,CAAC,MAAM,EAAE,gBAAgB,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,GAAE;IAAE,IAAI,CAAC,EAAE,OAAO,CAAA;CAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAgBvH;AAED,iDAAiD;AACjD,wBAAsB,YAAY,CAAC,MAAM,EAAE,gBAAgB,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,GAAE,mBAAwB,GAAG,OAAO,CAAC,IAAI,CAAC,CA6BvH;AAED,2CAA2C;AAC3C,wBAAsB,YAAY,CAAC,MAAM,EAAE,gBAAgB,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CASvF"}

package/dist/commands/autoscale.js

@@ -0,0 +1,176 @@
+import { AUTOSCALE_METRICS, autoscaleConfig, } from '@ninedeploy/schemas';
+import { c, error, fmtTime, header, info, kv, spinner, success } from '../lib/format.js';
+import { fmtSeconds } from './canary.js';
+import { plain } from './sources.js';
+import { resolveServiceRef } from './uptime.js';
+/**
+ * 0.16.10 autoscaling:
+ *
+ *   ninedeploy autoscale show <service> [--json]
+ *   ninedeploy autoscale set <service> [--min N] [--max N] [--metric cpu|memory|rps] [--target X]
+ *                                      [--up-seconds N] [--down-seconds N] [--json]
+ *   ninedeploy autoscale off <service>
+ *
+ * `<service>` is an id, a slug or a name. Turning it on applies fully at the
+ * next deploy, which creates the spare containers.
+ */
+const message = (err) => plain(err instanceof Error ? err.message : String(err));
+/** Skip the spinner for `--json` so stdout stays parseable. */
+const load = (json, msg, fn) => (json ? fn() : spinner(msg, fn));
+/** Flag names for the schema fields, so a validation failure names what the user typed. */
+const FLAG = {
+    minReplicas: '--min',
+    maxReplicas: '--max',
+    metric: '--metric',
+    target: '--target',
+    scaleUpSeconds: '--up-seconds',
+    scaleDownSeconds: '--down-seconds',
+};
+const NUMBERS = [
+    ['min', 'minReplicas'],
+    ['max', 'maxReplicas'],
+    ['target', 'target'],
+    ['upSeconds', 'scaleUpSeconds'],
+    ['downSeconds', 'scaleDownSeconds'],
+];
+/**
+ * The fields the user gave, as a partial autoscale configuration; null after
+ * printing why one is not valid. Ranges are left to the schema.
+ */
+export function autoscaleOptions(opts) {
+    const out = {};
+    for (const [opt, field] of NUMBERS) {
+        const raw = opts[opt];
+        if (typeof raw !== 'string')
+            continue;
+        const n = Number(raw);
+        if (raw.trim() === '' || !Number.isFinite(n)) {
+            error(`${FLAG[field]} must be a number`);
+            return null;
+        }
+        out[field] = n;
+    }
+    if (opts.metric !== undefined) {
+        const metric = opts.metric.trim().toLowerCase();
+        if (!AUTOSCALE_METRICS.includes(metric)) {
+            error(`--metric must be one of ${AUTOSCALE_METRICS.join(', ')}`);
+            return null;
+        }
+        out.metric = metric;
+    }
+    return out;
+}
+/**
+ * What `autoscale set` sends. A service that has a configuration keeps the
+ * values not given (the PATCH replaces the whole object). Without one, only
+ * the given values go and the server fills in the defaults; `--max` and
+ * `--target` have none, so they are named when missing.
+ */
+export function autoscaleBody(current, given) {
+    if (current)
+        return { body: { ...current, ...given } };
+    const missing = ['maxReplicas', 'target'].filter((f) => given[f] === undefined).map((f) => FLAG[f]);
+    if (missing.length > 0)
+        return { missing };
+    return { body: given };
+}
+/** A zod failure as one line, each issue led by the flag it is about. */
+function validationMessage(err) {
+    return err.issues.map((i) => `${FLAG[String(i.path[0])] ?? 'autoscale'}: ${i.message}`).join('; ');
+}
+/** A metric value with its unit: `70%` for cpu and memory, `120 req/s` for rps. */
+export function fmtMetric(metric, v) {
+    return metric === 'rps' ? `${v} req/s` : `${v}%`;
+}
+const containers = (n) => `${n} container${n === 1 ? '' : 's'}`;
+function printConfig(cfg) {
+    if (!cfg) {
+        kv('Autoscaling', c.gray('off: the service runs its fixed replicas'));
+        return;
+    }
+    kv('Bounds', `${cfg.minReplicas}–${cfg.maxReplicas} containers`);
+    kv('Metric', `${cfg.metric}, target ${fmtMetric(cfg.metric, cfg.target)} per container`);
+    kv('Scale up after', fmtSeconds(cfg.scaleUpSeconds));
+    kv('Scale down after', fmtSeconds(cfg.scaleDownSeconds));
+}
+function printStatus(st) {
+    console.log();
+    kv('Serving', containers(st.replicas));
+    if (!st.enabled)
+        return;
+    const metric = st.metric ?? 'cpu';
+    kv('Last value', st.value === null || st.value === undefined ? c.gray('not read yet') : `${fmtMetric(metric, st.value)} per container`);
+    kv('Desired', st.desired === null || st.desired === undefined ? null : containers(st.desired));
+    if (st.holding)
+        info(`Not scaling now: ${plain(st.holding)}.`);
+    const ev = st.lastEvent;
+    kv('Last change', ev ? `${ev.from} → ${ev.to} containers, ${plain(ev.reason)}, ${fmtTime(ev.at)}` : c.gray('none yet'));
+}
+/** `ninedeploy autoscale show <service> [--json]` */
+export async function autoscaleShow(client, ref, opts = {}) {
+    try {
+        const id = await resolveServiceRef(client, ref);
+        if (id === null)
+            return;
+        const [svc, status] = await load(opts.json, 'Loading autoscaling', () => Promise.all([client.services.get(id), client.services.autoscale(id)]));
+        if (opts.json) {
+            console.log(JSON.stringify({ config: svc.autoscale ?? null, status }, null, 2));
+            return;
+        }
+        header(`Autoscaling: ${plain(svc.name)}`);
+        printConfig(svc.autoscale);
+        printStatus(status);
+        console.log();
+    }
+    catch (err) {
+        error(message(err));
+    }
+}
+/** `ninedeploy autoscale set <service> [...]` */
+export async function autoscaleSet(client, ref, opts = {}) {
+    const given = autoscaleOptions(opts);
+    if (given === null)
+        return;
+    try {
+        const id = await resolveServiceRef(client, ref);
+        if (id === null)
+            return;
+        const svc = await client.services.get(id);
+        const built = autoscaleBody(svc.autoscale, given);
+        if ('missing' in built) {
+            error(`Autoscaling is off for this service: give ${built.missing.join(' and ')} to turn it on.`);
+            return;
+        }
+        const parsed = autoscaleConfig.safeParse(built.body);
+        if (!parsed.success) {
+            error(validationMessage(parsed.error));
+            return;
+        }
+        const body = built.body;
+        const updated = await load(opts.json, 'Saving the autoscaling configuration', () => client.services.update(id, { autoscale: body }));
+        if (opts.json) {
+            console.log(JSON.stringify(updated.autoscale ?? null, null, 2));
+            return;
+        }
+        success(`Autoscaling on for ${plain(updated.name)}.`);
+        printConfig(updated.autoscale);
+        info('It applies fully at the next deploy, which creates the spare containers.');
+    }
+    catch (err) {
+        error(message(err));
+    }
+}
+/** `ninedeploy autoscale off <service>` */
+export async function autoscaleOff(client, ref) {
+    try {
+        const id = await resolveServiceRef(client, ref);
+        if (id === null)
+            return;
+        const updated = await spinner('Turning autoscaling off', () => client.services.update(id, { autoscale: null }));
+        success(`Autoscaling off for ${plain(updated.name)}. The containers serving now keep running until the next deploy, which runs the fixed replicas again.`);
+    }
+    catch (err) {
+        error(message(err));
+    }
+}
+//# sourceMappingURL=autoscale.js.map

package/dist/commands/autoscale.js.map

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

package/dist/commands/canary.d.ts

@@ -0,0 +1,37 @@
+import { type CanaryConfig, type CanaryConfigInput } from '@ninedeploy/schemas';
+import type { NineDeployClient } from '../client.js';
+export interface CanarySetOptions {
+    steps?: string;
+    stepSeconds?: string;
+    maxErrorRate?: string;
+    maxP95?: string;
+    minRequests?: string;
+    json?: boolean;
+}
+/**
+ * The fields the user gave, as a partial canary configuration; null after
+ * printing why one is not valid. Ranges are left to the schema.
+ */
+export declare function canaryOptions(opts: CanarySetOptions): Partial<CanaryConfigInput> | null;
+/**
+ * What `canary set` sends. A service that has a configuration keeps the
+ * values not given (the PATCH replaces the whole object). Without one, only
+ * the given values go, and the server fills in the rest; `steps` has no
+ * server default, so the documented default (10, 50) is sent when not given.
+ */
+export declare function canaryBody(current: CanaryConfig | null | undefined, given: Partial<CanaryConfigInput>): CanaryConfigInput;
+/** Seconds as `1m 20s`. */
+export declare function fmtSeconds(total: number): string;
+/** `ninedeploy canary show <service> [--json]` */
+export declare function canaryShow(client: NineDeployClient, ref: string, opts?: {
+    json?: boolean;
+}): Promise<void>;
+/** `ninedeploy canary set <service> [...]` */
+export declare function canarySet(client: NineDeployClient, ref: string, opts?: CanarySetOptions): Promise<void>;
+/** `ninedeploy canary off <service>` */
+export declare function canaryOff(client: NineDeployClient, ref: string): Promise<void>;
+/** `ninedeploy canary promote <service> [--deployment <id>]` */
+export declare function canaryPromote(client: NineDeployClient, ref: string, opts?: {
+    deployment?: string;
+}): Promise<void>;
+//# sourceMappingURL=canary.d.ts.map

package/dist/commands/canary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"canary.d.ts","sourceRoot":"","sources":["../../src/commands/canary.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,YAAY,EACjB,KAAK,iBAAiB,EAGvB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAwBrD,MAAM,WAAW,gBAAgB;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAqBD;;;GAGG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,gBAAgB,GAAG,OAAO,CAAC,iBAAiB,CAAC,GAAG,IAAI,CAgCvF;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,YAAY,GAAG,IAAI,GAAG,SAAS,EAAE,KAAK,EAAE,OAAO,CAAC,iBAAiB,CAAC,GAAG,iBAAiB,CAGzH;AAOD,2BAA2B;AAC3B,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAIhD;AAwCD,kDAAkD;AAClD,wBAAsB,UAAU,CAAC,MAAM,EAAE,gBAAgB,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,GAAE;IAAE,IAAI,CAAC,EAAE,OAAO,CAAA;CAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAgBpH;AAED,8CAA8C;AAC9C,wBAAsB,SAAS,CAAC,MAAM,EAAE,gBAAgB,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,GAAE,gBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC,CAuBjH;AAED,wCAAwC;AACxC,wBAAsB,SAAS,CAAC,MAAM,EAAE,gBAAgB,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CASpF;AAED,gEAAgE;AAChE,wBAAsB,aAAa,CAAC,MAAM,EAAE,gBAAgB,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,GAAE;IAAE,UAAU,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CA2B5H"}

package/dist/commands/canary.js

@@ -0,0 +1,230 @@
+import { CANARY_DEFAULT_STEPS, canaryConfig, } from '@ninedeploy/schemas';
+import { c, error, header, info, kv, spinner, success } from '../lib/format.js';
+import { plain } from './sources.js';
+import { resolveServiceRef } from './uptime.js';
+/**
+ * 0.16.9 canary releases:
+ *
+ *   ninedeploy canary show <service> [--json]
+ *   ninedeploy canary set <service> [--steps 10,50] [--step-seconds 120] [--max-error-rate 5]
+ *                                   [--max-p95 <ms>|off] [--min-requests 20] [--json]
+ *   ninedeploy canary off <service>
+ *   ninedeploy canary promote <service> [--deployment <id>]
+ *
+ * `<service>` is an id, a slug or a name. Stopping a running canary is
+ * `ninedeploy deploys cancel <serviceId> <deployId>`: all traffic goes back
+ * to the previous release.
+ */
+const message = (err) => plain(err instanceof Error ? err.message : String(err));
+/** Skip the spinner for `--json` so stdout stays parseable. */
+const load = (json, msg, fn) => (json ? fn() : spinner(msg, fn));
+/** Flag names for the schema fields, so a validation failure names what the user typed. */
+const FLAG = {
+    steps: '--steps',
+    stepSeconds: '--step-seconds',
+    maxErrorRate: '--max-error-rate',
+    maxP95Ms: '--max-p95',
+    minRequests: '--min-requests',
+};
+/** A number option; null after printing why not. */
+function numberOption(raw, flag) {
+    const n = Number(raw);
+    if (raw.trim() === '' || !Number.isFinite(n)) {
+        error(`${flag} must be a number`);
+        return null;
+    }
+    return n;
+}
+/**
+ * The fields the user gave, as a partial canary configuration; null after
+ * printing why one is not valid. Ranges are left to the schema.
+ */
+export function canaryOptions(opts) {
+    const out = {};
+    if (opts.steps !== undefined) {
+        const parts = opts.steps.split(',').map((s) => s.trim());
+        const steps = parts.map(Number);
+        if (parts.some((p) => p === '') || steps.some((n) => !Number.isFinite(n))) {
+            error('--steps must be percentages separated by commas, for example 10,50');
+            return null;
+        }
+        out.steps = steps;
+    }
+    const numbers = [
+        ['stepSeconds', 'stepSeconds'],
+        ['maxErrorRate', 'maxErrorRate'],
+        ['minRequests', 'minRequests'],
+    ];
+    for (const [opt, field] of numbers) {
+        const raw = opts[opt];
+        if (typeof raw !== 'string')
+            continue;
+        const n = numberOption(raw, FLAG[field]);
+        if (n === null)
+            return null;
+        out[field] = n;
+    }
+    if (opts.maxP95 !== undefined) {
+        if (opts.maxP95.trim().toLowerCase() === 'off')
+            out.maxP95Ms = null;
+        else {
+            const n = numberOption(opts.maxP95, '--max-p95');
+            if (n === null)
+                return null;
+            out.maxP95Ms = n;
+        }
+    }
+    return out;
+}
+/**
+ * What `canary set` sends. A service that has a configuration keeps the
+ * values not given (the PATCH replaces the whole object). Without one, only
+ * the given values go, and the server fills in the rest; `steps` has no
+ * server default, so the documented default (10, 50) is sent when not given.
+ */
+export function canaryBody(current, given) {
+    if (current)
+        return { ...current, ...given };
+    return { ...given, steps: given.steps ?? [...CANARY_DEFAULT_STEPS] };
+}
+/** A zod failure as one line, each issue led by the flag it is about. */
+function validationMessage(err) {
+    return err.issues.map((i) => `${FLAG[String(i.path[0])] ?? 'canary'}: ${i.message}`).join('; ');
+}
+/** Seconds as `1m 20s`. */
+export function fmtSeconds(total) {
+    const s = Math.max(0, Math.round(total));
+    const m = Math.floor(s / 60);
+    return m > 0 ? `${m}m ${s % 60}s` : `${s}s`;
+}
+function printConfig(cfg) {
+    if (!cfg) {
+        kv('Canary', c.gray('off: a deploy switches all traffic at once'));
+        return;
+    }
+    kv('Steps', cfg.steps.map((s) => `${s}%`).join(', '));
+    kv('Step length', fmtSeconds(cfg.stepSeconds));
+    kv('Max 5xx rate', `${cfg.maxErrorRate}%`);
+    kv('Max p95', cfg.maxP95Ms === null ? c.gray('not judged') : `${cfg.maxP95Ms} ms`);
+    kv('Min requests', cfg.minRequests);
+}
+function stats(s) {
+    if (!s)
+        return c.gray('—');
+    const rate = s.errorRate === null ? '—' : `${s.errorRate}%`;
+    const p95 = s.p95Ms === null ? '—' : `${s.p95Ms} ms`;
+    return `${s.requests} requests, 5xx ${rate}, p95 ${p95}`;
+}
+function printStatus(st, now) {
+    console.log();
+    if (!st.active) {
+        info('No canary is running.');
+        return;
+    }
+    console.log(`  ${c.bold('Running canary')}`);
+    kv('Deployment', `#${st.deploymentId}`);
+    kv('Step', `${st.step}/${st.steps}`);
+    kv('Traffic', `${st.weight}% to the new release`);
+    if (st.stepEndsAt)
+        kv('Step ends in', fmtSeconds((Date.parse(st.stepEndsAt) - now) / 1000));
+    kv('New release', stats(st.canary));
+    kv('Previous', stats(st.stable));
+    if (st.measured === false) {
+        info('Traffic analytics is off: steps are judged on the healthcheck only.');
+    }
+    if (st.promoting)
+        info('Promote requested: all traffic is switching to the new release.');
+}
+/** `ninedeploy canary show <service> [--json]` */
+export async function canaryShow(client, ref, opts = {}) {
+    try {
+        const id = await resolveServiceRef(client, ref);
+        if (id === null)
+            return;
+        const [svc, status] = await load(opts.json, 'Loading the canary', () => Promise.all([client.services.get(id), client.deploys.canary(id)]));
+        if (opts.json) {
+            console.log(JSON.stringify({ config: svc.canary ?? null, status }, null, 2));
+            return;
+        }
+        header(`Canary releases: ${plain(svc.name)}`);
+        printConfig(svc.canary);
+        printStatus(status, Date.now());
+        console.log();
+    }
+    catch (err) {
+        error(message(err));
+    }
+}
+/** `ninedeploy canary set <service> [...]` */
+export async function canarySet(client, ref, opts = {}) {
+    const given = canaryOptions(opts);
+    if (given === null)
+        return;
+    try {
+        const id = await resolveServiceRef(client, ref);
+        if (id === null)
+            return;
+        const svc = await client.services.get(id);
+        const body = canaryBody(svc.canary, given);
+        const parsed = canaryConfig.safeParse(body);
+        if (!parsed.success) {
+            error(validationMessage(parsed.error));
+            return;
+        }
+        const updated = await load(opts.json, 'Saving the canary configuration', () => client.services.update(id, { canary: body }));
+        if (opts.json) {
+            console.log(JSON.stringify(updated.canary ?? null, null, 2));
+            return;
+        }
+        success(`Canary releases on for ${plain(updated.name)}. The next deploy uses them.`);
+        printConfig(updated.canary);
+    }
+    catch (err) {
+        error(message(err));
+    }
+}
+/** `ninedeploy canary off <service>` */
+export async function canaryOff(client, ref) {
+    try {
+        const id = await resolveServiceRef(client, ref);
+        if (id === null)
+            return;
+        const updated = await spinner('Turning canary releases off', () => client.services.update(id, { canary: null }));
+        success(`Canary releases off for ${plain(updated.name)}. A deploy switches all traffic at once.`);
+    }
+    catch (err) {
+        error(message(err));
+    }
+}
+/** `ninedeploy canary promote <service> [--deployment <id>]` */
+export async function canaryPromote(client, ref, opts = {}) {
+    let depId;
+    if (opts.deployment !== undefined) {
+        const n = Number(opts.deployment);
+        if (!Number.isInteger(n) || n <= 0) {
+            error('--deployment must be a positive integer');
+            return;
+        }
+        depId = n;
+    }
+    try {
+        const id = await resolveServiceRef(client, ref);
+        if (id === null)
+            return;
+        if (depId === undefined) {
+            const status = await client.deploys.canary(id);
+            if (!status.active || status.deploymentId === undefined) {
+                error('No canary is running on this service.');
+                return;
+            }
+            depId = status.deploymentId;
+        }
+        const target = depId;
+        await spinner('Promoting the canary', () => client.deploys.promoteCanary(id, target));
+        success(`Deployment #${target}: all traffic is switching to the new release.`);
+    }
+    catch (err) {
+        error(message(err));
+    }
+}
+//# sourceMappingURL=canary.js.map

package/dist/commands/canary.js.map

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

package/dist/index.js

@@ -48,6 +48,8 @@ import { panelBackupDecryptAction, panelBackupListAction, panelBackupNowAction,
 import { serversList, serversRoles, servicesPlacement, servicesSwarm, servicesTransfers, sourcesAllowOnNodes, sourcesHostKeys, sourcesPinHostKeys, sourcesResetHostKeys, swarmInit, swarmJoin, swarmLeave, swarmSetEnabled, swarmStatus, volumesCreate, } from './commands/multiNode.js';
 // ── end 0.16 T8 ──
 import { monitorsAdd, monitorsCheck, monitorsList, monitorsRemove, monitorsSetEnabled, monitorsShow, statusPagesAdd, statusPagesList, statusPagesNotice, statusPagesRemove, statusPagesSetPublished, } from './commands/uptime.js';
+import { canaryOff, canaryPromote, canarySet, canaryShow } from './commands/canary.js';
+import { autoscaleOff, autoscaleSet, autoscaleShow } from './commands/autoscale.js';
 const program = new Command();
 program
     .name('ninedeploy')
@@ -988,6 +990,47 @@ statusPagesCmd.command('rm <id>')
     .option('-y, --yes', 'Skip the confirmation prompt')
     .action((id, opts) => statusPagesRemove(getClient(), id, opts));
 /* v8 ignore stop */
+// ── 0.16.9: canary releases ──────────────────────────────────────────────
+const canaryCmd = program.command('canary').description('Canary releases: shift traffic to a new release in steps');
+/* v8 ignore start -- exercised by test/canary.test.ts. */
+canaryCmd.command('show <service>')
+    .description('The canary configuration and the canary running now')
+    .option('--json', 'Print raw JSON')
+    .action((service, opts) => canaryShow(getClient(), service, opts));
+canaryCmd.command('set <service>')
+    .description('Turn canary releases on or change them (docker services); options not given keep their value')
+    .option('--steps <list>', 'Percent of requests per step, rising, 1-99, up to 5 (default 10,50)')
+    .option('--step-seconds <n>', 'Seconds per step (30-3600, default 120)')
+    .option('--max-error-rate <percent>', 'Highest share of 5xx responses the new release may have (default 5)')
+    .option('--max-p95 <ms>', 'Highest p95 response time in ms, or off (default off)')
+    .option('--min-requests <n>', 'Fewer requests in a step are not judged (default 20)')
+    .option('--json', 'Print the stored configuration as JSON')
+    .action((service, opts) => canarySet(getClient(), service, opts));
+canaryCmd.command('off <service>').description('Turn canary releases off').action((service) => canaryOff(getClient(), service));
+canaryCmd.command('promote <service>')
+    .description('Skip the remaining steps and send all traffic to the new release now')
+    .option('--deployment <id>', 'The deployment to promote (default: the one running)')
+    .action((service, opts) => canaryPromote(getClient(), service, opts));
+/* v8 ignore stop */
+// ── 0.16.10: autoscaling ─────────────────────────────────────────────────
+const autoscaleCmd = program.command('autoscale').description('Autoscaling: run between a minimum and a maximum number of containers, set by load');
+/* v8 ignore start -- exercised by test/autoscale.test.ts. */
+autoscaleCmd.command('show <service>')
+    .description('The autoscaling configuration and what it is doing now')
+    .option('--json', 'Print raw JSON')
+    .action((service, opts) => autoscaleShow(getClient(), service, opts));
+autoscaleCmd.command('set <service>')
+    .description('Turn autoscaling on or change it (docker services); options not given keep their value')
+    .option('--min <n>', 'Containers it never goes below (1-10, default 1)')
+    .option('--max <n>', 'Containers it never goes above (2-10, above --min; required to turn it on)')
+    .option('--metric <metric>', 'cpu, memory or rps (default cpu)')
+    .option('--target <value>', 'Value per container to keep near: percent for cpu/memory, requests per second for rps (required to turn it on)')
+    .option('--up-seconds <n>', 'How long the need must last before adding containers (30-3600, default 60)')
+    .option('--down-seconds <n>', 'How long the need must last before removing containers (60-3600, default 300)')
+    .option('--json', 'Print the stored configuration as JSON')
+    .action((service, opts) => autoscaleSet(getClient(), service, opts));
+autoscaleCmd.command('off <service>').description('Turn autoscaling off').action((service) => autoscaleOff(getClient(), service));
+/* v8 ignore stop */
 deploys.command('watch <serviceId> <deployId>').description('Stream a deployment\'s build logs live').action((svcId, depId) => deploysWatch(svcId, depId));
 // ── Diagnostics ───────────────────────────────────────────────────────────
 program