balena-cli 17.2.4 → 17.3.0

package/CHANGELOG.md

@@ -4,6 +4,10 @@ All notable changes to this project will be documented in this file
 automatically by Versionist. DO NOT EDIT THIS FILE MANUALLY!
 This project adheres to [Semantic Versioning](http://semver.org/).
 
+## 17.3.0 - 2023-11-06
+
+* Add device start-service and stop-service commands [Morgan Larsson]
+
 ## 17.2.4 - 2023-11-06
 
 * Dedupe shrinkwrap [myarmolinsky]

package/build/commands/device/start-service.d.ts

@@ -0,0 +1,17 @@
+import Command from '../../command';
+import type { BalenaSDK } from 'balena-sdk';
+export default class DeviceStartServiceCmd extends Command {
+    static description: string;
+    static examples: string[];
+    static args: {
+        uuid: import("@oclif/core/lib/interfaces/parser").Arg<string, Record<string, unknown>>;
+        service: import("@oclif/core/lib/interfaces/parser").Arg<string, Record<string, unknown>>;
+    };
+    static usage: string;
+    static flags: {
+        help: import("@oclif/core/lib/interfaces").BooleanFlag<void>;
+    };
+    static authenticated: boolean;
+    run(): Promise<void>;
+    startServices(balena: BalenaSDK, deviceUuid: string, serviceNames: string[]): Promise<void>;
+}

package/build/commands/device/start-service.js

@@ -0,0 +1,85 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@oclif/core");
+const command_1 = require("../../command");
+const cf = require("../../utils/common-flags");
+const lazy_1 = require("../../utils/lazy");
+class DeviceStartServiceCmd extends command_1.default {
+    async run() {
+        const { args: params } = await this.parse(DeviceStartServiceCmd);
+        const balena = (0, lazy_1.getBalenaSdk)();
+        const ux = (0, lazy_1.getCliUx)();
+        const deviceUuids = params.uuid.split(',');
+        const serviceNames = params.service.split(',');
+        for (const uuid of deviceUuids) {
+            ux.action.start(`Starting services on device ${uuid}`);
+            await this.startServices(balena, uuid, serviceNames);
+            ux.action.stop();
+        }
+    }
+    async startServices(balena, deviceUuid, serviceNames) {
+        const { ExpectedError } = await Promise.resolve().then(() => require('../../errors'));
+        const { getExpandedProp } = await Promise.resolve().then(() => require('../../utils/pine'));
+        const device = await balena.models.device.getWithServiceDetails(deviceUuid, {
+            $expand: {
+                is_running__release: { $select: 'commit' },
+            },
+        });
+        const activeReleaseCommit = getExpandedProp(device.is_running__release, 'commit');
+        serviceNames.forEach((service) => {
+            if (!device.current_services[service]) {
+                throw new ExpectedError(`Service ${service} not found on device ${deviceUuid}.`);
+            }
+        });
+        const startPromises = [];
+        for (const serviceName of serviceNames) {
+            const service = device.current_services[serviceName];
+            const serviceContainer = service.find((s) => {
+                return s.commit === activeReleaseCommit;
+            });
+            if (serviceContainer) {
+                startPromises.push(balena.models.device.startService(deviceUuid, serviceContainer.image_id));
+            }
+        }
+        try {
+            await Promise.all(startPromises);
+        }
+        catch (e) {
+            if (e.message.toLowerCase().includes('no online device')) {
+                throw new ExpectedError(`Device ${deviceUuid} is not online.`);
+            }
+            else {
+                throw e;
+            }
+        }
+    }
+}
+DeviceStartServiceCmd.description = (0, lazy_1.stripIndent) `
+		Start containers on a device.
+
+		Start containers on a device.
+
+		Multiple devices and services may be specified with a comma-separated list
+		of values (no spaces).
+		`;
+DeviceStartServiceCmd.examples = [
+    '$ balena device start-service 23c73a1 myService',
+    '$ balena device start-service 23c73a1 myService1,myService2',
+];
+DeviceStartServiceCmd.args = {
+    uuid: core_1.Args.string({
+        description: 'comma-separated list (no blank spaces) of device UUIDs',
+        required: true,
+    }),
+    service: core_1.Args.string({
+        description: 'comma-separated list (no blank spaces) of service names',
+        required: true,
+    }),
+};
+DeviceStartServiceCmd.usage = 'device start-service <uuid>';
+DeviceStartServiceCmd.flags = {
+    help: cf.help,
+};
+DeviceStartServiceCmd.authenticated = true;
+exports.default = DeviceStartServiceCmd;
+//# sourceMappingURL=start-service.js.map

package/build/commands/device/start-service.js.map

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

package/build/commands/device/stop-service.d.ts

@@ -0,0 +1,17 @@
+import Command from '../../command';
+import type { BalenaSDK } from 'balena-sdk';
+export default class DeviceStopServiceCmd extends Command {
+    static description: string;
+    static examples: string[];
+    static args: {
+        uuid: import("@oclif/core/lib/interfaces/parser").Arg<string, Record<string, unknown>>;
+        service: import("@oclif/core/lib/interfaces/parser").Arg<string, Record<string, unknown>>;
+    };
+    static usage: string;
+    static flags: {
+        help: import("@oclif/core/lib/interfaces").BooleanFlag<void>;
+    };
+    static authenticated: boolean;
+    run(): Promise<void>;
+    stopServices(balena: BalenaSDK, deviceUuid: string, serviceNames: string[]): Promise<void>;
+}

package/build/commands/device/stop-service.js

@@ -0,0 +1,85 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@oclif/core");
+const command_1 = require("../../command");
+const cf = require("../../utils/common-flags");
+const lazy_1 = require("../../utils/lazy");
+class DeviceStopServiceCmd extends command_1.default {
+    async run() {
+        const { args: params } = await this.parse(DeviceStopServiceCmd);
+        const balena = (0, lazy_1.getBalenaSdk)();
+        const ux = (0, lazy_1.getCliUx)();
+        const deviceUuids = params.uuid.split(',');
+        const serviceNames = params.service.split(',');
+        for (const uuid of deviceUuids) {
+            ux.action.start(`Stopping services on device ${uuid}`);
+            await this.stopServices(balena, uuid, serviceNames);
+            ux.action.stop();
+        }
+    }
+    async stopServices(balena, deviceUuid, serviceNames) {
+        const { ExpectedError } = await Promise.resolve().then(() => require('../../errors'));
+        const { getExpandedProp } = await Promise.resolve().then(() => require('../../utils/pine'));
+        const device = await balena.models.device.getWithServiceDetails(deviceUuid, {
+            $expand: {
+                is_running__release: { $select: 'commit' },
+            },
+        });
+        const activeReleaseCommit = getExpandedProp(device.is_running__release, 'commit');
+        serviceNames.forEach((service) => {
+            if (!device.current_services[service]) {
+                throw new ExpectedError(`Service ${service} not found on device ${deviceUuid}.`);
+            }
+        });
+        const stopPromises = [];
+        for (const serviceName of serviceNames) {
+            const service = device.current_services[serviceName];
+            const serviceContainer = service.find((s) => {
+                return s.commit === activeReleaseCommit;
+            });
+            if (serviceContainer) {
+                stopPromises.push(balena.models.device.stopService(deviceUuid, serviceContainer.image_id));
+            }
+        }
+        try {
+            await Promise.all(stopPromises);
+        }
+        catch (e) {
+            if (e.message.toLowerCase().includes('no online device')) {
+                throw new ExpectedError(`Device ${deviceUuid} is not online.`);
+            }
+            else {
+                throw e;
+            }
+        }
+    }
+}
+DeviceStopServiceCmd.description = (0, lazy_1.stripIndent) `
+		Stop containers on a device.
+
+		Stop containers on a device.
+
+		Multiple devices and services may be specified with a comma-separated list
+		of values (no spaces).
+		`;
+DeviceStopServiceCmd.examples = [
+    '$ balena device stop-service 23c73a1 myService',
+    '$ balena device stop-service 23c73a1 myService1,myService2',
+];
+DeviceStopServiceCmd.args = {
+    uuid: core_1.Args.string({
+        description: 'comma-separated list (no blank spaces) of device UUIDs',
+        required: true,
+    }),
+    service: core_1.Args.string({
+        description: 'comma-separated list (no blank spaces) of service names',
+        required: true,
+    }),
+};
+DeviceStopServiceCmd.usage = 'device stop-service <uuid>';
+DeviceStopServiceCmd.flags = {
+    help: cf.help,
+};
+DeviceStopServiceCmd.authenticated = true;
+exports.default = DeviceStopServiceCmd;
+//# sourceMappingURL=stop-service.js.map

package/build/commands/device/stop-service.js.map

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

package/lib/commands/device/start-service.ts

@@ -0,0 +1,139 @@
+/**
+ * @license
+ * Copyright 2016-2020 Balena Ltd.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *    http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+import { Args } from '@oclif/core';
+import Command from '../../command';
+import * as cf from '../../utils/common-flags';
+import { getBalenaSdk, getCliUx, stripIndent } from '../../utils/lazy';
+import type { BalenaSDK } from 'balena-sdk';
+
+export default class DeviceStartServiceCmd extends Command {
+	public static description = stripIndent`
+		Start containers on a device.
+
+		Start containers on a device.
+
+		Multiple devices and services may be specified with a comma-separated list
+		of values (no spaces).
+		`;
+	public static examples = [
+		'$ balena device start-service 23c73a1 myService',
+		'$ balena device start-service 23c73a1 myService1,myService2',
+	];
+
+	public static args = {
+		uuid: Args.string({
+			description: 'comma-separated list (no blank spaces) of device UUIDs',
+			required: true,
+		}),
+		service: Args.string({
+			description: 'comma-separated list (no blank spaces) of service names',
+			required: true,
+		}),
+	};
+
+	public static usage = 'device start-service <uuid>';
+
+	public static flags = {
+		help: cf.help,
+	};
+
+	public static authenticated = true;
+
+	public async run() {
+		const { args: params } = await this.parse(DeviceStartServiceCmd);
+
+		const balena = getBalenaSdk();
+		const ux = getCliUx();
+
+		const deviceUuids = params.uuid.split(',');
+		const serviceNames = params.service.split(',');
+
+		// Iterate sequentially through deviceUuids.
+		// We may later want to add a batching feature,
+		// so that n devices are processed in parallel
+		for (const uuid of deviceUuids) {
+			ux.action.start(`Starting services on device ${uuid}`);
+			await this.startServices(balena, uuid, serviceNames);
+			ux.action.stop();
+		}
+	}
+
+	async startServices(
+		balena: BalenaSDK,
+		deviceUuid: string,
+		serviceNames: string[],
+	) {
+		const { ExpectedError } = await import('../../errors');
+		const { getExpandedProp } = await import('../../utils/pine');
+
+		// Get device
+		const device = await balena.models.device.getWithServiceDetails(
+			deviceUuid,
+			{
+				$expand: {
+					is_running__release: { $select: 'commit' },
+				},
+			},
+		);
+
+		const activeReleaseCommit = getExpandedProp(
+			device.is_running__release,
+			'commit',
+		);
+
+		// Check specified services exist on this device before startinganything
+		serviceNames.forEach((service) => {
+			if (!device.current_services[service]) {
+				throw new ExpectedError(
+					`Service ${service} not found on device ${deviceUuid}.`,
+				);
+			}
+		});
+
+		// Start services
+		const startPromises: Array<Promise<void>> = [];
+		for (const serviceName of serviceNames) {
+			const service = device.current_services[serviceName];
+			// Each service is an array of `CurrentServiceWithCommit`
+			// because when service is updating, it will actually hold 2 services
+			// Target commit matching `device.is_running__release`
+			const serviceContainer = service.find((s) => {
+				return s.commit === activeReleaseCommit;
+			});
+
+			if (serviceContainer) {
+				startPromises.push(
+					balena.models.device.startService(
+						deviceUuid,
+						serviceContainer.image_id,
+					),
+				);
+			}
+		}
+
+		try {
+			await Promise.all(startPromises);
+		} catch (e) {
+			if (e.message.toLowerCase().includes('no online device')) {
+				throw new ExpectedError(`Device ${deviceUuid} is not online.`);
+			} else {
+				throw e;
+			}
+		}
+	}
+}

package/lib/commands/device/stop-service.ts

@@ -0,0 +1,139 @@
+/**
+ * @license
+ * Copyright 2016-2020 Balena Ltd.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *    http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+import { Args } from '@oclif/core';
+import Command from '../../command';
+import * as cf from '../../utils/common-flags';
+import { getBalenaSdk, getCliUx, stripIndent } from '../../utils/lazy';
+import type { BalenaSDK } from 'balena-sdk';
+
+export default class DeviceStopServiceCmd extends Command {
+	public static description = stripIndent`
+		Stop containers on a device.
+
+		Stop containers on a device.
+
+		Multiple devices and services may be specified with a comma-separated list
+		of values (no spaces).
+		`;
+	public static examples = [
+		'$ balena device stop-service 23c73a1 myService',
+		'$ balena device stop-service 23c73a1 myService1,myService2',
+	];
+
+	public static args = {
+		uuid: Args.string({
+			description: 'comma-separated list (no blank spaces) of device UUIDs',
+			required: true,
+		}),
+		service: Args.string({
+			description: 'comma-separated list (no blank spaces) of service names',
+			required: true,
+		}),
+	};
+
+	public static usage = 'device stop-service <uuid>';
+
+	public static flags = {
+		help: cf.help,
+	};
+
+	public static authenticated = true;
+
+	public async run() {
+		const { args: params } = await this.parse(DeviceStopServiceCmd);
+
+		const balena = getBalenaSdk();
+		const ux = getCliUx();
+
+		const deviceUuids = params.uuid.split(',');
+		const serviceNames = params.service.split(',');
+
+		// Iterate sequentially through deviceUuids.
+		// We may later want to add a batching feature,
+		// so that n devices are processed in parallel
+		for (const uuid of deviceUuids) {
+			ux.action.start(`Stopping services on device ${uuid}`);
+			await this.stopServices(balena, uuid, serviceNames);
+			ux.action.stop();
+		}
+	}
+
+	async stopServices(
+		balena: BalenaSDK,
+		deviceUuid: string,
+		serviceNames: string[],
+	) {
+		const { ExpectedError } = await import('../../errors');
+		const { getExpandedProp } = await import('../../utils/pine');
+
+		// Get device
+		const device = await balena.models.device.getWithServiceDetails(
+			deviceUuid,
+			{
+				$expand: {
+					is_running__release: { $select: 'commit' },
+				},
+			},
+		);
+
+		const activeReleaseCommit = getExpandedProp(
+			device.is_running__release,
+			'commit',
+		);
+
+		// Check specified services exist on this device before stoppinganything
+		serviceNames.forEach((service) => {
+			if (!device.current_services[service]) {
+				throw new ExpectedError(
+					`Service ${service} not found on device ${deviceUuid}.`,
+				);
+			}
+		});
+
+		// Stop services
+		const stopPromises: Array<Promise<void>> = [];
+		for (const serviceName of serviceNames) {
+			const service = device.current_services[serviceName];
+			// Each service is an array of `CurrentServiceWithCommit`
+			// because when service is updating, it will actually hold 2 services
+			// Target commit matching `device.is_running__release`
+			const serviceContainer = service.find((s) => {
+				return s.commit === activeReleaseCommit;
+			});
+
+			if (serviceContainer) {
+				stopPromises.push(
+					balena.models.device.stopService(
+						deviceUuid,
+						serviceContainer.image_id,
+					),
+				);
+			}
+		}
+
+		try {
+			await Promise.all(stopPromises);
+		} catch (e) {
+			if (e.message.toLowerCase().includes('no online device')) {
+				throw new ExpectedError(`Device ${deviceUuid} is not online.`);
+			} else {
+				throw e;
+			}
+		}
+	}
+}

package/npm-shrinkwrap.json

@@ -1,12 +1,12 @@
 {
   "name": "balena-cli",
-  "version": "17.2.4",
+  "version": "17.3.0",
   "lockfileVersion": 2,
   "requires": true,
   "packages": {
     "": {
       "name": "balena-cli",
-      "version": "17.2.4",
+      "version": "17.3.0",
       "hasInstallScript": true,
       "license": "Apache-2.0",
       "dependencies": {

package/oclif.manifest.json

@@ -1,5 +1,5 @@
 {
-  "version": "17.2.4",
+  "version": "17.3.0",
   "commands": {
     "build": {
       "id": "build",
@@ -2815,6 +2815,78 @@
       },
       "authenticated": true
     },
+    "device:start-service": {
+      "id": "device:start-service",
+      "description": "Start containers on a device.\n\nStart containers on a device.\n\nMultiple devices and services may be specified with a comma-separated list\nof values (no spaces).",
+      "strict": true,
+      "usage": "device start-service <uuid>",
+      "pluginName": "balena-cli",
+      "pluginAlias": "balena-cli",
+      "pluginType": "core",
+      "aliases": [],
+      "examples": [
+        "$ balena device start-service 23c73a1 myService",
+        "$ balena device start-service 23c73a1 myService1,myService2"
+      ],
+      "flags": {
+        "help": {
+          "name": "help",
+          "type": "boolean",
+          "char": "h",
+          "description": "Show CLI help.",
+          "allowNo": false
+        }
+      },
+      "args": {
+        "uuid": {
+          "name": "uuid",
+          "description": "comma-separated list (no blank spaces) of device UUIDs",
+          "required": true
+        },
+        "service": {
+          "name": "service",
+          "description": "comma-separated list (no blank spaces) of service names",
+          "required": true
+        }
+      },
+      "authenticated": true
+    },
+    "device:stop-service": {
+      "id": "device:stop-service",
+      "description": "Stop containers on a device.\n\nStop containers on a device.\n\nMultiple devices and services may be specified with a comma-separated list\nof values (no spaces).",
+      "strict": true,
+      "usage": "device stop-service <uuid>",
+      "pluginName": "balena-cli",
+      "pluginAlias": "balena-cli",
+      "pluginType": "core",
+      "aliases": [],
+      "examples": [
+        "$ balena device stop-service 23c73a1 myService",
+        "$ balena device stop-service 23c73a1 myService1,myService2"
+      ],
+      "flags": {
+        "help": {
+          "name": "help",
+          "type": "boolean",
+          "char": "h",
+          "description": "Show CLI help.",
+          "allowNo": false
+        }
+      },
+      "args": {
+        "uuid": {
+          "name": "uuid",
+          "description": "comma-separated list (no blank spaces) of device UUIDs",
+          "required": true
+        },
+        "service": {
+          "name": "service",
+          "description": "comma-separated list (no blank spaces) of service names",
+          "required": true
+        }
+      },
+      "authenticated": true
+    },
     "device:track-fleet": {
       "id": "device:track-fleet",
       "description": "Make a device track the fleet's pinned release.\n\nMake a device track the fleet's pinned release.",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "balena-cli",
-  "version": "17.2.4",
+  "version": "17.3.0",
   "description": "The official balena Command Line Interface",
   "main": "./build/app.js",
   "homepage": "https://github.com/balena-io/balena-cli",
@@ -282,6 +282,6 @@
     "windosu": "^0.3.0"
   },
   "versionist": {
-    "publishedAt": "2023-11-06T17:12:45.031Z"
+    "publishedAt": "2023-11-06T19:14:55.820Z"
   }
 }