// Copyright 2016-2017, Pulumi Corporation. All rights reserved. // This is the entrypoint for running a Node.js program with minimal scaffolding. import * as minimist from "minimist"; import * as path from "path"; import { RunError } from "../../errors"; import * as log from "../../log"; import * as runtime from "../../runtime"; const grpc = require("grpc"); const engrpc = require("../../proto/engine_grpc_pb.js"); const langproto = require("../../proto/languages_pb.js"); const langrpc = require("../../proto/languages_grpc_pb.js"); function usage(): void { console.error(`usage: RUN [program] <[arg]...>`); console.error(``); console.error(` where [flags] may include`); console.error(` --project=p set the project name to p`); console.error(` --stack=s set the stack name to s`); console.error(` --config.k=v... set runtime config key k to value v`); console.error(` --parallel=p run up to p resource operations in parallel (default is serial)`); console.error(` --dry-run true to simulate resource changes, but without making them`); console.error(` --pwd=pwd change the working directory before running the program`); console.error(` --monitor=addr the RPC address for a resource monitor to connect to`); console.error(` --engine=addr the RPC address for a resource engine to connect to`); console.error(``); console.error(` and [program] is a JavaScript program to run in Node.js, and [arg]... optional args to it.`); } export function main(args: string[]): void { // See usage above for the intended usage of this program, including flags and required args. const config: {[key: string]: string} = {}; const argv: minimist.ParsedArgs = minimist(args, { boolean: [ "dry-run" ], string: [ "project", "stack", "parallel", "pwd", "monitor", "engine" ], unknown: (arg: string) => { if (arg.indexOf("-") === 0) { console.error(`fatal: Unrecognized flag ${arg}`); usage(); process.exit(-1); return false; } return true; }, stopEarly: true, }); // If any config variables are present, parse and set them, so the subsequent accesses are fast. const envObject: {[key: string]: string} = runtime.getConfigEnv(); for (const key of Object.keys(envObject)) { runtime.setConfig(key, envObject[key]); } // If there is a --project=p, and/or a --stack=s, use them in the options. const project: string | undefined = argv["project"]; const stack: string | undefined = argv["stack"]; // If there is a --pwd directive, switch directories. const pwd: string | undefined = argv["pwd"]; if (pwd) { process.chdir(pwd); } // If resource parallelism was requested, turn it on. let parallel: number | undefined; if (argv["parallel"]) { parallel = parseInt(argv["parallel"], 10); if (isNaN(parallel)) { console.error(`error: --parallel flag must specify a number: ${argv["parallel"]} is not a number`); usage(); process.exit(-1); } } // If ther is a --dry-run directive, flip the switch. This controls whether we are planning vs. really doing it. const dryRun: boolean = !!(argv["dry-run"]); // If there is a monitor argument, connect to it. let monitor: Object | undefined; const monitorAddr: string | undefined = argv["monitor"]; if (monitorAddr) { monitor = new langrpc.ResourceMonitorClient(monitorAddr, grpc.credentials.createInsecure()); } // If there is an engine argument, connect to it too. let engine: Object | undefined; const engineAddr: string | undefined = argv["engine"]; if (engineAddr) { engine = new engrpc.EngineClient(engineAddr, grpc.credentials.createInsecure()); } // Now configure the runtime and get it ready to run the program. runtime.configure({ project: project, stack: stack, dryRun: dryRun, parallel: parallel, monitor: monitor, engine: engine, }); // Pluck out the program and arguments. if (argv._.length === 0) { console.error("fatal: Missing program to execute"); usage(); process.exit(-1); } let program: string = argv._[0]; if (program.indexOf(".") === 0) { // If there was a pwd change, make this relative to it. if (pwd) { program = path.join(pwd, program); } } else if (program.indexOf("/") !== 0) { // Neither absolute nor relative module, we refuse to execute it. console.error(`fatal: Program path '${program}' must be an absolute or relative path to the program`); usage(); process.exit(-1); } // Now fake out the process-wide argv, to make the program think it was run normally. const programArgs: string[] = argv._.slice(1); process.argv = [ process.argv[0], process.argv[1], ...programArgs ]; // Now go ahead and execute the code. This keeps the process alive until the message loop exits. log.debug(`Running program '${program}' in pwd '${process.cwd()}' w/ args: ${programArgs}`); try { require(program); } catch (err) { if (err instanceof RunError) { // For errors that are subtypes of RunError, we will print the message without hitting the unhandled error // logic, which will dump all sorts of verbose spew like the origin source and stack trace. log.error(err.message); } else { log.debug(`Running program '${program}' failed with an unhandled exception:`); log.debug(err); throw err; } } finally { runtime.disconnect(); } } main(process.argv.slice(2));