Skip to content

/AWS1/CL_IMG=>CREATECONTAINERRECIPE()

About CreateContainerRecipe

Creates a new container recipe. Container recipes define how images are configured, tested, and assessed.

Method Signature

IMPORTING

Required arguments:

IV_CONTAINERTYPE TYPE /AWS1/IMGCONTAINERTYPE /AWS1/IMGCONTAINERTYPE

The type of container to create.

IV_NAME TYPE /AWS1/IMGRESOURCENAME /AWS1/IMGRESOURCENAME

The name of the container recipe.

IV_SEMANTICVERSION TYPE /AWS1/IMGVERSIONNUMBER /AWS1/IMGVERSIONNUMBER

The semantic version of the container 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.

IT_COMPONENTS TYPE /AWS1/CL_IMGCOMPONENTCONF=>TT_COMPONENTCONFIGURATIONLIST TT_COMPONENTCONFIGURATIONLIST

Components for build and test 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.

IV_PARENTIMAGE TYPE /AWS1/IMGNONEMPTYSTRING /AWS1/IMGNONEMPTYSTRING

The base image for the container recipe.

IO_TARGETREPOSITORY TYPE REF TO /AWS1/CL_IMGTGTCONTAINERREPO00 /AWS1/CL_IMGTGTCONTAINERREPO00

The destination repository for the container image.

IV_CLIENTTOKEN TYPE /AWS1/IMGCLIENTTOKEN /AWS1/IMGCLIENTTOKEN

Unique, case-sensitive identifier you provide to ensure idempotency of the request. For more information, see Ensuring idempotency in the Amazon EC2 API Reference.

Optional arguments:

IV_DESCRIPTION TYPE /AWS1/IMGNONEMPTYSTRING /AWS1/IMGNONEMPTYSTRING

The description of the container recipe.

IO_INSTANCECONFIGURATION TYPE REF TO /AWS1/CL_IMGINSTANCECONF /AWS1/CL_IMGINSTANCECONF

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

IV_DOCKERFILETEMPLATEDATA TYPE /AWS1/IMGINLINEDOCKERFILETMPL /AWS1/IMGINLINEDOCKERFILETMPL

The Dockerfile template used to build your image as an inline data blob.

IV_DOCKERFILETEMPLATEURI TYPE /AWS1/IMGURI /AWS1/IMGURI

The Amazon S3 URI for the Dockerfile that will be used to build your container image.

IV_PLATFORMOVERRIDE TYPE /AWS1/IMGPLATFORM /AWS1/IMGPLATFORM

Specifies the operating system platform when you use a custom base image.

IV_IMAGEOSVERSIONOVERRIDE TYPE /AWS1/IMGNONEMPTYSTRING /AWS1/IMGNONEMPTYSTRING

Specifies the operating system version for the base image.

IT_TAGS TYPE /AWS1/CL_IMGTAGMAP_W=>TT_TAGMAP TT_TAGMAP

Tags that are attached to the container recipe.

IV_WORKINGDIRECTORY TYPE /AWS1/IMGNONEMPTYSTRING /AWS1/IMGNONEMPTYSTRING

The working directory for use during build and test workflows.

IV_KMSKEYID TYPE /AWS1/IMGNONEMPTYSTRING /AWS1/IMGNONEMPTYSTRING

Identifies which KMS key is used to encrypt the container image.

RETURNING

OO_OUTPUT TYPE REF TO /AWS1/CL_IMGCRECONTAINERRECI01 /AWS1/CL_IMGCRECONTAINERRECI01