Skip to content

App

A construct which represents an entire CDK app. This construct is normally the root of the construct tree.

You would normally define an 'App' instance in your program's entrypoint, then define constructs where the app is used as the parent scope.

After all the child constructs are defined within the app, you should call 'app.synth()' which will emit a "ros template" from this app into the directory specified by 'outdir'.

Initializers

using AlibabaCloud.SDK.ROS.CDK.Core;
new App(AppProps Props = null);
Name Type Description
Props AppProps initialization properties.

PropsOptional

initialization properties.


Methods

Name Description
ToString Returns a string representation of this construct.
Synthesize Allows this construct to emit artifacts into the cloud assembly during synthesis.
Synth Synthesize this stage into a cloud assembly.

ToString

private string ToString()

Returns a string representation of this construct.

Synthesize

private void Synthesize(ISynthesisSession Session)

Allows this construct to emit artifacts into the cloud assembly during synthesis.

This method is usually implemented by framework-level constructs such as Stack and Asset as they participate in synthesizing the cloud assembly.

SessionRequired

The synthesis session.


Synth

private CloudAssembly Synth(StageSynthesisOptions Options = null)

Synthesize this stage into a cloud assembly.

Once an assembly has been synthesized, it cannot be modified. Subsequent calls will return the same assembly.

OptionsOptional


Static Functions

Name Description
IsConstruct Return whether the given object is a Construct.
IsStage Test whether the given construct is a stage.
Of Return the stage this construct is contained with, if available.
IsApp Checks if an object is an instance of the 'App' class.

IsConstruct

using AlibabaCloud.SDK.ROS.CDK.Core;
App.IsConstruct(object X);

Return whether the given object is a Construct.

XRequired

  • Type: object

IsStage

using AlibabaCloud.SDK.ROS.CDK.Core;
App.IsStage(object X);

Test whether the given construct is a stage.

XRequired

  • Type: object

Of

using AlibabaCloud.SDK.ROS.CDK.Core;
App.Of(IConstruct Construct);

Return the stage this construct is contained with, if available.

If called on a nested stage, returns its parent.

ConstructRequired


IsApp

using AlibabaCloud.SDK.ROS.CDK.Core;
App.IsApp(object Obj);

Checks if an object is an instance of the 'App' class.

Returns 'true' if 'obj' is an 'App'. Param obj The object to evaluate

ObjRequired

  • Type: object

Properties

Name Type Description
Node ConstructNode The construct tree node associated with this construct.
ArtifactId string Artifact ID of the assembly if it is a nested stage. The root stage app will return an empty string.
AssetOutdir string The cloud assembly asset output directory.
Outdir string The cloud assembly output directory.
StageName string The name of the stage.
Account string The default account for all resources defined within this stage.
ParentStage Stage The parent stage or 'undefined' if this is the app.
Region string The default region for all resources defined within this stage.

NodeRequired

public ConstructNode Node { get; }

The construct tree node associated with this construct.


ArtifactIdRequired

public string ArtifactId { get; }
  • Type: string

Artifact ID of the assembly if it is a nested stage. The root stage app will return an empty string.

Derived from the construct path.


AssetOutdirRequired

public string AssetOutdir { get; }
  • Type: string

The cloud assembly asset output directory.


OutdirRequired

public string Outdir { get; }
  • Type: string

The cloud assembly output directory.


StageNameRequired

public string StageName { get; }
  • Type: string

The name of the stage.

Based on names of the parent stages separated by hypens.


AccountOptional

public string Account { get; }
  • Type: string

The default account for all resources defined within this stage.


ParentStageOptional

public Stage ParentStage { get; }

The parent stage or 'undefined' if this is the app.

*


RegionOptional

public string Region { get; }
  • Type: string

The default region for all resources defined within this stage.