Struct ContainerRecipe

#[non_exhaustive]
pub struct ContainerRecipe {

    pub arn: Option<String>,
    pub container_type: Option<ContainerType>,
    pub name: Option<String>,
    pub description: Option<String>,
    pub platform: Option<Platform>,
    pub owner: Option<String>,
    pub version: Option<String>,
    pub components: Option<Vec<ComponentConfiguration>>,
    pub instance_configuration: Option<InstanceConfiguration>,
    pub dockerfile_template_data: Option<String>,
    pub kms_key_id: Option<String>,
    pub encrypted: Option<bool>,
    pub parent_image: Option<String>,
    pub date_created: Option<String>,
    pub tags: Option<HashMap<String, String>>,
    pub working_directory: Option<String>,
    pub target_repository: Option<TargetContainerRepository>,
}

A container recipe.

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

arn: Option<String>

The Amazon Resource Name (ARN) of the container recipe.

Semantic versioning is included in each object's Amazon Resource Name (ARN), at the level that applies to that object as follows:

1. Versionless ARNs and Name ARNs do not include specific values in any of the nodes. The nodes are either left off entirely, or they are specified as wildcards, for example: x.x.x.

2. Version ARNs have only the first three nodes: . .

3. Build version ARNs have all four nodes, and point to a specific build for a specific version of an object.

container_type: Option<ContainerType>

Specifies the type of container, such as Docker.

name: Option<String>

The name of the container recipe.

description: Option<String>

The description of the container recipe.

platform: Option<Platform>

The system platform for the container, such as Windows or Linux.

owner: Option<String>

The owner of the container recipe.

version: Option<String>

The semantic version of the container recipe.

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.

Filtering: With semantic versioning, you have the flexibility to use wildcards (x) to specify the most recent versions or nodes when selecting the base image or components for your recipe. When you use a wildcard in any node, all nodes to the right of the first wildcard must also be wildcards.

components: Option<Vec<ComponentConfiguration>>

Build and test components that are included in the container recipe. Recipes require a minimum of one build component, and can have a maximum of 20 build and test components in any combination.

instance_configuration: Option<InstanceConfiguration>

A group of options that can be used to configure an instance for building and testing container images.

dockerfile_template_data: Option<String>

Dockerfiles are text documents that are used to build Docker containers, and ensure that they contain all of the elements required by the application running inside. The template data consists of contextual variables where Image Builder places build information or scripts, based on your container image recipe.

kms_key_id: Option<String>

Identifies which KMS key is used to encrypt the container image for distribution to the target Region.

encrypted: Option<bool>

A flag that indicates if the target container is encrypted.

parent_image: Option<String>

The base image for customizations specified in the container recipe. This can contain an Image Builder image resource ARN or a container image URI, for example amazonlinux:latest.

date_created: Option<String>

The date when this container recipe was created.

tags: Option<HashMap<String, String>>

Tags that are attached to the container recipe.

working_directory: Option<String>

The working directory for use during build and test workflows.

target_repository: Option<TargetContainerRepository>

The destination repository for the container image.

Implementations

impl ContainerRecipe

pub fn arn(&self) -> Option<&str>

The Amazon Resource Name (ARN) of the container recipe.

Semantic versioning is included in each object's Amazon Resource Name (ARN), at the level that applies to that object as follows:

1. Versionless ARNs and Name ARNs do not include specific values in any of the nodes. The nodes are either left off entirely, or they are specified as wildcards, for example: x.x.x.

2. Version ARNs have only the first three nodes: . .

3. Build version ARNs have all four nodes, and point to a specific build for a specific version of an object.

pub fn container_type(&self) -> Option<&ContainerType>

Specifies the type of container, such as Docker.

pub fn name(&self) -> Option<&str>

The name of the container recipe.

pub fn description(&self) -> Option<&str>

The description of the container recipe.

pub fn platform(&self) -> Option<&Platform>

The system platform for the container, such as Windows or Linux.

pub fn owner(&self) -> Option<&str>

The owner of the container recipe.

pub fn version(&self) -> Option<&str>

The semantic version of the container recipe.

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.

Filtering: With semantic versioning, you have the flexibility to use wildcards (x) to specify the most recent versions or nodes when selecting the base image or components for your recipe. When you use a wildcard in any node, all nodes to the right of the first wildcard must also be wildcards.

pub fn components(&self) -> &[ComponentConfiguration]

Build and test components that are included in the container recipe. Recipes require a minimum of one build component, and can have a maximum of 20 build and test components in any combination.

If no value was sent for this field, a default will be set. If you want to determine if no value was sent, use .components.is_none().

pub fn instance_configuration(&self) -> Option<&InstanceConfiguration>

A group of options that can be used to configure an instance for building and testing container images.

pub fn dockerfile_template_data(&self) -> Option<&str>

Dockerfiles are text documents that are used to build Docker containers, and ensure that they contain all of the elements required by the application running inside. The template data consists of contextual variables where Image Builder places build information or scripts, based on your container image recipe.

pub fn kms_key_id(&self) -> Option<&str>

Identifies which KMS key is used to encrypt the container image for distribution to the target Region.

pub fn encrypted(&self) -> Option<bool>

A flag that indicates if the target container is encrypted.

pub fn parent_image(&self) -> Option<&str>

The base image for customizations specified in the container recipe. This can contain an Image Builder image resource ARN or a container image URI, for example amazonlinux:latest.

pub fn date_created(&self) -> Option<&str>

The date when this container recipe was created.

pub fn tags(&self) -> Option<&HashMap<String, String>>

Tags that are attached to the container recipe.

pub fn working_directory(&self) -> Option<&str>

The working directory for use during build and test workflows.

pub fn target_repository(&self) -> Option<&TargetContainerRepository>

The destination repository for the container image.

impl ContainerRecipe

pub fn builder() -> ContainerRecipeBuilder

Creates a new builder-style object to manufacture ContainerRecipe.

Trait Implementations

impl Clone for ContainerRecipe

fn clone(&self) -> ContainerRecipe

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for ContainerRecipe

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl PartialEq for ContainerRecipe

fn eq(&self, other: &ContainerRecipe) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl StructuralPartialEq for ContainerRecipe