Interface CommonProjectProps
- All Superinterfaces:
software.amazon.jsii.JsiiSerializable
- All Known Subinterfaces:
PipelineProjectProps
,ProjectProps
- All Known Implementing Classes:
CommonProjectProps.Jsii$Proxy
,PipelineProjectProps.Jsii$Proxy
,ProjectProps.Jsii$Proxy
// The code below shows an example of how to instantiate this type. // The values are placeholders you should change. import software.amazon.awscdk.*; import software.amazon.awscdk.services.codebuild.*; import software.amazon.awscdk.services.ec2.*; import software.amazon.awscdk.services.iam.*; import software.amazon.awscdk.services.kms.*; import software.amazon.awscdk.services.logs.*; import software.amazon.awscdk.services.s3.*; Bucket bucket; IBuildImage buildImage; BuildSpec buildSpec; Cache cache; IFileSystemLocation fileSystemLocation; Fleet fleet; Key key; LogGroup logGroup; Role role; SecurityGroup securityGroup; Subnet subnet; SubnetFilter subnetFilter; Object value; Vpc vpc; CommonProjectProps commonProjectProps = CommonProjectProps.builder() .allowAllOutbound(false) .badge(false) .buildSpec(buildSpec) .cache(cache) .checkSecretsInPlainTextEnvVariables(false) .concurrentBuildLimit(123) .description("description") .encryptionKey(key) .environment(BuildEnvironment.builder() .buildImage(buildImage) .certificate(BuildEnvironmentCertificate.builder() .bucket(bucket) .objectKey("objectKey") .build()) .computeType(ComputeType.SMALL) .environmentVariables(Map.of( "environmentVariablesKey", BuildEnvironmentVariable.builder() .value(value) // the properties below are optional .type(BuildEnvironmentVariableType.PLAINTEXT) .build())) .fleet(fleet) .privileged(false) .build()) .environmentVariables(Map.of( "environmentVariablesKey", BuildEnvironmentVariable.builder() .value(value) // the properties below are optional .type(BuildEnvironmentVariableType.PLAINTEXT) .build())) .fileSystemLocations(List.of(fileSystemLocation)) .grantReportGroupPermissions(false) .logging(LoggingOptions.builder() .cloudWatch(CloudWatchLoggingOptions.builder() .enabled(false) .logGroup(logGroup) .prefix("prefix") .build()) .s3(S3LoggingOptions.builder() .bucket(bucket) // the properties below are optional .enabled(false) .encrypted(false) .prefix("prefix") .build()) .build()) .projectName("projectName") .queuedTimeout(Duration.minutes(30)) .role(role) .securityGroups(List.of(securityGroup)) .ssmSessionPermissions(false) .subnetSelection(SubnetSelection.builder() .availabilityZones(List.of("availabilityZones")) .onePerAz(false) .subnetFilters(List.of(subnetFilter)) .subnetGroupName("subnetGroupName") .subnets(List.of(subnet)) .subnetType(SubnetType.PRIVATE_ISOLATED) .build()) .timeout(Duration.minutes(30)) .visibility(ProjectVisibility.PUBLIC_READ) .vpc(vpc) .build();
-
Nested Class Summary
Modifier and TypeInterfaceDescriptionstatic final class
A builder forCommonProjectProps
static final class
An implementation forCommonProjectProps
-
Method Summary
Modifier and TypeMethodDescriptionstatic CommonProjectProps.Builder
builder()
default Boolean
Whether to allow the CodeBuild to send all network traffic.default Boolean
getBadge()
Indicates whether AWS CodeBuild generates a publicly accessible URL for your project's build badge.default BuildSpec
Filename or contents of buildspec in JSON format.default Cache
getCache()
Caching strategy to use.default Boolean
Whether to check for the presence of any secrets in the environment variables of the default type, BuildEnvironmentVariableType.PLAINTEXT.default Number
Maximum number of concurrent builds.default String
A description of the project.default IKey
Encryption key to use to read and write artifacts.default BuildEnvironment
Build environment to use for the build.default Map<String,
BuildEnvironmentVariable> Additional environment variables to add to the build environment.default List<IFileSystemLocation>
An ProjectFileSystemLocation objects for a CodeBuild build project.default Boolean
Add permissions to this project's role to create and use test report groups with name starting with the name of this project.default LoggingOptions
Information about logs for the build project.default String
The physical, human-readable name of the CodeBuild Project.default Duration
The number of minutes after which AWS CodeBuild stops the build if it's still in queue.default IRole
getRole()
Service Role to assume while running the build.default List<ISecurityGroup>
What security group to associate with the codebuild project's network interfaces.default Boolean
Add the permissions necessary for debugging builds with SSM Session Manager.default SubnetSelection
Where to place the network interfaces within the VPC.default Duration
The number of minutes after which AWS CodeBuild stops the build if it's not complete.default ProjectVisibility
Specifies the visibility of the project's builds.default IVpc
getVpc()
VPC network to place codebuild network interfaces.Methods inherited from interface software.amazon.jsii.JsiiSerializable
$jsii$toJson
-
Method Details
-
getAllowAllOutbound
Whether to allow the CodeBuild to send all network traffic.If set to false, you must individually add traffic rules to allow the CodeBuild project to connect to network targets.
Only used if 'vpc' is supplied.
Default: true
-
getBadge
Indicates whether AWS CodeBuild generates a publicly accessible URL for your project's build badge.For more information, see Build Badges Sample in the AWS CodeBuild User Guide.
Default: false
-
getBuildSpec
Filename or contents of buildspec in JSON format.Default: - Empty buildspec.
- See Also:
-
getCache
Caching strategy to use.Default: Cache.none
-
getCheckSecretsInPlainTextEnvVariables
Whether to check for the presence of any secrets in the environment variables of the default type, BuildEnvironmentVariableType.PLAINTEXT. Since using a secret for the value of that kind of variable would result in it being displayed in plain text in the AWS Console, the construct will throw an exception if it detects a secret was passed there. Pass this property as false if you want to skip this validation, and keep using a secret in a plain text environment variable.Default: true
-
getConcurrentBuildLimit
Maximum number of concurrent builds.Minimum value is 1 and maximum is account build limit.
Default: - no explicit limit is set
-
getDescription
A description of the project.Use the description to identify the purpose of the project.
Default: - No description.
-
getEncryptionKey
Encryption key to use to read and write artifacts.Default: - The AWS-managed CMK for Amazon Simple Storage Service (Amazon S3) is used.
-
getEnvironment
Build environment to use for the build.Default: BuildEnvironment.LinuxBuildImage.STANDARD_1_0
-
getEnvironmentVariables
Additional environment variables to add to the build environment.Default: - No additional environment variables are specified.
-
getFileSystemLocations
An ProjectFileSystemLocation objects for a CodeBuild build project.A ProjectFileSystemLocation object specifies the identifier, location, mountOptions, mountPoint, and type of a file system created using Amazon Elastic File System.
Default: - no file system locations
-
getGrantReportGroupPermissions
Add permissions to this project's role to create and use test report groups with name starting with the name of this project.That is the standard report group that gets created when a simple name (in contrast to an ARN) is used in the 'reports' section of the buildspec of this project. This is usually harmless, but you can turn these off if you don't plan on using test reports in this project.
Default: true
- See Also:
-
getLogging
Information about logs for the build project.A project can create logs in Amazon CloudWatch Logs, an S3 bucket, or both.
Default: - no log configuration is set
-
getProjectName
The physical, human-readable name of the CodeBuild Project.Default: - Name is automatically generated.
-
getQueuedTimeout
The number of minutes after which AWS CodeBuild stops the build if it's still in queue.For valid values, see the timeoutInMinutes field in the AWS CodeBuild User Guide.
Default: - no queue timeout is set
-
getRole
Service Role to assume while running the build.Default: - A role will be created.
-
getSecurityGroups
What security group to associate with the codebuild project's network interfaces.If no security group is identified, one will be created automatically.
Only used if 'vpc' is supplied.
Default: - Security group will be automatically created.
-
getSsmSessionPermissions
Add the permissions necessary for debugging builds with SSM Session Manager.If the following prerequisites have been met:
- The necessary permissions have been added by setting this flag to true.
- The build image has the SSM agent installed (true for default CodeBuild images).
- The build is started with debugSessionEnabled set to true.
Then the build container can be paused and inspected using Session Manager by invoking the
codebuild-breakpoint
command somewhere during the build.codebuild-breakpoint
commands will be ignored if the build is not started withdebugSessionEnabled=true
.Default: false
- See Also:
-
getSubnetSelection
Where to place the network interfaces within the VPC.To access AWS services, your CodeBuild project needs to be in one of the following types of subnets:
- Subnets with access to the internet (of type PRIVATE_WITH_EGRESS).
- Private subnets unconnected to the internet, but with VPC endpoints for the necessary services.
If you don't specify a subnet selection, the default behavior is to use PRIVATE_WITH_EGRESS subnets first if they exist, then PRIVATE_WITHOUT_EGRESS, and finally PUBLIC subnets. If your VPC doesn't have PRIVATE_WITH_EGRESS subnets but you need AWS service access, add VPC Endpoints to your private subnets.
Default: - private subnets if available else public subnets
- See Also:
-
getTimeout
The number of minutes after which AWS CodeBuild stops the build if it's not complete.For valid values, see the timeoutInMinutes field in the AWS CodeBuild User Guide.
Default: Duration.hours(1)
-
getVisibility
Specifies the visibility of the project's builds.Default: - no visibility is set
-
getVpc
VPC network to place codebuild network interfaces.Specify this if the codebuild project needs to access resources in a VPC.
Default: - No VPC is specified.
-
builder
- Returns:
- a
CommonProjectProps.Builder
ofCommonProjectProps
-