Copyright | (c) 2013-2023 Brendan Hay |
---|---|
License | Mozilla Public License, v. 2.0. |
Maintainer | Brendan Hay |
Stability | auto-generated |
Portability | non-portable (GHC extensions) |
Safe Haskell | Safe-Inferred |
Language | Haskell2010 |
Synopsis
- data Build = Build' {
- arn :: Maybe Text
- artifacts :: Maybe BuildArtifacts
- buildBatchArn :: Maybe Text
- buildComplete :: Maybe Bool
- buildNumber :: Maybe Integer
- buildStatus :: Maybe StatusType
- cache :: Maybe ProjectCache
- currentPhase :: Maybe Text
- debugSession :: Maybe DebugSession
- encryptionKey :: Maybe Text
- endTime :: Maybe POSIX
- environment :: Maybe ProjectEnvironment
- exportedEnvironmentVariables :: Maybe [ExportedEnvironmentVariable]
- fileSystemLocations :: Maybe [ProjectFileSystemLocation]
- id :: Maybe Text
- initiator :: Maybe Text
- logs :: Maybe LogsLocation
- networkInterface :: Maybe NetworkInterface
- phases :: Maybe [BuildPhase]
- projectName :: Maybe Text
- queuedTimeoutInMinutes :: Maybe Int
- reportArns :: Maybe [Text]
- resolvedSourceVersion :: Maybe Text
- secondaryArtifacts :: Maybe [BuildArtifacts]
- secondarySourceVersions :: Maybe [ProjectSourceVersion]
- secondarySources :: Maybe [ProjectSource]
- serviceRole :: Maybe Text
- source :: Maybe ProjectSource
- sourceVersion :: Maybe Text
- startTime :: Maybe POSIX
- timeoutInMinutes :: Maybe Int
- vpcConfig :: Maybe VpcConfig
- newBuild :: Build
- build_arn :: Lens' Build (Maybe Text)
- build_artifacts :: Lens' Build (Maybe BuildArtifacts)
- build_buildBatchArn :: Lens' Build (Maybe Text)
- build_buildComplete :: Lens' Build (Maybe Bool)
- build_buildNumber :: Lens' Build (Maybe Integer)
- build_buildStatus :: Lens' Build (Maybe StatusType)
- build_cache :: Lens' Build (Maybe ProjectCache)
- build_currentPhase :: Lens' Build (Maybe Text)
- build_debugSession :: Lens' Build (Maybe DebugSession)
- build_encryptionKey :: Lens' Build (Maybe Text)
- build_endTime :: Lens' Build (Maybe UTCTime)
- build_environment :: Lens' Build (Maybe ProjectEnvironment)
- build_exportedEnvironmentVariables :: Lens' Build (Maybe [ExportedEnvironmentVariable])
- build_fileSystemLocations :: Lens' Build (Maybe [ProjectFileSystemLocation])
- build_id :: Lens' Build (Maybe Text)
- build_initiator :: Lens' Build (Maybe Text)
- build_logs :: Lens' Build (Maybe LogsLocation)
- build_networkInterface :: Lens' Build (Maybe NetworkInterface)
- build_phases :: Lens' Build (Maybe [BuildPhase])
- build_projectName :: Lens' Build (Maybe Text)
- build_queuedTimeoutInMinutes :: Lens' Build (Maybe Int)
- build_reportArns :: Lens' Build (Maybe [Text])
- build_resolvedSourceVersion :: Lens' Build (Maybe Text)
- build_secondaryArtifacts :: Lens' Build (Maybe [BuildArtifacts])
- build_secondarySourceVersions :: Lens' Build (Maybe [ProjectSourceVersion])
- build_secondarySources :: Lens' Build (Maybe [ProjectSource])
- build_serviceRole :: Lens' Build (Maybe Text)
- build_source :: Lens' Build (Maybe ProjectSource)
- build_sourceVersion :: Lens' Build (Maybe Text)
- build_startTime :: Lens' Build (Maybe UTCTime)
- build_timeoutInMinutes :: Lens' Build (Maybe Int)
- build_vpcConfig :: Lens' Build (Maybe VpcConfig)
Documentation
Information about a build.
See: newBuild
smart constructor.
Build' | |
|
Instances
Create a value of Build
with all optional fields omitted.
Use generic-lens or optics to modify other optional fields.
The following record fields are available, with the corresponding lenses provided for backwards compatibility:
$sel:arn:Build'
, build_arn
- The Amazon Resource Name (ARN) of the build.
$sel:artifacts:Build'
, build_artifacts
- Information about the output artifacts for the build.
$sel:buildBatchArn:Build'
, build_buildBatchArn
- The ARN of the batch build that this build is a member of, if
applicable.
$sel:buildComplete:Build'
, build_buildComplete
- Whether the build is complete. True if complete; otherwise, false.
$sel:buildNumber:Build'
, build_buildNumber
- 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.
$sel:buildStatus:Build'
, build_buildStatus
- 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.
$sel:cache:Build'
, build_cache
- Information about the cache for the build.
$sel:currentPhase:Build'
, build_currentPhase
- The current build phase.
$sel:debugSession:Build'
, build_debugSession
- Contains information about the debug session for this build.
$sel:encryptionKey:Build'
, build_encryptionKey
- 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/<alias-name>
).
Build
, build_endTime
- When the build process ended, expressed in Unix time format.
$sel:environment:Build'
, build_environment
- Information about the build environment for this build.
$sel:exportedEnvironmentVariables:Build'
, build_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.
$sel:fileSystemLocations:Build'
, build_fileSystemLocations
- 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.
$sel:id:Build'
, build_id
- The unique ID for the build.
$sel:initiator:Build'
, build_initiator
- 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 an IAM 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
.
$sel:logs:Build'
, build_logs
- Information about the build's logs in CloudWatch Logs.
$sel:networkInterface:Build'
, build_networkInterface
- Describes a network interface.
$sel:phases:Build'
, build_phases
- Information about all previous build phases that are complete and
information about any current build phase that is not yet complete.
$sel:projectName:Build'
, build_projectName
- The name of the CodeBuild project.
$sel:queuedTimeoutInMinutes:Build'
, build_queuedTimeoutInMinutes
- The number of minutes a build is allowed to be queued before it times
out.
$sel:reportArns:Build'
, build_reportArns
- An array of the ARNs associated with this build's reports.
$sel:resolvedSourceVersion:Build'
, build_resolvedSourceVersion
- 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.
$sel:secondaryArtifacts:Build'
, build_secondaryArtifacts
- An array of ProjectArtifacts
objects.
$sel:secondarySourceVersions:Build'
, build_secondarySourceVersions
- 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.
$sel:secondarySources:Build'
, build_secondarySources
- An array of ProjectSource
objects.
$sel:serviceRole:Build'
, build_serviceRole
- The name of a service role used for this build.
$sel:source:Build'
, build_source
- Information about the source code to be built.
Build
, build_sourceVersion
- 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.
Build
, build_startTime
- When the build process started, expressed in Unix time format.
$sel:timeoutInMinutes:Build'
, build_timeoutInMinutes
- How long, in minutes, for CodeBuild to wait before timing out this build
if it does not get marked as completed.
$sel:vpcConfig:Build'
, build_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.
build_artifacts :: Lens' Build (Maybe BuildArtifacts) Source #
Information about the output artifacts for the build.
build_buildBatchArn :: Lens' Build (Maybe Text) Source #
The ARN of the batch build that this build is a member of, if applicable.
build_buildComplete :: Lens' Build (Maybe Bool) Source #
Whether the build is complete. True if complete; otherwise, false.
build_buildNumber :: Lens' Build (Maybe Integer) Source #
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_buildStatus :: Lens' Build (Maybe StatusType) Source #
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.
build_cache :: Lens' Build (Maybe ProjectCache) Source #
Information about the cache for the build.
build_debugSession :: Lens' Build (Maybe DebugSession) Source #
Contains information about the debug session for this build.
build_encryptionKey :: Lens' Build (Maybe Text) Source #
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/<alias-name>
).
build_endTime :: Lens' Build (Maybe UTCTime) Source #
When the build process ended, expressed in Unix time format.
build_environment :: Lens' Build (Maybe ProjectEnvironment) Source #
Information about the build environment for this build.
build_exportedEnvironmentVariables :: Lens' Build (Maybe [ExportedEnvironmentVariable]) Source #
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.
build_fileSystemLocations :: Lens' Build (Maybe [ProjectFileSystemLocation]) Source #
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.
build_initiator :: Lens' Build (Maybe Text) Source #
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 an IAM 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
.
build_logs :: Lens' Build (Maybe LogsLocation) Source #
Information about the build's logs in CloudWatch Logs.
build_networkInterface :: Lens' Build (Maybe NetworkInterface) Source #
Describes a network interface.
build_phases :: Lens' Build (Maybe [BuildPhase]) Source #
Information about all previous build phases that are complete and information about any current build phase that is not yet complete.
build_queuedTimeoutInMinutes :: Lens' Build (Maybe Int) Source #
The number of minutes a build is allowed to be queued before it times out.
build_reportArns :: Lens' Build (Maybe [Text]) Source #
An array of the ARNs associated with this build's reports.
build_resolvedSourceVersion :: Lens' Build (Maybe Text) Source #
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.
build_secondaryArtifacts :: Lens' Build (Maybe [BuildArtifacts]) Source #
An array of ProjectArtifacts
objects.
build_secondarySourceVersions :: Lens' Build (Maybe [ProjectSourceVersion]) Source #
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.
build_secondarySources :: Lens' Build (Maybe [ProjectSource]) Source #
An array of ProjectSource
objects.
build_serviceRole :: Lens' Build (Maybe Text) Source #
The name of a service role used for this build.
build_source :: Lens' Build (Maybe ProjectSource) Source #
Information about the source code to be built.
build_sourceVersion :: Lens' Build (Maybe Text) Source #
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.
build_startTime :: Lens' Build (Maybe UTCTime) Source #
When the build process started, expressed in Unix time format.
build_timeoutInMinutes :: Lens' Build (Maybe Int) Source #
How long, in minutes, for CodeBuild to wait before timing out this build if it does not get marked as completed.
build_vpcConfig :: Lens' Build (Maybe VpcConfig) Source #
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.