software.amazon.awscdk.services.codepipeline

Class Pipeline

java.lang.Object

software.amazon.jsii.JsiiObject

software.constructs.Construct

software.amazon.awscdk.Resource

software.amazon.awscdk.services.codepipeline.Pipeline

All Implemented Interfaces:

IResource, IPipeline, INotificationRuleSource, software.amazon.jsii.JsiiSerializable, software.constructs.IConstruct, software.constructs.IDependable

@Generated(value="jsii-pacmak/1.67.0 (build 2c027f5)",
           date="2022-09-19T20:26:37.481Z")
 @Stability(value=Stable)
public class Pipeline
extends Resource
implements IPipeline

An AWS CodePipeline pipeline with its associated IAM role and S3 bucket.

Example:

 // Example automatically generated from non-compiling source. May contain errors.
 // create a pipeline
 import software.amazon.awscdk.services.codecommit.*;
 // add a source action to the stage
 Repository repo;
 Artifact sourceArtifact;
 Pipeline pipeline = new Pipeline(this, "Pipeline");
 // add a stage
 IStage sourceStage = pipeline.addStage(StageOptions.builder().stageName("Source").build());
 sourceStage.addAction(CodeCommitSourceAction.Builder.create()
         .actionName("Source")
         .output(sourceArtifact)
         .repository(repo)
         .build());
 

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	Pipeline.Builder A fluent builder for Pipeline.

Nested classes/interfaces inherited from class software.amazon.jsii.JsiiObject

software.amazon.jsii.JsiiObject.InitializationMode

Nested classes/interfaces inherited from interface software.amazon.awscdk.services.codepipeline.IPipeline

IPipeline.Jsii$Default, IPipeline.Jsii$Proxy

Constructor Summary

Constructors

Modifier	Constructor and Description
	Pipeline(software.constructs.Construct scope, String id)
	Pipeline(software.constructs.Construct scope, String id, PipelineProps props)
protected	Pipeline(software.amazon.jsii.JsiiObject.InitializationMode initializationMode)
protected	Pipeline(software.amazon.jsii.JsiiObjectRef objRef)

Method Summary

Modifier and Type	Method and Description
IStage	addStage(StageOptions props) Creates a new Stage, and adds it to this Pipeline.
void	addToRolePolicy(PolicyStatement statement) Adds a statement to the pipeline role.
NotificationRuleSourceConfig	bindAsNotificationRuleSource(software.constructs.Construct _scope) Returns a source configuration for notification rule.
static IPipeline	fromPipelineArn(software.constructs.Construct scope, String id, String pipelineArn) Import a pipeline into this app.
IBucket	getArtifactBucket() Bucket used to store output artifacts.
Map<String,CrossRegionSupport>	getCrossRegionSupport() Returns all of the CrossRegionSupportStacks that were generated automatically when dealing with Actions that reside in a different region than the Pipeline itself.
String	getPipelineArn() ARN of this pipeline.
String	getPipelineName() The name of the pipeline.
String	getPipelineVersion() The version of the pipeline.
IRole	getRole() The IAM role AWS CodePipeline will use to perform actions or assume roles for actions with a more specific IAM role.
Number	getStageCount() Get the number of Stages in this Pipeline.
List<IStage>	getStages() Returns the stages that comprise the pipeline.
INotificationRule	notifyOn(String id, INotificationRuleTarget target, PipelineNotifyOnOptions options) Defines a CodeStar notification rule triggered when the pipeline events emitted by you specified, it very similar to `onEvent` API.
INotificationRule	notifyOnAnyActionStateChange(String id, INotificationRuleTarget target) Define an notification rule triggered by the set of the "Action execution" events emitted from this pipeline.
INotificationRule	notifyOnAnyActionStateChange(String id, INotificationRuleTarget target, NotificationRuleOptions options) Define an notification rule triggered by the set of the "Action execution" events emitted from this pipeline.
INotificationRule	notifyOnAnyManualApprovalStateChange(String id, INotificationRuleTarget target) Define an notification rule triggered by the set of the "Manual approval" events emitted from this pipeline.
INotificationRule	notifyOnAnyManualApprovalStateChange(String id, INotificationRuleTarget target, NotificationRuleOptions options) Define an notification rule triggered by the set of the "Manual approval" events emitted from this pipeline.
INotificationRule	notifyOnAnyStageStateChange(String id, INotificationRuleTarget target) Define an notification rule triggered by the set of the "Stage execution" events emitted from this pipeline.
INotificationRule	notifyOnAnyStageStateChange(String id, INotificationRuleTarget target, NotificationRuleOptions options) Define an notification rule triggered by the set of the "Stage execution" events emitted from this pipeline.
INotificationRule	notifyOnExecutionStateChange(String id, INotificationRuleTarget target) Define an notification rule triggered by the set of the "Pipeline execution" events emitted from this pipeline.
INotificationRule	notifyOnExecutionStateChange(String id, INotificationRuleTarget target, NotificationRuleOptions options) Define an notification rule triggered by the set of the "Pipeline execution" events emitted from this pipeline.
Rule	onEvent(String id) Defines an event rule triggered by this CodePipeline.
Rule	onEvent(String id, OnEventOptions options) Defines an event rule triggered by this CodePipeline.
Rule	onStateChange(String id) Defines an event rule triggered by the "CodePipeline Pipeline Execution State Change" event emitted from this pipeline.
Rule	onStateChange(String id, OnEventOptions options) Defines an event rule triggered by the "CodePipeline Pipeline Execution State Change" event emitted from this pipeline.
IStage	stage(String stageName) Access one of the pipeline's stages by stage name.

Methods inherited from class software.amazon.awscdk.Resource

applyRemovalPolicy, generatePhysicalName, getEnv, getPhysicalName, getResourceArnAttribute, getResourceNameAttribute, getStack, isOwnedResource, isResource

Methods inherited from class software.constructs.Construct

getNode, isConstruct, toString

Methods inherited from class software.amazon.jsii.JsiiObject

jsiiAsyncCall, jsiiAsyncCall, jsiiCall, jsiiCall, jsiiGet, jsiiGet, jsiiSet, jsiiStaticCall, jsiiStaticCall, jsiiStaticGet, jsiiStaticGet, jsiiStaticSet, jsiiStaticSet

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Methods inherited from interface software.amazon.awscdk.IResource

applyRemovalPolicy, getEnv, getStack

Methods inherited from interface software.constructs.IConstruct

getNode

Methods inherited from interface software.amazon.jsii.JsiiSerializable

$jsii$toJson

Constructor Detail

Pipeline

protected Pipeline(software.amazon.jsii.JsiiObjectRef objRef)

Pipeline

protected Pipeline(software.amazon.jsii.JsiiObject.InitializationMode initializationMode)

Pipeline

@Stability(value=Stable)
public Pipeline(@NotNull
                                         software.constructs.Construct scope,
                                         @NotNull
                                         String id,
                                         @Nullable
                                         PipelineProps props)

Parameters:

scope - This parameter is required.

id - This parameter is required.

props -

Pipeline

@Stability(value=Stable)
public Pipeline(@NotNull
                                         software.constructs.Construct scope,
                                         @NotNull
                                         String id)

Parameters:

scope - This parameter is required.

id - This parameter is required.

Method Detail

fromPipelineArn

@Stability(value=Stable)
 @NotNull
public static IPipeline fromPipelineArn(@NotNull
                                                                           software.constructs.Construct scope,
                                                                           @NotNull
                                                                           String id,
                                                                           @NotNull
                                                                           String pipelineArn)

Import a pipeline into this app.

Parameters:

scope - the scope into which to import this pipeline. This parameter is required.

id - the logical ID of the returned pipeline construct. This parameter is required.

pipelineArn - The ARN of the pipeline (e.g. `arn:aws:codepipeline:us-east-1:123456789012:MyDemoPipeline`). This parameter is required.

addStage

@Stability(value=Stable)
 @NotNull
public IStage addStage(@NotNull
                                                          StageOptions props)

Creates a new Stage, and adds it to this Pipeline.

Parameters:

props - the creation properties of the new Stage. This parameter is required.

Returns:

the newly created Stage

addToRolePolicy

@Stability(value=Stable)
public void addToRolePolicy(@NotNull
                                                     PolicyStatement statement)

Adds a statement to the pipeline role.

Parameters:

statement - This parameter is required.

bindAsNotificationRuleSource

@Stability(value=Stable)
 @NotNull
public NotificationRuleSourceConfig bindAsNotificationRuleSource(@NotNull
                                                                                                    software.constructs.Construct _scope)

Returns a source configuration for notification rule.

Specified by:

bindAsNotificationRuleSource in interface INotificationRuleSource

Parameters:

_scope - This parameter is required.

notifyOn

@Stability(value=Stable)
 @NotNull
public INotificationRule notifyOn(@NotNull
                                                                     String id,
                                                                     @NotNull
                                                                     INotificationRuleTarget target,
                                                                     @NotNull
                                                                     PipelineNotifyOnOptions options)

Defines a CodeStar notification rule triggered when the pipeline events emitted by you specified, it very similar to `onEvent` API.

You can also use the methods notifyOnExecutionStateChange, notifyOnAnyStageStateChange, notifyOnAnyActionStateChange and notifyOnAnyManualApprovalStateChange to define rules for these specific event emitted.

Specified by:

notifyOn in interface IPipeline

Parameters:

id - This parameter is required.

target - This parameter is required.

options - This parameter is required.

Returns:

CodeStar notification rule associated with this build project.

notifyOnAnyActionStateChange

@Stability(value=Stable)
 @NotNull
public INotificationRule notifyOnAnyActionStateChange(@NotNull
                                                                                         String id,
                                                                                         @NotNull
                                                                                         INotificationRuleTarget target,
                                                                                         @Nullable
                                                                                         NotificationRuleOptions options)

Define an notification rule triggered by the set of the "Action execution" events emitted from this pipeline.

Specified by:

notifyOnAnyActionStateChange in interface IPipeline

Parameters:

id - This parameter is required.

target - This parameter is required.

options -

See Also:

https://docs.aws.amazon.com/dtconsole/latest/userguide/concepts.html#events-ref-pipeline

notifyOnAnyActionStateChange

@Stability(value=Stable)
 @NotNull
public INotificationRule notifyOnAnyActionStateChange(@NotNull
                                                                                         String id,
                                                                                         @NotNull
                                                                                         INotificationRuleTarget target)

Define an notification rule triggered by the set of the "Action execution" events emitted from this pipeline.

Specified by:

notifyOnAnyActionStateChange in interface IPipeline

Parameters:

id - This parameter is required.

target - This parameter is required.

See Also:

https://docs.aws.amazon.com/dtconsole/latest/userguide/concepts.html#events-ref-pipeline

notifyOnAnyManualApprovalStateChange

@Stability(value=Stable)
 @NotNull
public INotificationRule notifyOnAnyManualApprovalStateChange(@NotNull
                                                                                                 String id,
                                                                                                 @NotNull
                                                                                                 INotificationRuleTarget target,
                                                                                                 @Nullable
                                                                                                 NotificationRuleOptions options)

Define an notification rule triggered by the set of the "Manual approval" events emitted from this pipeline.

Specified by:

notifyOnAnyManualApprovalStateChange in interface IPipeline

Parameters:

id - This parameter is required.

target - This parameter is required.

options -

See Also:

https://docs.aws.amazon.com/dtconsole/latest/userguide/concepts.html#events-ref-pipeline

notifyOnAnyManualApprovalStateChange

@Stability(value=Stable)
 @NotNull
public INotificationRule notifyOnAnyManualApprovalStateChange(@NotNull
                                                                                                 String id,
                                                                                                 @NotNull
                                                                                                 INotificationRuleTarget target)

Define an notification rule triggered by the set of the "Manual approval" events emitted from this pipeline.

Specified by:

notifyOnAnyManualApprovalStateChange in interface IPipeline

Parameters:

id - This parameter is required.

target - This parameter is required.

See Also:

https://docs.aws.amazon.com/dtconsole/latest/userguide/concepts.html#events-ref-pipeline

notifyOnAnyStageStateChange

@Stability(value=Stable)
 @NotNull
public INotificationRule notifyOnAnyStageStateChange(@NotNull
                                                                                        String id,
                                                                                        @NotNull
                                                                                        INotificationRuleTarget target,
                                                                                        @Nullable
                                                                                        NotificationRuleOptions options)

Define an notification rule triggered by the set of the "Stage execution" events emitted from this pipeline.

Specified by:

notifyOnAnyStageStateChange in interface IPipeline

Parameters:

id - This parameter is required.

target - This parameter is required.

options -

See Also:

https://docs.aws.amazon.com/dtconsole/latest/userguide/concepts.html#events-ref-pipeline

notifyOnAnyStageStateChange

@Stability(value=Stable)
 @NotNull
public INotificationRule notifyOnAnyStageStateChange(@NotNull
                                                                                        String id,
                                                                                        @NotNull
                                                                                        INotificationRuleTarget target)

Define an notification rule triggered by the set of the "Stage execution" events emitted from this pipeline.

Specified by:

notifyOnAnyStageStateChange in interface IPipeline

Parameters:

id - This parameter is required.

target - This parameter is required.

See Also:

https://docs.aws.amazon.com/dtconsole/latest/userguide/concepts.html#events-ref-pipeline

notifyOnExecutionStateChange

@Stability(value=Stable)
 @NotNull
public INotificationRule notifyOnExecutionStateChange(@NotNull
                                                                                         String id,
                                                                                         @NotNull
                                                                                         INotificationRuleTarget target,
                                                                                         @Nullable
                                                                                         NotificationRuleOptions options)

Define an notification rule triggered by the set of the "Pipeline execution" events emitted from this pipeline.

Specified by:

notifyOnExecutionStateChange in interface IPipeline

Parameters:

id - This parameter is required.

target - This parameter is required.

options -

See Also:

https://docs.aws.amazon.com/dtconsole/latest/userguide/concepts.html#events-ref-pipeline

notifyOnExecutionStateChange

@Stability(value=Stable)
 @NotNull
public INotificationRule notifyOnExecutionStateChange(@NotNull
                                                                                         String id,
                                                                                         @NotNull
                                                                                         INotificationRuleTarget target)

Define an notification rule triggered by the set of the "Pipeline execution" events emitted from this pipeline.

Specified by:

notifyOnExecutionStateChange in interface IPipeline

Parameters:

id - This parameter is required.

target - This parameter is required.

See Also:

https://docs.aws.amazon.com/dtconsole/latest/userguide/concepts.html#events-ref-pipeline

onEvent

@Stability(value=Stable)
 @NotNull
public Rule onEvent(@NotNull
                                                       String id,
                                                       @Nullable
                                                       OnEventOptions options)

Defines an event rule triggered by this CodePipeline.

Specified by:

onEvent in interface IPipeline

Parameters:

id - Identifier for this event handler. This parameter is required.

options - Additional options to pass to the event rule.

onEvent

@Stability(value=Stable)
 @NotNull
public Rule onEvent(@NotNull
                                                       String id)

Defines an event rule triggered by this CodePipeline.

Specified by:

onEvent in interface IPipeline

Parameters:

id - Identifier for this event handler. This parameter is required.

onStateChange

@Stability(value=Stable)
 @NotNull
public Rule onStateChange(@NotNull
                                                             String id,
                                                             @Nullable
                                                             OnEventOptions options)

Defines an event rule triggered by the "CodePipeline Pipeline Execution State Change" event emitted from this pipeline.

Specified by:

onStateChange in interface IPipeline

Parameters:

id - Identifier for this event handler. This parameter is required.

options - Additional options to pass to the event rule.

onStateChange

@Stability(value=Stable)
 @NotNull
public Rule onStateChange(@NotNull
                                                             String id)

Defines an event rule triggered by the "CodePipeline Pipeline Execution State Change" event emitted from this pipeline.

Specified by:

onStateChange in interface IPipeline

Parameters:

id - Identifier for this event handler. This parameter is required.

stage

@Stability(value=Stable)
 @NotNull
public IStage stage(@NotNull
                                                       String stageName)

Access one of the pipeline's stages by stage name.

Parameters:

stageName - This parameter is required.

getArtifactBucket

@Stability(value=Stable)
 @NotNull
public IBucket getArtifactBucket()

Bucket used to store output artifacts.

getCrossRegionSupport

@Stability(value=Stable)
 @NotNull
public Map<String,CrossRegionSupport> getCrossRegionSupport()

Returns all of the CrossRegionSupportStacks that were generated automatically when dealing with Actions that reside in a different region than the Pipeline itself.

getPipelineArn

@Stability(value=Stable)
 @NotNull
public String getPipelineArn()

ARN of this pipeline.

Specified by:

getPipelineArn in interface IPipeline

getPipelineName

@Stability(value=Stable)
 @NotNull
public String getPipelineName()

The name of the pipeline.

Specified by:

getPipelineName in interface IPipeline

getPipelineVersion

@Stability(value=Stable)
 @NotNull
public String getPipelineVersion()

The version of the pipeline.

getRole

@Stability(value=Stable)
 @NotNull
public IRole getRole()

The IAM role AWS CodePipeline will use to perform actions or assume roles for actions with a more specific IAM role.

getStageCount

@Stability(value=Stable)
 @NotNull
public Number getStageCount()

Get the number of Stages in this Pipeline.

getStages

@Stability(value=Stable)
 @NotNull
public List<IStage> getStages()

Returns the stages that comprise the pipeline.

Note: the returned array is a defensive copy, so adding elements to it has no effect. Instead, use the {@link addStage} method if you want to add more stages to the pipeline.