pulumi/sdk/nodejs/runtime/stack.ts
joeduffy c5b7b6ef11 Bring back component outputs
This change brings back component outputs to the overall system again.
In doing so, it generally overhauls the way we do resource RPCs a bit:

* Instead of RegisterResource and CompleteResource, we call these
  BeginRegisterResource and EndRegisterResource, which begins to model
  these as effectively "asynchronous" resource requests.  This should also
  help with parallelism (https://github.com/pulumi/pulumi/issues/106).

* Flip the CLI/engine a little on its head.  Rather than it driving the
  planning and deployment process, we move more to a model where it
  simply observes it.  This is done by implementing an event handler
  interface with three events: OnResourceStepPre, OnResourceStepPost,
  and OnResourceComplete.  The first two are invoked immediately before
  and after any step operation, and the latter is invoked whenever a
  EndRegisterResource comes in.  The reason for the asymmetry here is
  that the checkpointing logic in the deployment engine is largely
  untouched (intentionally, as this is a sensitive part of the system),
  and so the "begin"/"end" nature doesn't flow through faithfully.

* Also make the engine more event-oriented in its terminology and the
  way it handles the incoming BeginRegisterResource and
  EndRegisterResource events from the language host.  This is the first
  step down a long road of incrementally refactoring the engine to work
  this way, a necessary prerequisite for parallelism.
2017-11-29 07:42:14 -08:00

41 lines
1.6 KiB
TypeScript

// Copyright 2016-2017, Pulumi Corporation. All rights reserved.
import * as log from "../log";
import { getProject, getStack } from "../metadata";
import { ComponentResource, ComputedValues, Resource } from "../resource";
import { getRootResource, setRootResource } from "./settings";
/**
* rootPulumiStackTypeName is the type name that should be used to construct the root component in the tree of Pulumi
* resources allocated by a deployment. This must be kept up to date with
* `github.com/pulumi/pulumi/pkg/resource/stack.RootPulumiStackTypeName`.
*/
export const rootPulumiStackTypeName = "pulumi:pulumi:Stack";
/**
* runInPulumiStack creates a new Pulumi stack resource and executes the callback inside of it. Any outputs
* returned by the callback will be stored as output properties on this resulting Stack object.
*/
export function runInPulumiStack(init: () => any): void {
const _ = new Stack(init);
}
class Stack extends ComponentResource {
constructor(init: () => ComputedValues) {
super(rootPulumiStackTypeName, `${getProject()}-${getStack()}`);
if (getRootResource()) {
throw new Error("Only one root Pulumi Stack may be active at once");
}
let outputs: ComputedValues | undefined;
try {
setRootResource(this); // install ourselves as the current root.
outputs = init(); // run the init code.
}
finally {
super.done(outputs); // save the outputs for this component to whatever the init returned.
setRootResource(undefined); // restore the original root resource.
}
}
}