PipelineProps

class aws_cdk.aws_codepipeline.PipelineProps(*, artifact_bucket=None, cross_account_keys=None, cross_region_replication_buckets=None, pipeline_name=None, restart_execution_on_update=None, role=None, stages=None)

Bases: object

Parameters
  • artifact_bucket (Optional[IBucket]) – The S3 bucket used by this Pipeline to store artifacts. Default: - A new S3 bucket will be created.

  • cross_account_keys (Optional[bool]) – Create KMS keys for cross-account deployments. This controls whether the pipeline is enabled for cross-account deployments. By default cross-account deployments are enabled, but this feature requires that KMS Customer Master Keys are created which have a cost of $1/month. If you do not need cross-account deployments, you can set this to false to not create those keys and save on that cost (the artifact bucket will be encrypted with an AWS-managed key). However, cross-account deployments will no longer be possible. Default: true

  • cross_region_replication_buckets (Optional[Mapping[str, IBucket]]) – (experimental) A map of region to S3 bucket name used for cross-region CodePipeline. For every Action that you specify targeting a different region than the Pipeline itself, if you don’t provide an explicit Bucket for that region using this property, the construct will automatically create a Stack containing an S3 Bucket in that region. Default: - None.

  • pipeline_name (Optional[str]) – Name of the pipeline. Default: - AWS CloudFormation generates an ID and uses that for the pipeline name.

  • restart_execution_on_update (Optional[bool]) – Indicates whether to rerun the AWS CodePipeline pipeline after you update it. Default: false

  • role (Optional[IRole]) – The IAM role to be assumed by this Pipeline. Default: a new IAM role will be created.

  • stages (Optional[List[StageProps]]) – The list of Stages, in order, to create this Pipeline with. You can always add more Stages later by calling {@link Pipeline#addStage}. Default: - None.

Attributes

artifact_bucket

The S3 bucket used by this Pipeline to store artifacts.

Default
  • A new S3 bucket will be created.

Return type

Optional[IBucket]

cross_account_keys

Create KMS keys for cross-account deployments.

This controls whether the pipeline is enabled for cross-account deployments.

By default cross-account deployments are enabled, but this feature requires that KMS Customer Master Keys are created which have a cost of $1/month.

If you do not need cross-account deployments, you can set this to false to not create those keys and save on that cost (the artifact bucket will be encrypted with an AWS-managed key). However, cross-account deployments will no longer be possible.

Default

true

Return type

Optional[bool]

cross_region_replication_buckets

(experimental) A map of region to S3 bucket name used for cross-region CodePipeline.

For every Action that you specify targeting a different region than the Pipeline itself, if you don’t provide an explicit Bucket for that region using this property, the construct will automatically create a Stack containing an S3 Bucket in that region.

Default
  • None.

Stability

experimental

Return type

Optional[Mapping[str, IBucket]]

pipeline_name

Name of the pipeline.

Default
  • AWS CloudFormation generates an ID and uses that for the pipeline name.

Return type

Optional[str]

restart_execution_on_update

Indicates whether to rerun the AWS CodePipeline pipeline after you update it.

Default

false

Return type

Optional[bool]

role

The IAM role to be assumed by this Pipeline.

Default

a new IAM role will be created.

Return type

Optional[IRole]

stages

The list of Stages, in order, to create this Pipeline with.

You can always add more Stages later by calling {@link Pipeline#addStage}.

Default
  • None.

Return type

Optional[List[StageProps]]