Package software.amazon.awscdk.services.imagebuilder

Class CfnImagePipeline

java.lang.Object
software.amazon.jsii.JsiiObject
software.constructs.Construct
software.amazon.awscdk.core.Construct
software.amazon.awscdk.core.CfnElement
software.amazon.awscdk.core.CfnRefElement
software.amazon.awscdk.core.CfnResource
software.amazon.awscdk.services.imagebuilder.CfnImagePipeline
All Implemented Interfaces:
IConstruct, IDependable, IInspectable, software.amazon.jsii.JsiiSerializable, software.constructs.IConstruct
@Generated(value="jsii-pacmak/1.84.0 (build 5404dcf)", date="2023-06-19T16:29:57.430Z") @Stability(Stable) public class CfnImagePipeline extends CfnResource implements IInspectable
A CloudFormation AWS::ImageBuilder::ImagePipeline.

An image pipeline is the automation configuration for building secure OS images on AWS . The Image Builder image pipeline is associated with an image recipe that defines the build, validation, and test phases for an image build lifecycle. An image pipeline can be associated with an infrastructure configuration that defines where your image is built. You can define attributes, such as instance type, subnets, security groups, logging, and other infrastructure-related configurations. You can also associate your image pipeline with a distribution configuration to define how you would like to deploy your image.

Example: 

 // The code below shows an example of how to instantiate this type.
 // The values are placeholders you should change.
 import software.amazon.awscdk.services.imagebuilder.*;
 CfnImagePipeline cfnImagePipeline = CfnImagePipeline.Builder.create(this, "MyCfnImagePipeline")
         .infrastructureConfigurationArn("infrastructureConfigurationArn")
         .name("name")
         // the properties below are optional
         .containerRecipeArn("containerRecipeArn")
         .description("description")
         .distributionConfigurationArn("distributionConfigurationArn")
         .enhancedImageMetadataEnabled(false)
         .imageRecipeArn("imageRecipeArn")
         .imageScanningConfiguration(ImageScanningConfigurationProperty.builder()
                 .ecrConfiguration(EcrConfigurationProperty.builder()
                         .containerTags(List.of("containerTags"))
                         .repositoryName("repositoryName")
                         .build())
                 .imageScanningEnabled(false)
                 .build())
         .imageTestsConfiguration(ImageTestsConfigurationProperty.builder()
                 .imageTestsEnabled(false)
                 .timeoutMinutes(123)
                 .build())
         .schedule(ScheduleProperty.builder()
                 .pipelineExecutionStartCondition("pipelineExecutionStartCondition")
                 .scheduleExpression("scheduleExpression")
                 .build())
         .status("status")
         .tags(Map.of(
                 "tagsKey", "tags"))
         .build();

  • Field Details

    • CFN_RESOURCE_TYPE_NAME

      @Stability(Stable) public static final String CFN_RESOURCE_TYPE_NAME
      The CloudFormation resource type name for this resource class.

  • Constructor Details

    • CfnImagePipeline

      protected CfnImagePipeline(software.amazon.jsii.JsiiObjectRef objRef)

    • CfnImagePipeline

      protected CfnImagePipeline(software.amazon.jsii.JsiiObject.InitializationMode initializationMode)

    • CfnImagePipeline

      @Stability(Stable) public CfnImagePipeline(@NotNull Construct scope, @NotNull String id, @NotNull CfnImagePipelineProps props)
      Create a new AWS::ImageBuilder::ImagePipeline.

      Parameters:
      scope -
      • scope in which this resource is defined.
      This parameter is required.
      id -
      • scoped id of the resource.
      This parameter is required.
      props -
      • resource properties.
      This parameter is required.

  • Method Details

    • inspect

      @Stability(Stable) public void inspect(@NotNull TreeInspector inspector)
      Examines the CloudFormation resource and discloses attributes.

      Specified by:
      inspect in interface IInspectable
      Parameters:
      inspector -
      • tree inspector to collect and process attributes.
      This parameter is required.

    • renderProperties

      @Stability(Stable) @NotNull protected Map<String,Object> renderProperties(@NotNull Map<String,Object> props)
      Overrides:
      renderProperties in class CfnResource
      Parameters:
      props - This parameter is required.

    • getAttrArn

      @Stability(Stable) @NotNull public String getAttrArn()
      Returns the Amazon Resource Name (ARN) of the image pipeline.

      For example, arn:aws:imagebuilder:us-west-2:123456789012:image-pipeline/mywindows2016pipeline .

    • getAttrName

      @Stability(Stable) @NotNull public String getAttrName()
      Returns the name of the image pipeline.

    • getCfnProperties

      @Stability(Stable) @NotNull protected Map<String,Object> getCfnProperties()
      Overrides:
      getCfnProperties in class CfnResource

    • getTags

      @Stability(Stable) @NotNull public TagManager getTags()
      The tags of this image pipeline.

    • getInfrastructureConfigurationArn

      @Stability(Stable) @NotNull public String getInfrastructureConfigurationArn()
      The Amazon Resource Name (ARN) of the infrastructure configuration associated with this image pipeline.

    • setInfrastructureConfigurationArn

      @Stability(Stable) public void setInfrastructureConfigurationArn(@NotNull String value)
      The Amazon Resource Name (ARN) of the infrastructure configuration associated with this image pipeline.

    • getName

      @Stability(Stable) @NotNull public String getName()
      The name of the image pipeline.

    • setName

      @Stability(Stable) public void setName(@NotNull String value)
      The name of the image pipeline.

    • getContainerRecipeArn

      @Stability(Stable) @Nullable public String getContainerRecipeArn()
      The Amazon Resource Name (ARN) of the container recipe that is used for this pipeline.

    • setContainerRecipeArn

      @Stability(Stable) public void setContainerRecipeArn(@Nullable String value)
      The Amazon Resource Name (ARN) of the container recipe that is used for this pipeline.

    • getDescription

      @Stability(Stable) @Nullable public String getDescription()
      The description of this image pipeline.

    • setDescription

      @Stability(Stable) public void setDescription(@Nullable String value)
      The description of this image pipeline.

    • getDistributionConfigurationArn

      @Stability(Stable) @Nullable public String getDistributionConfigurationArn()
      The Amazon Resource Name (ARN) of the distribution configuration associated with this image pipeline.

    • setDistributionConfigurationArn

      @Stability(Stable) public void setDistributionConfigurationArn(@Nullable String value)
      The Amazon Resource Name (ARN) of the distribution configuration associated with this image pipeline.

    • getEnhancedImageMetadataEnabled

      @Stability(Stable) @Nullable public Object getEnhancedImageMetadataEnabled()
      Collects additional information about the image being created, including the operating system (OS) version and package list.

      This information is used to enhance the overall experience of using EC2 Image Builder. Enabled by default.

    • setEnhancedImageMetadataEnabled

      @Stability(Stable) public void setEnhancedImageMetadataEnabled(@Nullable Boolean value)
      Collects additional information about the image being created, including the operating system (OS) version and package list.

      This information is used to enhance the overall experience of using EC2 Image Builder. Enabled by default.

    • setEnhancedImageMetadataEnabled

      @Stability(Stable) public void setEnhancedImageMetadataEnabled(@Nullable IResolvable value)
      Collects additional information about the image being created, including the operating system (OS) version and package list.

      This information is used to enhance the overall experience of using EC2 Image Builder. Enabled by default.

    • getImageRecipeArn

      @Stability(Stable) @Nullable public String getImageRecipeArn()
      The Amazon Resource Name (ARN) of the image recipe associated with this image pipeline.

    • setImageRecipeArn

      @Stability(Stable) public void setImageRecipeArn(@Nullable String value)
      The Amazon Resource Name (ARN) of the image recipe associated with this image pipeline.

    • getImageScanningConfiguration

      @Stability(Stable) @Nullable public Object getImageScanningConfiguration()
      AWS::ImageBuilder::ImagePipeline.ImageScanningConfiguration.

    • setImageScanningConfiguration

      @Stability(Stable) public void setImageScanningConfiguration(@Nullable IResolvable value)
      AWS::ImageBuilder::ImagePipeline.ImageScanningConfiguration.

    • setImageScanningConfiguration

      @Stability(Stable) public void setImageScanningConfiguration(@Nullable CfnImagePipeline.ImageScanningConfigurationProperty value)
      AWS::ImageBuilder::ImagePipeline.ImageScanningConfiguration.

    • getImageTestsConfiguration

      @Stability(Stable) @Nullable public Object getImageTestsConfiguration()
      The configuration of the image tests that run after image creation to ensure the quality of the image that was created.

    • setImageTestsConfiguration

      @Stability(Stable) public void setImageTestsConfiguration(@Nullable IResolvable value)
      The configuration of the image tests that run after image creation to ensure the quality of the image that was created.

    • setImageTestsConfiguration

      @Stability(Stable) public void setImageTestsConfiguration(@Nullable CfnImagePipeline.ImageTestsConfigurationProperty value)
      The configuration of the image tests that run after image creation to ensure the quality of the image that was created.

    • getSchedule

      @Stability(Stable) @Nullable public Object getSchedule()
      The schedule of the image pipeline.

      A schedule configures how often and when a pipeline automatically creates a new image.

    • setSchedule

      @Stability(Stable) public void setSchedule(@Nullable IResolvable value)
      The schedule of the image pipeline.

      A schedule configures how often and when a pipeline automatically creates a new image.

    • setSchedule

      @Stability(Stable) public void setSchedule(@Nullable CfnImagePipeline.ScheduleProperty value)
      The schedule of the image pipeline.

      A schedule configures how often and when a pipeline automatically creates a new image.

    • getStatus

      @Stability(Stable) @Nullable public String getStatus()
      The status of the image pipeline.

    • setStatus

      @Stability(Stable) public void setStatus(@Nullable String value)
      The status of the image pipeline.