Function runSingleCommand

src/spec-common/injectHeadless.ts:502–538

(postCommand: string | string[], name?: string)

		}, LogLevel.Info);
		const remoteCwd = containerProperties.remoteWorkspaceFolder || containerProperties.homeFolder;
		async function runSingleCommand(postCommand: string | string[], name?: string) {
			const progressDetails = typeof postCommand === 'string' ? postCommand : postCommand.join(' ');
			infoOutput.event({
				type: 'progress',
				name: progressName,
				status: 'running',
				stepDetail: progressDetails
			});
			// If we have a command name then the command is running in parallel and 
			// we need to hold output until the command is done so that the output
			// doesn't get interleaved with the output of other commands.
			const printMode = name ? 'off' : 'continuous';
			const env = { ...(await remoteEnv), ...(await secrets) };
			try {
				const { cmdOutput } = await runRemoteCommand({ ...lifecycleHook, output: infoOutput }, containerProperties, typeof postCommand === 'string' ? ['/bin/sh', '-c', postCommand] : postCommand, remoteCwd, { remoteEnv: env, pty: true, print: printMode });

				// 'name' is set when parallel execution syntax is used.
				if (name) {
					infoOutput.raw(`\x1b[1mRunning ${name} of ${lifecycleHookName} from ${userCommandOrigin}...\x1b[0m\r\n${cmdOutput}\r\n`);
				}
			} catch (err) {
				if (printMode === 'off' && err?.cmdOutput) {
					infoOutput.raw(`\r\n\x1b[1m${err.cmdOutput}\x1b[0m\r\n\r\n`);
				}
				if (err && (err.code === 130 || err.signal === 2)) { // SIGINT seen on darwin as code === 130, would also make sense as signal === 2.
					infoOutput.raw(`\r\n\x1b[1m${name ? `${name} of ${lifecycleHookName}` : lifecycleHookName} from ${userCommandOrigin} interrupted.\x1b[0m\r\n\r\n`);
				} else {
					if (err?.code) {
						infoOutput.write(toErrorText(`${name ? `${name} of ${lifecycleHookName}` : lifecycleHookName} from ${userCommandOrigin} failed with exit code ${err.code}. Skipping any further user-provided commands.`));
					}
					throw new ContainerError({
						description: `${name ? `${name} of ${lifecycleHookName}` : lifecycleHookName} from ${userCommandOrigin} failed.`,
						originalError: err
					});
				}
			}
		}

		infoOutput.raw(`\x1b[1mRunning the ${lifecycleHookName} from ${userCommandOrigin}...\x1b[0m\r\n\r\n`);