Interface IBitBucketSourceProps
Construction properties for BitBucketSource
.
Inherited Members
Namespace: Amazon.CDK.AWS.CodeBuild
Assembly: Amazon.CDK.Lib.dll
Syntax (csharp)
public interface IBitBucketSourceProps : ISourceProps
Syntax (vb)
Public Interface IBitBucketSourceProps
Inherits ISourceProps
Remarks
ExampleMetadata: infused
Examples
var bbSource = Source.BitBucket(new BitBucketSourceProps {
Owner = "owner",
Repo = "repo"
});
Synopsis
Properties
BranchOrRef | The commit ID, pull request ID, branch name, or tag name that corresponds to the version of the source code you want to build. |
BuildStatusName | This parameter is used for the |
BuildStatusUrl | The URL that the build will report back to the source provider. |
CloneDepth | The depth of history to download. |
FetchSubmodules | Whether to fetch submodules while cloning git repo. |
Owner | The BitBucket account/user that owns the repo. |
Repo | The name of the repo (without the username). |
ReportBuildStatus | Whether to send notifications on your build's start and end. |
Webhook | Whether to create a webhook that will trigger a build every time an event happens in the repository. |
WebhookFilters | A list of webhook filters that can constraint what events in the repository will trigger a build. |
WebhookTriggersBatchBuild | Trigger a batch build from a webhook instead of a standard one. |
Properties
BranchOrRef
The commit ID, pull request ID, branch name, or tag name that corresponds to the version of the source code you want to build.
virtual string BranchOrRef { get; }
Property Value
System.String
Remarks
Default: the default branch's HEAD commit ID is used
Examples
"mybranch";
BuildStatusName
This parameter is used for the name
parameter in the Bitbucket commit status.
virtual string BuildStatusName { get; }
Property Value
System.String
Remarks
Can use built-in CodeBuild variables, like $AWS_REGION.
Default: "AWS CodeBuild $AWS_REGION ($PROJECT_NAME)"
See: https://docs.aws.amazon.com/codebuild/latest/userguide/build-env-ref-env-vars.html
Examples
"My build #$CODEBUILD_BUILD_NUMBER";
BuildStatusUrl
The URL that the build will report back to the source provider.
virtual string BuildStatusUrl { get; }
Property Value
System.String
Remarks
Can use built-in CodeBuild variables, like $AWS_REGION.
Default: - link to the AWS Console for CodeBuild to a particular build execution
See: https://docs.aws.amazon.com/codebuild/latest/userguide/build-env-ref-env-vars.html
Examples
"$CODEBUILD_PUBLIC_BUILD_URL";
CloneDepth
The depth of history to download.
virtual Nullable<double> CloneDepth { get; }
Property Value
System.Nullable<System.Double>
Remarks
Minimum value is 0. If this value is 0, greater than 25, or not provided, then the full history is downloaded with each build of the project.
FetchSubmodules
Whether to fetch submodules while cloning git repo.
virtual Nullable<bool> FetchSubmodules { get; }
Property Value
System.Nullable<System.Boolean>
Remarks
Default: false
Owner
The BitBucket account/user that owns the repo.
string Owner { get; }
Property Value
System.String
Examples
"awslabs";
Repo
The name of the repo (without the username).
string Repo { get; }
Property Value
System.String
Examples
"aws-cdk";
ReportBuildStatus
Whether to send notifications on your build's start and end.
virtual Nullable<bool> ReportBuildStatus { get; }
Property Value
System.Nullable<System.Boolean>
Remarks
Default: true
Webhook
Whether to create a webhook that will trigger a build every time an event happens in the repository.
virtual Nullable<bool> Webhook { get; }
Property Value
System.Nullable<System.Boolean>
Remarks
Default: true if any webhookFilters
were provided, false otherwise
WebhookFilters
A list of webhook filters that can constraint what events in the repository will trigger a build.
virtual FilterGroup[] WebhookFilters { get; }
Property Value
Remarks
A build is triggered if any of the provided filter groups match.
Only valid if webhook
was not provided as false.
Default: every push and every Pull Request (create or update) triggers a build
WebhookTriggersBatchBuild
Trigger a batch build from a webhook instead of a standard one.
virtual Nullable<bool> WebhookTriggersBatchBuild { get; }
Property Value
System.Nullable<System.Boolean>
Remarks
Enabling this will enable batch builds on the CodeBuild project.
Default: false