Build
¶
Source code in docs_src/capo_codebuild/types/build.py
arn
instance-attribute
¶
arn: NotRequired[NonEmptyString]
The Amazon Resource Name (ARN) of the build.
artifacts
instance-attribute
¶
artifacts: NotRequired[BuildArtifacts]
Information about the output artifacts for the build.
auto_retry_config
instance-attribute
¶
auto_retry_config: NotRequired[AutoRetryConfig]
Information about the auto-retry configuration for the build.
build_batch_arn
instance-attribute
¶
build_batch_arn: NotRequired[String]
The ARN of the batch build that this build is a member of, if applicable.
build_complete
instance-attribute
¶
build_complete: Boolean
Whether the build is complete. True if complete; otherwise, false.
build_number
instance-attribute
¶
build_number: NotRequired[WrapperLong]
The number of the build. For each project, the buildNumber of its first build is 1. The buildNumber of each subsequent build is incremented by 1. If a build is deleted, the buildNumber of other builds does not change.
build_status
instance-attribute
¶
build_status: NotRequired[StatusType]
The current status of the build. Valid values include:
-
FAILED: The build failed. -
FAULT: The build faulted. -
IN_PROGRESS: The build is still in progress. -
STOPPED: The build stopped. -
SUCCEEDED: The build succeeded. -
TIMED_OUT: The build timed out.
cache
instance-attribute
¶
cache: NotRequired[ProjectCache]
Information about the cache for the build.
debug_session
instance-attribute
¶
debug_session: NotRequired[DebugSession]
Contains information about the debug session for this build.
encryption_key
instance-attribute
¶
encryption_key: NotRequired[NonEmptyString]
The Key Management Service customer master key (CMK) to be used for encrypting the build output artifacts.
You can use a cross-account KMS key to encrypt the build output artifacts if your service role has permission to that key.
You can specify either the Amazon Resource Name (ARN) of the CMK or, if available, the CMK's alias (using the format alias/).
end_time
instance-attribute
¶
end_time: NotRequired[Timestamp]
When the build process ended, expressed in Unix time format.
environment
instance-attribute
¶
environment: NotRequired[ProjectEnvironment]
Information about the build environment for this build.
exported_environment_variables
instance-attribute
¶
exported_environment_variables: NotRequired[ExportedEnvironmentVariables]
A list of exported environment variables for this build.
Exported environment variables are used in conjunction with CodePipeline to export environment variables from the current build stage to subsequent stages in the pipeline. For more information, see Working with variables in the CodePipeline User Guide.
file_system_locations
instance-attribute
¶
file_system_locations: NotRequired[ProjectFileSystemLocations]
An array of 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.
initiator
instance-attribute
¶
initiator: NotRequired[String]
The entity that started the build. Valid values include:
-
If CodePipeline started the build, the pipeline's name (for example,
codepipeline/my-demo-pipeline). -
If a user started the build, the user's name (for example,
MyUserName). -
If the Jenkins plugin for CodeBuild started the build, the string
CodeBuild-Jenkins-Plugin.
logs
instance-attribute
¶
logs: NotRequired[LogsLocation]
Information about the build's logs in CloudWatch Logs.
network_interface
instance-attribute
¶
network_interface: NotRequired[NetworkInterface]
Describes a network interface.
phases
instance-attribute
¶
phases: NotRequired[BuildPhases]
Information about all previous build phases that are complete and information about any current build phase that is not yet complete.
project_name
instance-attribute
¶
project_name: NotRequired[NonEmptyString]
The name of the CodeBuild project.
queued_timeout_in_minutes
instance-attribute
¶
queued_timeout_in_minutes: NotRequired[WrapperInt]
The number of minutes a build is allowed to be queued before it times out.
report_arns
instance-attribute
¶
report_arns: NotRequired[BuildReportArns]
An array of the ARNs associated with this build's reports.
resolved_source_version
instance-attribute
¶
resolved_source_version: NotRequired[NonEmptyString]
An identifier for the version of this build's source code.
-
For CodeCommit, GitHub, GitHub Enterprise, and BitBucket, the commit ID.
-
For CodePipeline, the source revision provided by CodePipeline.
-
For Amazon S3, this does not apply.
secondary_artifacts
instance-attribute
¶
secondary_artifacts: NotRequired[BuildArtifactsList]
An array of ProjectArtifacts objects.
secondary_source_versions
instance-attribute
¶
secondary_source_versions: NotRequired[ProjectSecondarySourceVersions]
An array of ProjectSourceVersion objects. Each ProjectSourceVersion must be one of:
-
For CodeCommit: the commit ID, branch, or Git tag to use.
-
For GitHub: the commit ID, pull request ID, branch name, or tag name that corresponds to the version of the source code you want to build. If a pull request ID is specified, it must use the format
pr/pull-request-ID(for example,pr/25). If a branch name is specified, the branch's HEAD commit ID is used. If not specified, the default branch's HEAD commit ID is used. -
For Bitbucket: the commit ID, branch name, or tag name that corresponds to the version of the source code you want to build. If a branch name is specified, the branch's HEAD commit ID is used. If not specified, the default branch's HEAD commit ID is used.
-
For Amazon S3: the version ID of the object that represents the build input ZIP file to use.
secondary_sources
instance-attribute
¶
secondary_sources: NotRequired[ProjectSources]
An array of ProjectSource objects.
service_role
instance-attribute
¶
service_role: NotRequired[NonEmptyString]
The name of a service role used for this build.
source
instance-attribute
¶
source: NotRequired[ProjectSource]
Information about the source code to be built.
source_version
instance-attribute
¶
source_version: NotRequired[NonEmptyString]
Any version identifier for the version of the source code to be built. If sourceVersion is specified at the project level, then this sourceVersion (at the build level) takes precedence.
For more information, see Source Version Sample with CodeBuild in the CodeBuild User Guide.
start_time
instance-attribute
¶
start_time: NotRequired[Timestamp]
When the build process started, expressed in Unix time format.
timeout_in_minutes
instance-attribute
¶
timeout_in_minutes: NotRequired[WrapperInt]
How long, in minutes, from 5 to 2160 (36 hours), for CodeBuild to wait before timing out this build if it does not get marked as completed.
vpc_config
instance-attribute
¶
vpc_config: NotRequired[VpcConfig]
If your CodeBuild project accesses resources in an Amazon VPC, you provide this parameter that identifies the VPC ID and the list of security group IDs and subnet IDs. The security groups and subnets must belong to the same VPC. You must provide at least one security group and one subnet ID.