78 lines
3.3 KiB
C#
78 lines
3.3 KiB
C#
// Copyright 2016-2019, Pulumi Corporation
|
|
|
|
using System;
|
|
using System.Collections.Generic;
|
|
using System.Collections.Immutable;
|
|
using System.Threading.Tasks;
|
|
|
|
namespace Pulumi
|
|
{
|
|
/// <summary>
|
|
/// Stack is the root resource for a Pulumi stack. Before invoking the <c>init</c> callback, it
|
|
/// registers itself as the root resource with the Pulumi engine.
|
|
///
|
|
/// An instance of this will be automatically created when any <see
|
|
/// cref="Deployment.RunAsync(Action)"/> overload is called.
|
|
/// </summary>
|
|
internal sealed class Stack : ComponentResource
|
|
{
|
|
/// <summary>
|
|
/// Constant to represent the 'root stack' resource for a Pulumi application. The purpose
|
|
/// of this is solely to make it easy to write an <see cref="Alias"/> like so:
|
|
///
|
|
/// <c>aliases = { new Alias { Parent = Pulumi.Stack.Root } }</c>
|
|
///
|
|
/// This indicates that the prior name for a resource was created based on it being parented
|
|
/// directly by the stack itself and no other resources. Note: this is equivalent to:
|
|
///
|
|
/// <c>aliases = { new Alias { Parent = null } }</c>
|
|
///
|
|
/// However, the former form is preferable as it is more self-descriptive, while the latter
|
|
/// may look a bit confusing and may incorrectly look like something that could be removed
|
|
/// without changing semantics.
|
|
/// </summary>
|
|
public static readonly Resource? Root = null;
|
|
|
|
/// <summary>
|
|
/// <see cref="_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
|
|
/// <c>github.com/pulumi/pulumi/pkg/resource/stack.RootPulumiStackTypeName</c>.
|
|
/// </summary>
|
|
internal const string _rootPulumiStackTypeName = "pulumi:pulumi:Stack";
|
|
|
|
/// <summary>
|
|
/// The outputs of this stack, if the <c>init</c> callback exited normally.
|
|
/// </summary>
|
|
public readonly Output<IDictionary<string, object>> Outputs =
|
|
Output.Create<IDictionary<string, object>>(ImmutableDictionary<string, object>.Empty);
|
|
|
|
internal Stack(Func<Task<IDictionary<string, object>>> init)
|
|
: base(_rootPulumiStackTypeName, $"{Deployment.Instance.ProjectName}-{Deployment.Instance.StackName}")
|
|
{
|
|
Deployment.InternalInstance.Stack = this;
|
|
|
|
try
|
|
{
|
|
this.Outputs = Output.Create(RunInitAsync(init));
|
|
}
|
|
finally
|
|
{
|
|
this.RegisterOutputs(this.Outputs);
|
|
}
|
|
}
|
|
|
|
private async Task<IDictionary<string, object>> RunInitAsync(Func<Task<IDictionary<string, object>>> init)
|
|
{
|
|
// Ensure we are known as the root resource. This is needed before we execute any user
|
|
// code as many codepaths will request the root resource.
|
|
await Deployment.InternalInstance.SetRootResourceAsync(this).ConfigureAwait(false);
|
|
|
|
var dictionary = await init().ConfigureAwait(false);
|
|
return dictionary == null
|
|
? ImmutableDictionary<string, object>.Empty
|
|
: dictionary.ToImmutableDictionary();
|
|
}
|
|
}
|
|
}
|