CfnImageRecipeMixinProps

class aws_cdk.cfn_property_mixins.aws_imagebuilder.CfnImageRecipeMixinProps(*, additional_instance_configuration=None, ami_tags=None, ami_watermarks=None, block_device_mappings=None, components=None, description=None, name=None, parent_image=None, tags=None, version=None, working_directory=None)

Bases: object

Properties for CfnImageRecipePropsMixin.

Parameters:

additional_instance_configuration (Union[IResolvable, AdditionalInstanceConfigurationProperty, Dict[str, Any], None]) – Before you create a new AMI, Image Builder launches temporary Amazon EC2 instances to build and test your image configuration. Instance configuration adds a layer of control over those instances. You can define settings and add scripts to run when an instance is launched from your AMI.
ami_tags (Union[IResolvable, Mapping[str, str], None]) – Tags that are applied to the AMI that Image Builder creates during the Build phase prior to image distribution.
ami_watermarks (Optional[Sequence[str]]) – The AMI watermark names to attach to the output AMI from this recipe. AMI watermarks are lineage markers that automatically propagate to derivative AMIs when the source AMI is copied or distributed.
block_device_mappings (Union[IResolvable, Sequence[Union[IResolvable, InstanceBlockDeviceMappingProperty, Dict[str, Any]]], None]) – The block device mappings to apply when creating images from this recipe.
components (Union[IResolvable, Sequence[Union[IResolvable, ComponentConfigurationProperty, Dict[str, Any]]], None]) – The components that are included in the image recipe. Recipes require a minimum of one build component, and can have a maximum of 20 build and test components in any combination.
description (Optional[str]) – The description of the image recipe.
name (Optional[str]) – The name of the image recipe.
parent_image (Optional[str]) – The base image for customizations specified in the image recipe. You can specify the parent image using one of the following options: - AMI ID - Image Builder image Amazon Resource Name (ARN) - AWS Systems Manager (SSM) Parameter Store Parameter, prefixed by ssm: , followed by the parameter name or ARN. - AWS Marketplace product ID
tags (Optional[Mapping[str, str]]) – The tags of the image recipe.
version (Optional[str]) – The semantic version of the image recipe. This version follows the semantic version syntax. .. epigraph:: The semantic version has four nodes: ../. You can assign values for the first three, and can filter on all of them. Assignment: For the first three nodes you can assign any positive integer value, including zero, with an upper limit of 2^30-1, or 1073741823 for each node. Image Builder automatically assigns the build number to the fourth node. Patterns: You can use any numeric pattern that adheres to the assignment requirements for the nodes that you can assign. For example, you might choose a software version pattern, such as 1.0.0, or a date, such as 2021.01.01.
working_directory (Optional[str]) – The working directory to be used during build and test workflows.

See:

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-imagebuilder-imagerecipe.html

ExampleMetadata:

fixture=_generated

Example:

# The code below shows an example of how to instantiate this type.
# The values are placeholders you should change.
from aws_cdk.cfn_property_mixins import aws_imagebuilder as imagebuilder

cfn_image_recipe_mixin_props = imagebuilder.CfnImageRecipeMixinProps(
    additional_instance_configuration=imagebuilder.CfnImageRecipePropsMixin.AdditionalInstanceConfigurationProperty(
        systems_manager_agent=imagebuilder.CfnImageRecipePropsMixin.SystemsManagerAgentProperty(
            uninstall_after_build=False
        ),
        user_data_override="userDataOverride"
    ),
    ami_tags={
        "ami_tags_key": "amiTags"
    },
    ami_watermarks=["amiWatermarks"],
    block_device_mappings=[imagebuilder.CfnImageRecipePropsMixin.InstanceBlockDeviceMappingProperty(
        device_name="deviceName",
        ebs=imagebuilder.CfnImageRecipePropsMixin.EbsInstanceBlockDeviceSpecificationProperty(
            delete_on_termination=False,
            encrypted=False,
            iops=123,
            kms_key_id="kmsKeyId",
            snapshot_id="snapshotId",
            throughput=123,
            volume_size=123,
            volume_type="volumeType"
        ),
        no_device="noDevice",
        virtual_name="virtualName"
    )],
    components=[imagebuilder.CfnImageRecipePropsMixin.ComponentConfigurationProperty(
        component_arn="componentArn",
        parameters=[imagebuilder.CfnImageRecipePropsMixin.ComponentParameterProperty(
            name="name",
            value=["value"]
        )]
    )],
    description="description",
    name="name",
    parent_image="parentImage",
    tags={
        "tags_key": "tags"
    },
    version="version",
    working_directory="workingDirectory"
)

Attributes

additional_instance_configuration

Before you create a new AMI, Image Builder launches temporary Amazon EC2 instances to build and test your image configuration.

Instance configuration adds a layer of control over those instances. You can define settings and add scripts to run when an instance is launched from your AMI.

See:: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-imagebuilder-imagerecipe.html#cfn-imagebuilder-imagerecipe-additionalinstanceconfiguration

ami_tags

Tags that are applied to the AMI that Image Builder creates during the Build phase prior to image distribution.

See:: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-imagebuilder-imagerecipe.html#cfn-imagebuilder-imagerecipe-amitags

ami_watermarks

The AMI watermark names to attach to the output AMI from this recipe.

AMI watermarks are lineage markers that automatically propagate to derivative AMIs when the source AMI is copied or distributed.

See:: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-imagebuilder-imagerecipe.html#cfn-imagebuilder-imagerecipe-amiwatermarks

block_device_mappings

The block device mappings to apply when creating images from this recipe.

See:: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-imagebuilder-imagerecipe.html#cfn-imagebuilder-imagerecipe-blockdevicemappings

components

The components that are included in the image recipe.

Recipes require a minimum of one build component, and can have a maximum of 20 build and test components in any combination.

See:: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-imagebuilder-imagerecipe.html#cfn-imagebuilder-imagerecipe-components

description

The description of the image recipe.

See:: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-imagebuilder-imagerecipe.html#cfn-imagebuilder-imagerecipe-description

name

The name of the image recipe.

See:: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-imagebuilder-imagerecipe.html#cfn-imagebuilder-imagerecipe-name

parent_image

The base image for customizations specified in the image recipe.

You can specify the parent image using one of the following options:

AMI ID
Image Builder image Amazon Resource Name (ARN)
AWS Systems Manager (SSM) Parameter Store Parameter, prefixed by ssm: , followed by the parameter name or ARN.
AWS Marketplace product ID

See:: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-imagebuilder-imagerecipe.html#cfn-imagebuilder-imagerecipe-parentimage

tags

The tags of the image recipe.

See:: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-imagebuilder-imagerecipe.html#cfn-imagebuilder-imagerecipe-tags

version

The semantic version of the image recipe. This version follows the semantic version syntax.

The semantic version has four nodes: ../. You can assign values for the first three, and can filter on all of them.

Assignment: For the first three nodes you can assign any positive integer value, including zero, with an upper limit of 2^30-1, or 1073741823 for each node. Image Builder automatically assigns the build number to the fourth node.

Patterns: You can use any numeric pattern that adheres to the assignment requirements for the nodes that you can assign. For example, you might choose a software version pattern, such as 1.0.0, or a date, such as 2021.01.01.

See:: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-imagebuilder-imagerecipe.html#cfn-imagebuilder-imagerecipe-version

working_directory

The working directory to be used during build and test workflows.

See:: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-imagebuilder-imagerecipe.html#cfn-imagebuilder-imagerecipe-workingdirectory