ImagePipeline
¶
Source code in docs_src/capo_imagebuilder/types/image_pipeline.py
arn
instance-attribute
¶
arn: NotRequired[ImageBuilderArn]
The Amazon Resource Name (ARN) of the image pipeline.
consecutive_failures
instance-attribute
¶
consecutive_failures: NotRequired[ConsecutiveFailures]
Image Builder tracks the number of consecutive failures for scheduled pipeline executions and takes one of the following actions each time it runs on a schedule:
-
If the pipeline execution is successful, the number of consecutive failures resets to zero.
-
If the pipeline execution fails, Image Builder increments the number of consecutive failures. If the failure count reaches the limit defined in the AutoDisablePolicy, Image Builder disables the pipeline.
The consecutive failure count is also reset to zero under the following conditions:
-
The pipeline runs manually and succeeds.
-
The pipeline configuration is updated.
If the pipeline runs manually and fails, the count remains the same. The next scheduled run continues to increment where it left off before.
container_recipe_arn
instance-attribute
¶
container_recipe_arn: NotRequired[Arn]
The Amazon Resource Name (ARN) of the container recipe that is used for this pipeline.
date_created
instance-attribute
¶
date_created: NotRequired[DateTime]
The date on which this image pipeline was created.
date_last_run
instance-attribute
¶
date_last_run: NotRequired[DateTime]
The date on which this image pipeline was last run.
date_next_run
instance-attribute
¶
date_next_run: NotRequired[DateTime]
The next date when the pipeline is scheduled to run.
date_updated
instance-attribute
¶
date_updated: NotRequired[DateTime]
The date on which this image pipeline was last updated.
description
instance-attribute
¶
description: NotRequired[NonEmptyString]
The description of the image pipeline.
distribution_configuration_arn
instance-attribute
¶
distribution_configuration_arn: NotRequired[Arn]
The Amazon Resource Name (ARN) of the distribution configuration associated with this image pipeline.
enhanced_image_metadata_enabled
instance-attribute
¶
enhanced_image_metadata_enabled: NotRequired[NullableBoolean]
Specifies whether to collect additional information about the image being created, including the operating system (OS) version and package list. Defaults to true.
execution_role
instance-attribute
¶
execution_role: NotRequired[RoleNameOrArn]
The name or Amazon Resource Name (ARN) for the IAM role you create that grants Image Builder access to perform workflow actions.
image_recipe_arn
instance-attribute
¶
image_recipe_arn: NotRequired[Arn]
The Amazon Resource Name (ARN) of the image recipe associated with this image pipeline.
image_scanning_configuration
instance-attribute
¶
image_scanning_configuration: NotRequired[ImageScanningConfiguration]
Contains settings for vulnerability scans that Amazon Inspector runs against the test instance during image creation.
image_tags
instance-attribute
¶
image_tags: NotRequired[TagMap]
The tags that Image Builder applies to the Image Builder image resource that this pipeline's scheduled executions create. These tags don't apply to the output AMI. Builds that you start manually use the tags from the StartImagePipelineExecution request instead.
image_tests_configuration
instance-attribute
¶
image_tests_configuration: NotRequired[ImageTestsConfiguration]
The image tests configuration of the image pipeline.
infrastructure_configuration_arn
instance-attribute
¶
infrastructure_configuration_arn: NotRequired[Arn]
The Amazon Resource Name (ARN) of the infrastructure configuration associated with this image pipeline.
last_run_status
instance-attribute
¶
last_run_status: NotRequired[ImageStatus]
The status of the last image that this pipeline built, such as BUILDING, TESTING, FAILED, or AVAILABLE.
logging_configuration
instance-attribute
¶
logging_configuration: NotRequired[PipelineLoggingConfiguration]
The CloudWatch Logs configuration for the pipeline: the log group for image build logs and the log group for pipeline execution logs.
platform
instance-attribute
¶
platform: NotRequired[Platform]
The platform of the image pipeline, inherited from the recipe that the pipeline uses.
status
instance-attribute
¶
status: NotRequired[PipelineStatus]
The status of the image pipeline. A disabled pipeline doesn't run on its schedule, but you can still start builds manually. Image Builder can also disable a pipeline automatically when consecutive scheduled builds fail.
workflows
instance-attribute
¶
workflows: NotRequired[WorkflowConfigurationList]
Contains the workflows that run for the image pipeline.