software.amazon.awscdk.services.codepipeline.actions

Interface CodeCommitSourceActionProps

All Superinterfaces:

CommonActionProps, CommonAwsActionProps

All Known Implementing Classes:

CodeCommitSourceActionProps.Jsii$Proxy

@Generated(value="jsii-pacmak/1.67.0 (build 2c027f5)",
           date="2022-09-28T18:14:45.774Z")
public interface CodeCommitSourceActionProps
extends CommonAwsActionProps

Construction properties of the CodeCommit source CodePipeline Action.

Example:

 // Source stage: read from repository
 Repository repo = Repository.Builder.create(stack, "TemplateRepo")
         .repositoryName("template-repo")
         .build();
 Artifact sourceOutput = new Artifact("SourceArtifact");
 CodeCommitSourceAction source = CodeCommitSourceAction.Builder.create()
         .actionName("Source")
         .repository(repo)
         .output(sourceOutput)
         .trigger(CodeCommitTrigger.POLL)
         .build();
 Map<String, Object> sourceStage = Map.of(
         "stageName", "Source",
         "actions", List.of(source));
 // Deployment stage: create and deploy changeset with manual approval
 String stackName = "OurStack";
 String changeSetName = "StagedChangeSet";
 Map<String, Object> prodStage = Map.of(
         "stageName", "Deploy",
         "actions", List.of(
             CloudFormationCreateReplaceChangeSetAction.Builder.create()
                     .actionName("PrepareChanges")
                     .stackName(stackName)
                     .changeSetName(changeSetName)
                     .adminPermissions(true)
                     .templatePath(sourceOutput.atPath("template.yaml"))
                     .runOrder(1)
                     .build(),
             ManualApprovalAction.Builder.create()
                     .actionName("ApproveChanges")
                     .runOrder(2)
                     .build(),
             CloudFormationExecuteChangeSetAction.Builder.create()
                     .actionName("ExecuteChanges")
                     .stackName(stackName)
                     .changeSetName(changeSetName)
                     .runOrder(3)
                     .build()));
 Pipeline.Builder.create(stack, "Pipeline")
         .stages(List.of(sourceStage, prodStage))
         .build();
 

Nested Class Summary

Nested Classes

Modifier and Type	Interface and Description
static class	CodeCommitSourceActionProps.Builder A builder for CodeCommitSourceActionProps
static class	CodeCommitSourceActionProps.Jsii$Proxy An implementation for CodeCommitSourceActionProps

Method Summary

Modifier and Type	Method and Description
static CodeCommitSourceActionProps.Builder	builder()
default java.lang.String	getBranch() Default: 'master'
default java.lang.Boolean	getCodeBuildCloneOutput() Whether the output should be the contents of the repository (which is the default), or a link that allows CodeBuild to clone the repository before building.
default IRole	getEventRole() Role to be used by on commit event rule.
Artifact	getOutput()
IRepository	getRepository() The CodeCommit repository.
default CodeCommitTrigger	getTrigger() How should CodePipeline detect source changes for this Action.

Methods inherited from interface software.amazon.awscdk.services.codepipeline.CommonAwsActionProps

getRole

Methods inherited from interface software.amazon.awscdk.services.codepipeline.CommonActionProps

getActionName, getRunOrder, getVariablesNamespace

Method Detail

getOutput

Artifact getOutput()

getRepository

IRepository getRepository()

The CodeCommit repository.

getBranch

default java.lang.String getBranch()

Default: 'master'

getCodeBuildCloneOutput

default java.lang.Boolean getCodeBuildCloneOutput()

Whether the output should be the contents of the repository (which is the default), or a link that allows CodeBuild to clone the repository before building.

Note: if this option is true, then only CodeBuild actions can use the resulting {@link output}.

Default: false

See Also:

https://docs.aws.amazon.com/codepipeline/latest/userguide/action-reference-CodeCommit.html

getEventRole

default IRole getEventRole()

Role to be used by on commit event rule.

Used only when trigger value is CodeCommitTrigger.EVENTS.

Default: a new role will be created.

getTrigger

default CodeCommitTrigger getTrigger()

How should CodePipeline detect source changes for this Action.

Default: CodeCommitTrigger.EVENTS

builder

static CodeCommitSourceActionProps.Builder builder()

Specified by:

builder in interface CommonActionProps

Specified by:

builder in interface CommonAwsActionProps

Returns:

a CodeCommitSourceActionProps.Builder of CodeCommitSourceActionProps