@aws-cdk/aws-imagebuilder-alpha 2.230.0-alpha.0 → 2.232.0-alpha.0

package/.warnings.jsii.js

@@ -260,6 +260,36 @@ function _aws_cdk_aws_imagebuilder_alpha_Repository(p) {
 }
 function _aws_cdk_aws_imagebuilder_alpha_DistributionConfiguration(p) {
 }
+function _aws_cdk_aws_imagebuilder_alpha_IImage(p) {
+}
+function _aws_cdk_aws_imagebuilder_alpha_ImageProps(p) {
+    if (p == null)
+        return;
+    visitedObjects.add(p);
+    try {
+        if (!visitedObjects.has(p.recipe))
+            _aws_cdk_aws_imagebuilder_alpha_IRecipeBase(p.recipe);
+        if (!visitedObjects.has(p.distributionConfiguration))
+            _aws_cdk_aws_imagebuilder_alpha_IDistributionConfiguration(p.distributionConfiguration);
+        if (!visitedObjects.has(p.infrastructureConfiguration))
+            _aws_cdk_aws_imagebuilder_alpha_IInfrastructureConfiguration(p.infrastructureConfiguration);
+        if (p.workflows != null)
+            for (const o of p.workflows)
+                if (!visitedObjects.has(o))
+                    _aws_cdk_aws_imagebuilder_alpha_WorkflowConfiguration(o);
+    }
+    finally {
+        visitedObjects.delete(p);
+    }
+}
+function _aws_cdk_aws_imagebuilder_alpha_ImageAttributes(p) {
+}
+function _aws_cdk_aws_imagebuilder_alpha_ImageArchitecture(p) {
+}
+function _aws_cdk_aws_imagebuilder_alpha_ImageType(p) {
+}
+function _aws_cdk_aws_imagebuilder_alpha_Image(p) {
+}
 function _aws_cdk_aws_imagebuilder_alpha_IImagePipeline(p) {
 }
 function _aws_cdk_aws_imagebuilder_alpha_ImagePipelineProps(p) {
@@ -552,6 +582,24 @@ function _aws_cdk_aws_imagebuilder_alpha_AwsManagedWorkflow(p) {
 }
 function _aws_cdk_aws_imagebuilder_alpha_Workflow(p) {
 }
+function _aws_cdk_aws_imagebuilder_alpha_AmazonManagedImageAttributes(p) {
+}
+function _aws_cdk_aws_imagebuilder_alpha_AmazonManagedImageOptions(p) {
+    if (p == null)
+        return;
+    visitedObjects.add(p);
+    try {
+        if (!visitedObjects.has(p.imageArchitecture))
+            _aws_cdk_aws_imagebuilder_alpha_ImageArchitecture(p.imageArchitecture);
+        if (!visitedObjects.has(p.imageType))
+            _aws_cdk_aws_imagebuilder_alpha_ImageType(p.imageType);
+    }
+    finally {
+        visitedObjects.delete(p);
+    }
+}
+function _aws_cdk_aws_imagebuilder_alpha_AmazonManagedImage(p) {
+}
 function _aws_cdk_aws_imagebuilder_alpha_BaseImage(p) {
 }
 function _aws_cdk_aws_imagebuilder_alpha_BaseContainerImage(p) {
@@ -618,4 +666,4 @@ class DeprecationError extends Error {
         });
     }
 }
-module.exports = { print, getPropertyDescriptor, DeprecationError, _aws_cdk_aws_imagebuilder_alpha_IComponent, _aws_cdk_aws_imagebuilder_alpha_ComponentProps, _aws_cdk_aws_imagebuilder_alpha_ComponentAttributes, _aws_cdk_aws_imagebuilder_alpha_AwsManagedComponentAttributes, _aws_cdk_aws_imagebuilder_alpha_AwsMarketplaceComponentAttributes, _aws_cdk_aws_imagebuilder_alpha_ComponentDocument, _aws_cdk_aws_imagebuilder_alpha_ComponentDocumentPhase, _aws_cdk_aws_imagebuilder_alpha_ComponentDocumentStep, _aws_cdk_aws_imagebuilder_alpha_ComponentDocumentLoop, _aws_cdk_aws_imagebuilder_alpha_ComponentDocumentForLoop, _aws_cdk_aws_imagebuilder_alpha_ComponentConstantValue, _aws_cdk_aws_imagebuilder_alpha_ComponentDocumentParameterDefinition, _aws_cdk_aws_imagebuilder_alpha_ComponentAction, _aws_cdk_aws_imagebuilder_alpha_ComponentOnFailure, _aws_cdk_aws_imagebuilder_alpha_ComponentParameterType, _aws_cdk_aws_imagebuilder_alpha_ComponentPhaseName, _aws_cdk_aws_imagebuilder_alpha_ComponentSchemaVersion, _aws_cdk_aws_imagebuilder_alpha_ComponentStepInputs, _aws_cdk_aws_imagebuilder_alpha_ComponentStepIfCondition, _aws_cdk_aws_imagebuilder_alpha_ComponentData, _aws_cdk_aws_imagebuilder_alpha_S3ComponentData, _aws_cdk_aws_imagebuilder_alpha_AwsManagedComponent, _aws_cdk_aws_imagebuilder_alpha_AwsMarketplaceComponent, _aws_cdk_aws_imagebuilder_alpha_Component, _aws_cdk_aws_imagebuilder_alpha_IContainerRecipe, _aws_cdk_aws_imagebuilder_alpha_ContainerRecipeProps, _aws_cdk_aws_imagebuilder_alpha_ContainerType, _aws_cdk_aws_imagebuilder_alpha_DockerfileTemplateConfig, _aws_cdk_aws_imagebuilder_alpha_DockerfileData, _aws_cdk_aws_imagebuilder_alpha_S3DockerfileData, _aws_cdk_aws_imagebuilder_alpha_ContainerRecipeAttributes, _aws_cdk_aws_imagebuilder_alpha_ContainerRecipeBase, _aws_cdk_aws_imagebuilder_alpha_ContainerRecipe, _aws_cdk_aws_imagebuilder_alpha_IDistributionConfiguration, _aws_cdk_aws_imagebuilder_alpha_AmiLaunchPermission, _aws_cdk_aws_imagebuilder_alpha_SSMParameterConfigurations, _aws_cdk_aws_imagebuilder_alpha_LaunchTemplateConfiguration, _aws_cdk_aws_imagebuilder_alpha_FastLaunchConfiguration, _aws_cdk_aws_imagebuilder_alpha_AmiDistribution, _aws_cdk_aws_imagebuilder_alpha_ContainerDistribution, _aws_cdk_aws_imagebuilder_alpha_DistributionConfigurationProps, _aws_cdk_aws_imagebuilder_alpha_RepositoryService, _aws_cdk_aws_imagebuilder_alpha_Repository, _aws_cdk_aws_imagebuilder_alpha_DistributionConfiguration, _aws_cdk_aws_imagebuilder_alpha_IImagePipeline, _aws_cdk_aws_imagebuilder_alpha_ImagePipelineProps, _aws_cdk_aws_imagebuilder_alpha_ImagePipelineSchedule, _aws_cdk_aws_imagebuilder_alpha_ScheduleStartCondition, _aws_cdk_aws_imagebuilder_alpha_ImagePipelineStatus, _aws_cdk_aws_imagebuilder_alpha_ImagePipeline, _aws_cdk_aws_imagebuilder_alpha_IImageRecipe, _aws_cdk_aws_imagebuilder_alpha_ImageRecipeProps, _aws_cdk_aws_imagebuilder_alpha_ImageRecipeAttributes, _aws_cdk_aws_imagebuilder_alpha_ImageRecipe, _aws_cdk_aws_imagebuilder_alpha_IInfrastructureConfiguration, _aws_cdk_aws_imagebuilder_alpha_HttpTokens, _aws_cdk_aws_imagebuilder_alpha_Tenancy, _aws_cdk_aws_imagebuilder_alpha_InfrastructureConfigurationLogging, _aws_cdk_aws_imagebuilder_alpha_InfrastructureConfigurationProps, _aws_cdk_aws_imagebuilder_alpha_InfrastructureConfiguration, _aws_cdk_aws_imagebuilder_alpha_ILifecyclePolicy, _aws_cdk_aws_imagebuilder_alpha_LifecyclePolicyActionType, _aws_cdk_aws_imagebuilder_alpha_LifecyclePolicyStatus, _aws_cdk_aws_imagebuilder_alpha_LifecyclePolicyResourceType, _aws_cdk_aws_imagebuilder_alpha_LifecyclePolicyAction, _aws_cdk_aws_imagebuilder_alpha_LifecyclePolicyFilter, _aws_cdk_aws_imagebuilder_alpha_LifecyclePolicyCountFilter, _aws_cdk_aws_imagebuilder_alpha_LifecyclePolicyAgeFilter, _aws_cdk_aws_imagebuilder_alpha_LifecyclePolicyImageExclusionRules, _aws_cdk_aws_imagebuilder_alpha_LifecyclePolicyAmiExclusionRules, _aws_cdk_aws_imagebuilder_alpha_LifecyclePolicyExclusionRules, _aws_cdk_aws_imagebuilder_alpha_LifecyclePolicyDetail, _aws_cdk_aws_imagebuilder_alpha_LifecyclePolicyResourceSelection, _aws_cdk_aws_imagebuilder_alpha_LifecyclePolicyProps, _aws_cdk_aws_imagebuilder_alpha_LifecyclePolicy, _aws_cdk_aws_imagebuilder_alpha_IWorkflow, _aws_cdk_aws_imagebuilder_alpha_WorkflowProps, _aws_cdk_aws_imagebuilder_alpha_WorkflowAttributes, _aws_cdk_aws_imagebuilder_alpha_AwsManagedWorkflowAttributes, _aws_cdk_aws_imagebuilder_alpha_WorkflowAction, _aws_cdk_aws_imagebuilder_alpha_WorkflowOnFailure, _aws_cdk_aws_imagebuilder_alpha_WorkflowParameterType, _aws_cdk_aws_imagebuilder_alpha_WorkflowSchemaVersion, _aws_cdk_aws_imagebuilder_alpha_WorkflowType, _aws_cdk_aws_imagebuilder_alpha_WorkflowDataConfig, _aws_cdk_aws_imagebuilder_alpha_WorkflowData, _aws_cdk_aws_imagebuilder_alpha_S3WorkflowData, _aws_cdk_aws_imagebuilder_alpha_WorkflowParameterValue, _aws_cdk_aws_imagebuilder_alpha_WorkflowConfiguration, _aws_cdk_aws_imagebuilder_alpha_AwsManagedWorkflow, _aws_cdk_aws_imagebuilder_alpha_Workflow, _aws_cdk_aws_imagebuilder_alpha_BaseImage, _aws_cdk_aws_imagebuilder_alpha_BaseContainerImage, _aws_cdk_aws_imagebuilder_alpha_ContainerInstanceImage, _aws_cdk_aws_imagebuilder_alpha_Platform, _aws_cdk_aws_imagebuilder_alpha_OSVersion, _aws_cdk_aws_imagebuilder_alpha_ComponentParameterValue, _aws_cdk_aws_imagebuilder_alpha_ComponentConfiguration, _aws_cdk_aws_imagebuilder_alpha_IRecipeBase };
+module.exports = { print, getPropertyDescriptor, DeprecationError, _aws_cdk_aws_imagebuilder_alpha_IComponent, _aws_cdk_aws_imagebuilder_alpha_ComponentProps, _aws_cdk_aws_imagebuilder_alpha_ComponentAttributes, _aws_cdk_aws_imagebuilder_alpha_AwsManagedComponentAttributes, _aws_cdk_aws_imagebuilder_alpha_AwsMarketplaceComponentAttributes, _aws_cdk_aws_imagebuilder_alpha_ComponentDocument, _aws_cdk_aws_imagebuilder_alpha_ComponentDocumentPhase, _aws_cdk_aws_imagebuilder_alpha_ComponentDocumentStep, _aws_cdk_aws_imagebuilder_alpha_ComponentDocumentLoop, _aws_cdk_aws_imagebuilder_alpha_ComponentDocumentForLoop, _aws_cdk_aws_imagebuilder_alpha_ComponentConstantValue, _aws_cdk_aws_imagebuilder_alpha_ComponentDocumentParameterDefinition, _aws_cdk_aws_imagebuilder_alpha_ComponentAction, _aws_cdk_aws_imagebuilder_alpha_ComponentOnFailure, _aws_cdk_aws_imagebuilder_alpha_ComponentParameterType, _aws_cdk_aws_imagebuilder_alpha_ComponentPhaseName, _aws_cdk_aws_imagebuilder_alpha_ComponentSchemaVersion, _aws_cdk_aws_imagebuilder_alpha_ComponentStepInputs, _aws_cdk_aws_imagebuilder_alpha_ComponentStepIfCondition, _aws_cdk_aws_imagebuilder_alpha_ComponentData, _aws_cdk_aws_imagebuilder_alpha_S3ComponentData, _aws_cdk_aws_imagebuilder_alpha_AwsManagedComponent, _aws_cdk_aws_imagebuilder_alpha_AwsMarketplaceComponent, _aws_cdk_aws_imagebuilder_alpha_Component, _aws_cdk_aws_imagebuilder_alpha_IContainerRecipe, _aws_cdk_aws_imagebuilder_alpha_ContainerRecipeProps, _aws_cdk_aws_imagebuilder_alpha_ContainerType, _aws_cdk_aws_imagebuilder_alpha_DockerfileTemplateConfig, _aws_cdk_aws_imagebuilder_alpha_DockerfileData, _aws_cdk_aws_imagebuilder_alpha_S3DockerfileData, _aws_cdk_aws_imagebuilder_alpha_ContainerRecipeAttributes, _aws_cdk_aws_imagebuilder_alpha_ContainerRecipeBase, _aws_cdk_aws_imagebuilder_alpha_ContainerRecipe, _aws_cdk_aws_imagebuilder_alpha_IDistributionConfiguration, _aws_cdk_aws_imagebuilder_alpha_AmiLaunchPermission, _aws_cdk_aws_imagebuilder_alpha_SSMParameterConfigurations, _aws_cdk_aws_imagebuilder_alpha_LaunchTemplateConfiguration, _aws_cdk_aws_imagebuilder_alpha_FastLaunchConfiguration, _aws_cdk_aws_imagebuilder_alpha_AmiDistribution, _aws_cdk_aws_imagebuilder_alpha_ContainerDistribution, _aws_cdk_aws_imagebuilder_alpha_DistributionConfigurationProps, _aws_cdk_aws_imagebuilder_alpha_RepositoryService, _aws_cdk_aws_imagebuilder_alpha_Repository, _aws_cdk_aws_imagebuilder_alpha_DistributionConfiguration, _aws_cdk_aws_imagebuilder_alpha_IImage, _aws_cdk_aws_imagebuilder_alpha_ImageProps, _aws_cdk_aws_imagebuilder_alpha_ImageAttributes, _aws_cdk_aws_imagebuilder_alpha_ImageArchitecture, _aws_cdk_aws_imagebuilder_alpha_ImageType, _aws_cdk_aws_imagebuilder_alpha_Image, _aws_cdk_aws_imagebuilder_alpha_IImagePipeline, _aws_cdk_aws_imagebuilder_alpha_ImagePipelineProps, _aws_cdk_aws_imagebuilder_alpha_ImagePipelineSchedule, _aws_cdk_aws_imagebuilder_alpha_ScheduleStartCondition, _aws_cdk_aws_imagebuilder_alpha_ImagePipelineStatus, _aws_cdk_aws_imagebuilder_alpha_ImagePipeline, _aws_cdk_aws_imagebuilder_alpha_IImageRecipe, _aws_cdk_aws_imagebuilder_alpha_ImageRecipeProps, _aws_cdk_aws_imagebuilder_alpha_ImageRecipeAttributes, _aws_cdk_aws_imagebuilder_alpha_ImageRecipe, _aws_cdk_aws_imagebuilder_alpha_IInfrastructureConfiguration, _aws_cdk_aws_imagebuilder_alpha_HttpTokens, _aws_cdk_aws_imagebuilder_alpha_Tenancy, _aws_cdk_aws_imagebuilder_alpha_InfrastructureConfigurationLogging, _aws_cdk_aws_imagebuilder_alpha_InfrastructureConfigurationProps, _aws_cdk_aws_imagebuilder_alpha_InfrastructureConfiguration, _aws_cdk_aws_imagebuilder_alpha_ILifecyclePolicy, _aws_cdk_aws_imagebuilder_alpha_LifecyclePolicyActionType, _aws_cdk_aws_imagebuilder_alpha_LifecyclePolicyStatus, _aws_cdk_aws_imagebuilder_alpha_LifecyclePolicyResourceType, _aws_cdk_aws_imagebuilder_alpha_LifecyclePolicyAction, _aws_cdk_aws_imagebuilder_alpha_LifecyclePolicyFilter, _aws_cdk_aws_imagebuilder_alpha_LifecyclePolicyCountFilter, _aws_cdk_aws_imagebuilder_alpha_LifecyclePolicyAgeFilter, _aws_cdk_aws_imagebuilder_alpha_LifecyclePolicyImageExclusionRules, _aws_cdk_aws_imagebuilder_alpha_LifecyclePolicyAmiExclusionRules, _aws_cdk_aws_imagebuilder_alpha_LifecyclePolicyExclusionRules, _aws_cdk_aws_imagebuilder_alpha_LifecyclePolicyDetail, _aws_cdk_aws_imagebuilder_alpha_LifecyclePolicyResourceSelection, _aws_cdk_aws_imagebuilder_alpha_LifecyclePolicyProps, _aws_cdk_aws_imagebuilder_alpha_LifecyclePolicy, _aws_cdk_aws_imagebuilder_alpha_IWorkflow, _aws_cdk_aws_imagebuilder_alpha_WorkflowProps, _aws_cdk_aws_imagebuilder_alpha_WorkflowAttributes, _aws_cdk_aws_imagebuilder_alpha_AwsManagedWorkflowAttributes, _aws_cdk_aws_imagebuilder_alpha_WorkflowAction, _aws_cdk_aws_imagebuilder_alpha_WorkflowOnFailure, _aws_cdk_aws_imagebuilder_alpha_WorkflowParameterType, _aws_cdk_aws_imagebuilder_alpha_WorkflowSchemaVersion, _aws_cdk_aws_imagebuilder_alpha_WorkflowType, _aws_cdk_aws_imagebuilder_alpha_WorkflowDataConfig, _aws_cdk_aws_imagebuilder_alpha_WorkflowData, _aws_cdk_aws_imagebuilder_alpha_S3WorkflowData, _aws_cdk_aws_imagebuilder_alpha_WorkflowParameterValue, _aws_cdk_aws_imagebuilder_alpha_WorkflowConfiguration, _aws_cdk_aws_imagebuilder_alpha_AwsManagedWorkflow, _aws_cdk_aws_imagebuilder_alpha_Workflow, _aws_cdk_aws_imagebuilder_alpha_AmazonManagedImageAttributes, _aws_cdk_aws_imagebuilder_alpha_AmazonManagedImageOptions, _aws_cdk_aws_imagebuilder_alpha_AmazonManagedImage, _aws_cdk_aws_imagebuilder_alpha_BaseImage, _aws_cdk_aws_imagebuilder_alpha_BaseContainerImage, _aws_cdk_aws_imagebuilder_alpha_ContainerInstanceImage, _aws_cdk_aws_imagebuilder_alpha_Platform, _aws_cdk_aws_imagebuilder_alpha_OSVersion, _aws_cdk_aws_imagebuilder_alpha_ComponentParameterValue, _aws_cdk_aws_imagebuilder_alpha_ComponentConfiguration, _aws_cdk_aws_imagebuilder_alpha_IRecipeBase };

package/README.md

@@ -38,7 +38,10 @@ test phase during the test stage.
 
 ### Image Pipeline
 
-An image pipeline provides the automation framework for building secure AMIs and container images. The pipeline orchestrates the entire image creation process by combining an image recipe or container recipe with infrastructure configuration and distribution configuration. Pipelines can run on a schedule or be triggered manually, and they manage the build, test, and distribution phases automatically.
+An image pipeline provides the automation framework for building secure AMIs and container images. The pipeline
+orchestrates the entire image creation process by combining an image recipe or container recipe with infrastructure
+configuration and distribution configuration. Pipelines can run on a schedule or be triggered manually, and they manage
+the build, test, and distribution phases automatically.
 
 #### Image Pipeline Basic Usage
 
@@ -139,7 +142,7 @@ const advancedSchedulePipeline = new imagebuilder.ImagePipeline(this, 'AdvancedS
 
 #### Image Pipeline Configuration
 
-##### Infrastructure and Distribution
+##### Infrastructure and Distribution in Image Pipelines
 
 Configure custom infrastructure and distribution settings:
 
@@ -177,7 +180,7 @@ const pipelineLogGroup = new logs.LogGroup(this, 'PipelineLogGroup', {
 });
 
 const imageLogGroup = new logs.LogGroup(this, 'ImageLogGroup', {
-  logGroupName: '/custom/imagebuilder/image/logs', 
+  logGroupName: '/custom/imagebuilder/image/logs',
   retention: logs.RetentionDays.ONE_WEEK
 });
 
@@ -188,7 +191,7 @@ const loggedPipeline = new imagebuilder.ImagePipeline(this, 'LoggedPipeline', {
 });
 ```
 
-##### Workflow Integration
+##### Workflow Integration in Image Pipelines
 
 Use AWS-managed workflows for common pipeline phases:
 
@@ -215,7 +218,7 @@ const containerWorkflowPipeline = new imagebuilder.ImagePipeline(this, 'Containe
 });
 ```
 
-##### Advanced Features
+##### Advanced Features in Image Pipelines
 
 Configure image scanning for container pipelines:
 
@@ -286,6 +289,204 @@ existingPipelineByName.grantStartExecution(automationRole);
 existingPipelineByArn.grantRead(lambdaRole);
 ```
 
+### Image
+
+An image is the output resource created by Image Builder, consisting of an AMI or container image plus metadata such as
+version, platform, and creation details. Images are used as base images for future builds and can be shared across AWS
+accounts. While images are the output from image pipeline executions, they can also be created in an ad-hoc manner
+outside a pipeline, defined as a standalone resource.
+
+#### Image Basic Usage
+
+Create a simple AMI-based image from an image recipe:
+
+```ts
+const imageRecipe = new imagebuilder.ImageRecipe(this, 'MyImageRecipe', {
+  baseImage: imagebuilder.BaseImage.fromSsmParameterName(
+    '/aws/service/ami-amazon-linux-latest/al2023-ami-minimal-kernel-default-x86_64'
+  )
+});
+
+const amiImage = new imagebuilder.Image(this, 'MyAmiImage', {
+  recipe: imageRecipe
+});
+```
+
+Create a simple container image from a container recipe:
+
+```ts
+const containerRecipe = new imagebuilder.ContainerRecipe(this, 'MyContainerRecipe', {
+  baseImage: imagebuilder.BaseContainerImage.fromDockerHub('amazonlinux', 'latest'),
+  targetRepository: imagebuilder.Repository.fromEcr(
+    ecr.Repository.fromRepositoryName(this, 'Repository', 'my-container-repo')
+  )
+});
+
+const containerImage = new imagebuilder.Image(this, 'MyContainerImage', {
+  recipe: containerRecipe
+});
+```
+
+#### AWS-Managed Images
+
+##### Pre-defined OS Images
+
+Use AWS-managed images for common operating systems:
+
+```ts
+// Amazon Linux 2023 AMI for x86_64
+const amazonLinux2023Ami = imagebuilder.AmazonManagedImage.amazonLinux2023(this, 'AmazonLinux2023', {
+  imageType: imagebuilder.ImageType.AMI,
+  imageArchitecture: imagebuilder.ImageArchitecture.X86_64
+});
+
+// Ubuntu 22.04 AMI for ARM64
+const ubuntu2204Ami = imagebuilder.AmazonManagedImage.ubuntuServer2204(this, 'Ubuntu2204', {
+  imageType: imagebuilder.ImageType.AMI,
+  imageArchitecture: imagebuilder.ImageArchitecture.ARM64
+});
+
+// Windows Server 2022 Full AMI
+const windows2022Ami = imagebuilder.AmazonManagedImage.windowsServer2022Full(this, 'Windows2022', {
+  imageType: imagebuilder.ImageType.AMI,
+  imageArchitecture: imagebuilder.ImageArchitecture.X86_64
+});
+
+// Use as base image in recipe
+const managedImageRecipe = new imagebuilder.ImageRecipe(this, 'ManagedImageRecipe', {
+  baseImage: amazonLinux2023Ami.toBaseImage()
+});
+```
+
+##### Custom AWS-Managed Images
+
+Import AWS-managed images by name or attributes:
+
+```ts
+// Import by name
+const managedImageByName = imagebuilder.AmazonManagedImage.fromAmazonManagedImageName(
+  this,
+  'ManagedImageByName',
+  'amazon-linux-2023-x86'
+);
+
+// Import by attributes with specific version
+const managedImageByAttributes = imagebuilder.AmazonManagedImage.fromAmazonManagedImageAttributes(this, 'ManagedImageByAttributes', {
+  imageName: 'ubuntu-server-22-lts-x86',
+  imageVersion: '2024.11.25'
+});
+```
+
+#### Image Configuration
+
+##### Infrastructure and Distribution in Images
+
+Configure custom infrastructure and distribution settings:
+
+```ts
+const infrastructureConfiguration = new imagebuilder.InfrastructureConfiguration(this, 'Infrastructure', {
+  infrastructureConfigurationName: 'production-infrastructure',
+  instanceTypes: [
+    ec2.InstanceType.of(ec2.InstanceClass.COMPUTE7_INTEL, ec2.InstanceSize.LARGE)
+  ],
+  vpc: vpc,
+  subnetSelection: { subnetType: ec2.SubnetType.PRIVATE_WITH_EGRESS }
+});
+
+const distributionConfiguration = new imagebuilder.DistributionConfiguration(this, 'Distribution');
+distributionConfiguration.addAmiDistributions({
+  amiName: 'production-ami-{{ imagebuilder:buildDate }}',
+  amiTargetAccountIds: ['123456789012', '098765432109']
+});
+
+const productionImage = new imagebuilder.Image(this, 'ProductionImage', {
+  recipe: exampleImageRecipe,
+  infrastructureConfiguration: infrastructureConfiguration,
+  distributionConfiguration: distributionConfiguration
+});
+```
+
+##### Logging Configuration
+
+Configure custom CloudWatch log groups for image builds:
+
+```ts
+const logGroup = new logs.LogGroup(this, 'ImageLogGroup', {
+  logGroupName: '/custom/imagebuilder/image/logs',
+  retention: logs.RetentionDays.ONE_MONTH
+});
+
+const loggedImage = new imagebuilder.Image(this, 'LoggedImage', {
+  recipe: exampleImageRecipe,
+  logGroup: logGroup
+});
+```
+
+##### Workflow Integration in Images
+
+Use workflows for custom build, test, and distribution processes:
+
+```ts
+const imageWithWorkflows = new imagebuilder.Image(this, 'ImageWithWorkflows', {
+  recipe: exampleImageRecipe,
+  workflows: [
+    { workflow: imagebuilder.AwsManagedWorkflow.buildImage(this, 'BuildWorkflow') },
+    { workflow: imagebuilder.AwsManagedWorkflow.testImage(this, 'TestWorkflow') }
+  ]
+});
+```
+
+##### Advanced Features in Images
+
+Configure image scanning, metadata collection, and testing:
+
+```ts
+const scanningRepository = new ecr.Repository(this, 'ScanningRepository');
+
+const advancedContainerImage = new imagebuilder.Image(this, 'AdvancedContainerImage', {
+  recipe: exampleContainerRecipe,
+  imageScanningEnabled: true,
+  imageScanningEcrRepository: scanningRepository,
+  imageScanningEcrTags: ['security-scan', 'latest'],
+  enhancedImageMetadataEnabled: true,
+  imageTestsEnabled: false  // Skip testing for faster builds
+});
+```
+
+#### Importing Images
+
+Reference existing images created outside CDK:
+
+```ts
+// Import by name
+const existingImageByName = imagebuilder.Image.fromImageName(
+  this,
+  'ExistingImageByName',
+  'my-existing-image'
+);
+
+// Import by ARN
+const existingImageByArn = imagebuilder.Image.fromImageArn(
+  this,
+  'ExistingImageByArn',
+  'arn:aws:imagebuilder:us-east-1:123456789012:image/imported-image/1.0.0'
+);
+
+// Import by attributes
+const existingImageByAttributes = imagebuilder.Image.fromImageAttributes(this, 'ExistingImageByAttributes', {
+  imageName: 'shared-base-image',
+  imageVersion: '2024.11.25'
+});
+
+// Grant permissions to imported images
+const role = new iam.Role(this, 'ImageAccessRole', {
+  assumedBy: new iam.ServicePrincipal('lambda.amazonaws.com')
+});
+
+existingImageByName.grantRead(role);
+existingImageByArn.grant(role, 'imagebuilder:GetImage', 'imagebuilder:ListImagePackages');
+```
+
 ### Image Recipe
 
 #### Image Recipe Basic Usage
@@ -396,7 +597,7 @@ const imageRecipe = new imagebuilder.ImageRecipe(this, 'ComponentImageRecipe', {
 Use pre-built AWS components:
 
 ```ts
-const imageRecipe = new imagebuilder.ImageRecipe(this, 'AwsManagedImageRecipe', {
+const imageRecipe = new imagebuilder.ImageRecipe(this, 'AmazonManagedImageRecipe', {
   baseImage: imagebuilder.BaseImage.fromSsmParameterName(
     '/aws/service/ami-amazon-linux-latest/al2023-ami-minimal-kernel-default-x86_64'
   ),
@@ -1103,7 +1304,8 @@ containerDistributionConfiguration.addContainerDistributions({
 
 ### Workflow
 
-Workflows define the sequence of steps that Image Builder performs during image creation. There are three workflow types: BUILD (image building), TEST (testing images), and DISTRIBUTION (distributing container images).
+Workflows define the sequence of steps that Image Builder performs during image creation. There are three workflow
+types: BUILD (image building), TEST (testing images), and DISTRIBUTION (distributing container images).
 
 #### Basic Workflow Usage
 
@@ -1264,7 +1466,8 @@ const workflowFromS3 = new imagebuilder.Workflow(this, 'S3Workflow', {
 
 #### Encrypt workflow data with a KMS key
 
-You can encrypt workflow data with a KMS key, so that only principals with access to decrypt with the key are able to access the workflow data.
+You can encrypt workflow data with a KMS key, so that only principals with access to decrypt with the key are able to
+access the workflow data.
 
 ```ts
 const workflow = new imagebuilder.Workflow(this, 'EncryptedWorkflow', {
@@ -1327,7 +1530,9 @@ const distributeContainerWorkflow = imagebuilder.AwsManagedWorkflow.distributeCo
 
 ### Lifecycle Policy
 
-Lifecycle policies help you manage the retention and cleanup of Image Builder resources automatically. These policies define rules for deprecating or deleting old image versions, managing AMI snapshots, and controlling resource costs by removing unused images based on age, count, or other criteria.
+Lifecycle policies help you manage the retention and cleanup of Image Builder resources automatically. These policies
+define rules for deprecating or deleting old image versions, managing AMI snapshots, and controlling resource costs by
+removing unused images based on age, count, or other criteria.
 
 #### Lifecycle Policy Basic Usage
 
@@ -1642,7 +1847,7 @@ const disabledPolicy = new imagebuilder.LifecyclePolicy(this, 'DisabledPolicy',
 
 ##### Importing Lifecycle Policies
 
-Reference lifecycle policies created outside of CDK:
+Reference lifecycle policies created outside CDK:
 
 ```ts
 // Import by name
@@ -1660,5 +1865,5 @@ const importedByArn = imagebuilder.LifecyclePolicy.fromLifecyclePolicyArn(
 );
 
 importedByName.grantRead(lambdaRole);
-importedByArn.grant(lambdaRole, 'imagebuilder:PutLifecyclePolicy');
+importedByArn.grant(lambdaRole, 'imagebuilder:UpdateLifecyclePolicy');
 ```

package/awslint.json

@@ -1,6 +1,7 @@
 {
   "exclude": [
     "props-no-arn-refs:@aws-cdk/aws-imagebuilder-alpha.InfrastructureConfigurationProps.ec2InstanceHostResourceGroupArn",
+    "props-physical-name:@aws-cdk/aws-imagebuilder-alpha.ImageProps",
     "no-unused-type:@aws-cdk/aws-imagebuilder-alpha.ContainerType",
     "no-unused-type:@aws-cdk/aws-imagebuilder-alpha.WorkflowAction",
     "no-unused-type:@aws-cdk/aws-imagebuilder-alpha.WorkflowOnFailure",

package/eslint-suppressions.json

@@ -0,0 +1,2 @@
+{
+}

package/lib/amazon-managed-image.d.ts

@@ -0,0 +1,242 @@
+import { Construct } from 'constructs';
+import { IImage, ImageArchitecture, ImageType } from './image';
+/**
+ * Attributes for importing an Amazon-managed image by name (and optionally a version)
+ */
+export interface AmazonManagedImageAttributes {
+    /**
+     * The name of the Amazon-managed image. The provided name must be normalized by converting all alphabetical
+     * characters to lowercase, and replacing all spaces and underscores with hyphens.
+     */
+    readonly imageName: string;
+    /**
+     * The version of the Amazon-managed image
+     *
+     * @default x.x.x
+     */
+    readonly imageVersion?: string;
+}
+/**
+ * Options for selecting a predefined Amazon-managed image
+ */
+export interface AmazonManagedImageOptions {
+    /**
+     * The architecture of the Amazon-managed image
+     */
+    readonly imageArchitecture: ImageArchitecture;
+    /**
+     * The type of the Amazon-managed image
+     */
+    readonly imageType: ImageType;
+    /**
+     * The version of the Amazon-managed image
+     *
+     * @default x.x.x
+     */
+    readonly imageVersion?: string;
+}
+/**
+ * Helper class for working with Amazon-managed images
+ */
+export declare class AmazonManagedImage {
+    /**
+     * Imports the Amazon Linux 2 Amazon-managed image
+     *
+     * @param scope The construct scope
+     * @param id Identifier of the construct
+     * @param opts The Amazon-managed image attributes
+     *
+     * @see https://docs.aws.amazon.com/linux/al2/ug/index.html
+     * @see https://gallery.ecr.aws/amazonlinux/amazonlinux
+     */
+    static amazonLinux2(scope: Construct, id: string, opts: AmazonManagedImageOptions): IImage;
+    /**
+     * Imports the Amazon Linux 2023 Amazon-managed image
+     *
+     * @param scope The construct scope
+     * @param id Identifier of the construct
+     * @param opts The Amazon-managed image attributes
+     *
+     * @see https://docs.aws.amazon.com/linux/al2023/ug/what-is-amazon-linux.html
+     * @see https://gallery.ecr.aws/amazonlinux/amazonlinux
+     */
+    static amazonLinux2023(scope: Construct, id: string, opts: AmazonManagedImageOptions): IImage;
+    /**
+     * Imports the Red Hat Enterprise Linux 10 Amazon-managed image
+     *
+     * @param scope The construct scope
+     * @param id Identifier of the construct
+     * @param opts The Amazon-managed image attributes
+     *
+     * @see https://aws.amazon.com/partners/redhat/faqs
+     */
+    static redHatEnterpriseLinux10(scope: Construct, id: string, opts: AmazonManagedImageOptions): IImage;
+    /**
+     * Imports the SUSE Linux Enterprise Server 15 Amazon-managed image
+     *
+     * @param scope The construct scope
+     * @param id Identifier of the construct
+     * @param opts The Amazon-managed image attributes
+     *
+     * @see https://aws.amazon.com/linux/commercial-linux/faqs/
+     */
+    static suseLinuxEnterpriseServer15(scope: Construct, id: string, opts: AmazonManagedImageOptions): IImage;
+    /**
+     * Imports the Ubuntu 22.04 Amazon-managed image
+     *
+     * @param scope The construct scope
+     * @param id Identifier of the construct
+     * @param opts The Amazon-managed image attributes
+     *
+     * @see https://documentation.ubuntu.com/aws
+     * @see https://hub.docker.com/_/ubuntu
+     */
+    static ubuntuServer2204(scope: Construct, id: string, opts: AmazonManagedImageOptions): IImage;
+    /**
+     * Imports the Ubuntu 24.04 Amazon-managed image
+     *
+     * @param scope The construct scope
+     * @param id Identifier of the construct
+     * @param opts The Amazon-managed image attributes
+     *
+     * @see https://documentation.ubuntu.com/aws
+     * @see https://hub.docker.com/_/ubuntu
+     */
+    static ubuntuServer2404(scope: Construct, id: string, opts: AmazonManagedImageOptions): IImage;
+    /**
+     * Imports the Windows Server 2016 Core Amazon-managed image
+     *
+     * @param scope The construct scope
+     * @param id Identifier of the construct
+     * @param opts The Amazon-managed image attributes
+     *
+     * @see https://docs.aws.amazon.com/ec2/latest/windows-ami-reference/index.html
+     * @see https://hub.docker.com/r/microsoft/windows-servercore
+     */
+    static windowsServer2016Core(scope: Construct, id: string, opts: AmazonManagedImageOptions): IImage;
+    /**
+     * Imports the Windows Server 2016 Full Amazon-managed image
+     *
+     * @param scope The construct scope
+     * @param id Identifier of the construct
+     * @param opts The Amazon-managed image attributes
+     *
+     * @see https://docs.aws.amazon.com/ec2/latest/windows-ami-reference/index.html
+     */
+    static windowsServer2016Full(scope: Construct, id: string, opts: AmazonManagedImageOptions): IImage;
+    /**
+     * Imports the Windows Server 2019 Core Amazon-managed image
+     *
+     * @param scope The construct scope
+     * @param id Identifier of the construct
+     * @param opts The Amazon-managed image attributes
+     *
+     * @see https://docs.aws.amazon.com/ec2/latest/windows-ami-reference/index.html
+     * @see https://hub.docker.com/r/microsoft/windows-servercore
+     */
+    static windowsServer2019Core(scope: Construct, id: string, opts: AmazonManagedImageOptions): IImage;
+    /**
+     * Imports the Windows Server 2019 Full Amazon-managed image
+     *
+     * @param scope The construct scope
+     * @param id Identifier of the construct
+     * @param opts The Amazon-managed image attributes
+     *
+     * @see https://docs.aws.amazon.com/ec2/latest/windows-ami-reference/index.html
+     */
+    static windowsServer2019Full(scope: Construct, id: string, opts: AmazonManagedImageOptions): IImage;
+    /**
+     * Imports the Windows Server 2022 Core Amazon-managed image
+     *
+     * @param scope The construct scope
+     * @param id Identifier of the construct
+     * @param opts The Amazon-managed image attributes
+     *
+     * @see https://docs.aws.amazon.com/ec2/latest/windows-ami-reference/index.html
+     */
+    static windowsServer2022Core(scope: Construct, id: string, opts: AmazonManagedImageOptions): IImage;
+    /**
+     * Imports the Windows Server 2022 Full Amazon-managed image
+     *
+     * @param scope The construct scope
+     * @param id Identifier of the construct
+     * @param opts The Amazon-managed image attributes
+     *
+     * @see https://docs.aws.amazon.com/ec2/latest/windows-ami-reference/index.html
+     */
+    static windowsServer2022Full(scope: Construct, id: string, opts: AmazonManagedImageOptions): IImage;
+    /**
+     * Imports the Windows Server 2025 Core Amazon-managed image
+     *
+     * @param scope The construct scope
+     * @param id Identifier of the construct
+     * @param opts The Amazon-managed image attributes
+     *
+     * @see https://docs.aws.amazon.com/ec2/latest/windows-ami-reference/index.html
+     */
+    static windowsServer2025Core(scope: Construct, id: string, opts: AmazonManagedImageOptions): IImage;
+    /**
+     * Imports the Windows Server 2025 Full Amazon-managed image
+     *
+     * @param scope The construct scope
+     * @param id Identifier of the construct
+     * @param opts The Amazon-managed image attributes
+     *
+     * @see https://docs.aws.amazon.com/ec2/latest/windows-ami-reference/index.html
+     */
+    static windowsServer2025Full(scope: Construct, id: string, opts: AmazonManagedImageOptions): IImage;
+    /**
+     * Imports the macOS 14 Amazon-managed image
+     *
+     * @param scope The construct scope
+     * @param id Identifier of the construct
+     * @param opts The Amazon-managed image attributes
+     *
+     * @see https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-mac-instances.html
+     */
+    static macOS14(scope: Construct, id: string, opts: AmazonManagedImageOptions): IImage;
+    /**
+     * Imports the macOS 15 Amazon-managed image
+     *
+     * @param scope The construct scope
+     * @param id Identifier of the construct
+     * @param opts The Amazon-managed image attributes
+     *
+     * @see https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-mac-instances.html
+     */
+    static macOS15(scope: Construct, id: string, opts: AmazonManagedImageOptions): IImage;
+    /**
+     * Imports an Amazon-managed image from its attributes
+     *
+     * @param scope The construct scope
+     * @param id Identifier of the construct
+     * @param attrs - The Amazon-managed image attributes
+     */
+    static fromAmazonManagedImageAttributes(scope: Construct, id: string, attrs: AmazonManagedImageAttributes): IImage;
+    /**
+     * Imports an Amazon-managed image from its name
+     *
+     * @param scope The construct scope
+     * @param id Identifier of the construct
+     * @param amazonManagedImageName - The name of the Amazon-managed image
+     */
+    static fromAmazonManagedImageName(scope: Construct, id: string, amazonManagedImageName: string): IImage;
+    private static readonly AMAZON_LINUX_2_CONFIG;
+    private static readonly AMAZON_LINUX_2023_CONFIG;
+    private static readonly RED_HAT_ENTERPRISE_LINUX_10_CONFIG;
+    private static readonly SUSE_LINUX_ENTERPRISE_SERVER_15_CONFIG;
+    private static readonly UBUNTU_SERVER_22_04_CONFIG;
+    private static readonly UBUNTU_SERVER_24_04_CONFIG;
+    private static readonly WINDOWS_SERVER_2016_CORE_CONFIG;
+    private static readonly WINDOWS_SERVER_2016_FULL_CONFIG;
+    private static readonly WINDOWS_SERVER_2019_CORE_CONFIG;
+    private static readonly WINDOWS_SERVER_2019_FULL_CONFIG;
+    private static readonly WINDOWS_SERVER_2022_CORE_CONFIG;
+    private static readonly WINDOWS_SERVER_2022_FULL_CONFIG;
+    private static readonly WINDOWS_SERVER_2025_CORE_CONFIG;
+    private static readonly WINDOWS_SERVER_2025_FULL_CONFIG;
+    private static readonly MACOS_14_CONFIG;
+    private static readonly MACOS_15_CONFIG;
+    private static validatePredefinedManagedImageOptions;
+    private static predefinedManagedImage;
+}