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.
41 lines
1.6 KiB
TypeScript
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.
|
|
}
|
|
}
|
|
}
|