CfnPipelineProps

class aws_cdk.aws_codepipeline.CfnPipelineProps(*, role_arn, stages, artifact_store=None, artifact_stores=None, disable_inbound_stage_transitions=None, execution_mode=None, name=None, pipeline_type=None, restart_execution_on_update=None, tags=None, triggers=None, variables=None)

Bases: object

Properties for defining a CfnPipeline.

Parameters:

role_arn (str) – The Amazon Resource Name (ARN) for CodePipeline to use to either perform actions with no actionRoleArn , or to use to assume roles for actions with an actionRoleArn .
stages (Union[IResolvable, Sequence[Union[IResolvable, StageDeclarationProperty, Dict[str, Any]]]]) – Represents information about a stage and its definition.
artifact_store (Union[IResolvable, ArtifactStoreProperty, Dict[str, Any], None]) – The S3 bucket where artifacts for the pipeline are stored. .. epigraph:: You must include either artifactStore or artifactStores in your pipeline, but you cannot use both. If you create a cross-region action in your pipeline, you must use artifactStores .
artifact_stores (Union[IResolvable, Sequence[Union[IResolvable, ArtifactStoreMapProperty, Dict[str, Any]]], None]) – A mapping of artifactStore objects and their corresponding AWS Regions. There must be an artifact store for the pipeline Region and for each cross-region action in the pipeline. .. epigraph:: You must include either artifactStore or artifactStores in your pipeline, but you cannot use both. If you create a cross-region action in your pipeline, you must use artifactStores .
disable_inbound_stage_transitions (Union[IResolvable, Sequence[Union[IResolvable, StageTransitionProperty, Dict[str, Any]]], None]) – Represents the input of a DisableStageTransition action.
execution_mode (Optional[str]) – The method that the pipeline will use to handle multiple executions. The default mode is SUPERSEDED.
name (Optional[str]) – The name of the pipeline.
pipeline_type (Optional[str]) – CodePipeline provides the following pipeline types, which differ in characteristics and price, so that you can tailor your pipeline features and cost to the needs of your applications. - V1 type pipelines have a JSON structure that contains standard pipeline, stage, and action-level parameters. - V2 type pipelines have the same structure as a V1 type, along with additional parameters for release safety and trigger configuration. .. epigraph:: Including V2 parameters, such as triggers on Git tags, in the pipeline JSON when creating or updating a pipeline will result in the pipeline having the V2 type of pipeline and the associated costs. For information about pricing for CodePipeline, see Pricing . For information about which type of pipeline to choose, see What type of pipeline is right for me? .
restart_execution_on_update (Union[bool, IResolvable, None]) – Indicates whether to rerun the CodePipeline pipeline after you update it.
tags (Optional[Sequence[Union[CfnTag, Dict[str, Any]]]]) – Specifies the tags applied to the pipeline.
triggers (Union[IResolvable, Sequence[Union[IResolvable, PipelineTriggerDeclarationProperty, Dict[str, Any]]], None]) – The trigger configuration specifying a type of event, such as Git tags, that starts the pipeline. .. epigraph:: When a trigger configuration is specified, default change detection for repository and branch commits is disabled.
variables (Union[IResolvable, Sequence[Union[IResolvable, VariableDeclarationProperty, Dict[str, Any]]], None]) – A list that defines the pipeline variables for a pipeline resource. Variable names can have alphanumeric and underscore characters, and the values must match [A-Za-z0-9@\-_]+ .

See:

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-codepipeline-pipeline.html

ExampleMetadata:

fixture=_generated

Example:

# The code below shows an example of how to instantiate this type.
# The values are placeholders you should change.
from aws_cdk import aws_codepipeline as codepipeline

# configuration: Any

cfn_pipeline_props = codepipeline.CfnPipelineProps(
    role_arn="roleArn",
    stages=[codepipeline.CfnPipeline.StageDeclarationProperty(
        actions=[codepipeline.CfnPipeline.ActionDeclarationProperty(
            action_type_id=codepipeline.CfnPipeline.ActionTypeIdProperty(
                category="category",
                owner="owner",
                provider="provider",
                version="version"
            ),
            name="name",

            # the properties below are optional
            configuration=configuration,
            input_artifacts=[codepipeline.CfnPipeline.InputArtifactProperty(
                name="name"
            )],
            namespace="namespace",
            output_artifacts=[codepipeline.CfnPipeline.OutputArtifactProperty(
                name="name"
            )],
            region="region",
            role_arn="roleArn",
            run_order=123,
            timeout_in_minutes=123
        )],
        name="name",

        # the properties below are optional
        blockers=[codepipeline.CfnPipeline.BlockerDeclarationProperty(
            name="name",
            type="type"
        )]
    )],

    # the properties below are optional
    artifact_store=codepipeline.CfnPipeline.ArtifactStoreProperty(
        location="location",
        type="type",

        # the properties below are optional
        encryption_key=codepipeline.CfnPipeline.EncryptionKeyProperty(
            id="id",
            type="type"
        )
    ),
    artifact_stores=[codepipeline.CfnPipeline.ArtifactStoreMapProperty(
        artifact_store=codepipeline.CfnPipeline.ArtifactStoreProperty(
            location="location",
            type="type",

            # the properties below are optional
            encryption_key=codepipeline.CfnPipeline.EncryptionKeyProperty(
                id="id",
                type="type"
            )
        ),
        region="region"
    )],
    disable_inbound_stage_transitions=[codepipeline.CfnPipeline.StageTransitionProperty(
        reason="reason",
        stage_name="stageName"
    )],
    execution_mode="executionMode",
    name="name",
    pipeline_type="pipelineType",
    restart_execution_on_update=False,
    tags=[CfnTag(
        key="key",
        value="value"
    )],
    triggers=[codepipeline.CfnPipeline.PipelineTriggerDeclarationProperty(
        provider_type="providerType",

        # the properties below are optional
        git_configuration=codepipeline.CfnPipeline.GitConfigurationProperty(
            source_action_name="sourceActionName",

            # the properties below are optional
            pull_request=[codepipeline.CfnPipeline.GitPullRequestFilterProperty(
                branches=codepipeline.CfnPipeline.GitBranchFilterCriteriaProperty(
                    excludes=["excludes"],
                    includes=["includes"]
                ),
                events=["events"],
                file_paths=codepipeline.CfnPipeline.GitFilePathFilterCriteriaProperty(
                    excludes=["excludes"],
                    includes=["includes"]
                )
            )],
            push=[codepipeline.CfnPipeline.GitPushFilterProperty(
                branches=codepipeline.CfnPipeline.GitBranchFilterCriteriaProperty(
                    excludes=["excludes"],
                    includes=["includes"]
                ),
                file_paths=codepipeline.CfnPipeline.GitFilePathFilterCriteriaProperty(
                    excludes=["excludes"],
                    includes=["includes"]
                ),
                tags=codepipeline.CfnPipeline.GitTagFilterCriteriaProperty(
                    excludes=["excludes"],
                    includes=["includes"]
                )
            )]
        )
    )],
    variables=[codepipeline.CfnPipeline.VariableDeclarationProperty(
        name="name",

        # the properties below are optional
        default_value="defaultValue",
        description="description"
    )]
)

Attributes

artifact_store

The S3 bucket where artifacts for the pipeline are stored.

You must include either artifactStore or artifactStores in your pipeline, but you cannot use both. If you create a cross-region action in your pipeline, you must use artifactStores .

See:: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-codepipeline-pipeline.html#cfn-codepipeline-pipeline-artifactstore

artifact_stores

A mapping of artifactStore objects and their corresponding AWS Regions.

There must be an artifact store for the pipeline Region and for each cross-region action in the pipeline. .. epigraph:

You must include either ``artifactStore`` or ``artifactStores`` in your pipeline, but you cannot use both. If you create a cross-region action in your pipeline, you must use ``artifactStores`` .

See:: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-codepipeline-pipeline.html#cfn-codepipeline-pipeline-artifactstores

disable_inbound_stage_transitions

Represents the input of a DisableStageTransition action.

See:: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-codepipeline-pipeline.html#cfn-codepipeline-pipeline-disableinboundstagetransitions

execution_mode

The method that the pipeline will use to handle multiple executions.

The default mode is SUPERSEDED.

See:: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-codepipeline-pipeline.html#cfn-codepipeline-pipeline-executionmode

name

The name of the pipeline.

See:: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-codepipeline-pipeline.html#cfn-codepipeline-pipeline-name

pipeline_type

CodePipeline provides the following pipeline types, which differ in characteristics and price, so that you can tailor your pipeline features and cost to the needs of your applications.

V1 type pipelines have a JSON structure that contains standard pipeline, stage, and action-level parameters.
V2 type pipelines have the same structure as a V1 type, along with additional parameters for release safety and trigger configuration.

Including V2 parameters, such as triggers on Git tags, in the pipeline JSON when creating or updating a pipeline will result in the pipeline having the V2 type of pipeline and the associated costs.

For information about pricing for CodePipeline, see Pricing .

For information about which type of pipeline to choose, see What type of pipeline is right for me? .

See:: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-codepipeline-pipeline.html#cfn-codepipeline-pipeline-pipelinetype

restart_execution_on_update

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

See:: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-codepipeline-pipeline.html#cfn-codepipeline-pipeline-restartexecutiononupdate

role_arn

The Amazon Resource Name (ARN) for CodePipeline to use to either perform actions with no actionRoleArn , or to use to assume roles for actions with an actionRoleArn .