A CDK Pipeline that uses CodePipeline to deploy CDK apps

This is a Pipeline with its engine property set to CodePipelineEngine, and exists for nicer ergonomics for users that don't need to switch out engines.

Hierarchy (view full)

Constructors

Properties

_cloudAssemblyFileSet?: any
_fallbackArtifact?: any

This is set to the very first artifact produced in the pipeline

_myCxAsmRoot?: any
_pipeline?: any
_selfMutationProject?: any
_synthProject?: any
actionFromNode: any

Make an action from the given node and/or step

actionFromStep: any

Take a Step and turn it into a CodePipeline Action

There are only 3 types of Steps we need to support:

  • Shell (generic)
  • ManualApproval (generic)
  • CodePipelineActionFactory (CodePipeline-specific)

The rest is expressed in terms of these 3, or in terms of graph nodes which are handled elsewhere.

artifacts: any
assetCodeBuildRoles: any

Asset roles shared for publishing

cachedFnSub: any
cliVersion?: any
cloudAssemblyFileSet: FileSet

The FileSet tha contains the cloud assembly

This is the primary output of the synth step.

codeBuildDefaultsFor: any
createChangeSetAction: any
dockerCredentials: any
executeChangeSetAction: any
executeDeploymentAction: any
node: Node

The tree node.

nodeTypeFromNode: any
obtainAssetCodeBuildRole: any

This role is used by both the CodePipeline build action and related CodeBuild project. Consolidating these two roles into one, and re-using across all assets, saves significant size of the final synthesized output. Modeled after the CodePipeline role and 'CodePipelineActionRole' roles. Generates one role per asset type to separate file and Docker/image-based permissions.

pipelineStagesAndActionsFromGraph: any
postProcessNode: any

Do additional things after the action got added to the pipeline

Some minor state manipulation of CodeBuild projects and pipeline artifacts.

props: any
publishAssetsAction: any
roleFromPlaceholderArn: any
selfMutateAction: any
selfMutationEnabled: boolean

Whether SelfMutation is enabled for this CDK Pipeline

singlePublisherPerAssetType: any
stackOutputs: any

The build step that produces the CDK Cloud Assembly

useChangeSets: any
waves: Wave[]

The waves in this pipeline

writeTemplateConfiguration: any

Non-template config files for CodePipeline actions

Currently only supports tags.

Accessors

  • get assetsScope(): any
  • Scope for Assets-related resources.

    Purely exists for construct tree backwards compatibility with legacy pipelines

    Returns any

  • get myCxAsmRoot(): any
  • Returns any

  • get pipeline(): Pipeline
  • The CodePipeline pipeline that deploys the CDK app

    Only available after the pipeline has been built.

    Returns Pipeline

  • get selfMutationProject(): IProject
  • The CodeBuild project that performs the SelfMutation

    Will throw an error if this is accessed before buildPipeline() is called, or if selfMutation has been disabled.

    Returns IProject

  • get synthProject(): IProject
  • The CodeBuild project that performs the Synth

    Only available after the pipeline has been built.

    Returns IProject

Methods

  • Deploy a single Stage by itself

    Add a Stage to the pipeline, to be deployed in sequence with other Stages added to the pipeline. All Stacks in the stage will be deployed in an order automatically determined by their relative dependencies.

    Parameters

    Returns StageDeployment

  • Add a Wave to the pipeline, for deploying multiple Stages in parallel

    Use the return object of this method to deploy multiple stages in parallel.

    Example:

    declare const pipeline: pipelines.CodePipeline;

    const wave = pipeline.addWave('MyWave');
    wave.addStage(new MyApplicationStage(this, 'Stage1'));
    wave.addStage(new MyApplicationStage(this, 'Stage2'));

    Parameters

    Returns Wave

  • Send the current pipeline definition to the engine, and construct the pipeline

    It is not possible to modify the pipeline after calling this method.

    Returns void

  • Implemented by subclasses to do the actual pipeline construction

    Returns void

  • Returns a string representation of this construct.

    Returns string

  • Checks if x is a construct.

    Use this method instead of instanceof to properly detect Construct instances, even when the construct library is symlinked.

    Explanation: in JavaScript, multiple copies of the constructs library on disk are seen as independent, completely different libraries. As a consequence, the class Construct in each copy of the constructs library is seen as a different class, and an instance of one class will not test as instanceof the other class. npm install will not create installations like this, but users may manually symlink construct libraries together or use a monorepo tool: in those cases, multiple copies of the constructs library can be accidentally installed, and instanceof will behave unpredictably. It is safest to avoid using instanceof, and using this type-testing method instead.

    Parameters

    • x: any

      Any object

    Returns x is Construct

    true if x is an object created from a class which extends Construct.

  • Return whether the given object extends PipelineBase.

    We do attribute detection since we can't reliably use 'instanceof'.

    Parameters

    • x: any

    Returns x is PipelineBase

Generated using TypeDoc