Creación de una nueva versión de una receta de imagen

Para crear una nueva versión de una receta de imagen:

1. En la parte superior de la página de detalles de la receta, seleccione Crear una nueva versión. Esto le llevará a la página Crear receta de imagen.

2. Para crear la nueva versión, realice los cambios y, a continuación, elija Crear receta.

   La imagen final puede contener hasta cuatro códigos de producto de productos y componentes de la AWS Marketplace imagen. Si la imagen base y los componentes seleccionados contienen más de cuatro códigos de producto, Image Builder devolverá un error al intentar crear la receta.

1. Creación de un archivo JSON de entrada de la CLI

   Puede proporcionar todas las entradas para el comando create-image-recipe con parámetros de comando en línea. Sin embargo, el comando resultante puede ser bastante largo. Para simplificar el comando, puede proporcionar en su lugar un archivo JSON que contenga todas las configuraciones de la receta.

   nota

   La convención de nomenclatura de los valores de datos del archivo JSON sigue el patrón que se especifica para los parámetros de solicitud de operación de la API Image Builder. Para revisar los parámetros de la solicitud de operación de la API, consulte el CreateImageRecipecomando en la Referencia de API de EC2 Image Builder.

   Para proporcionar los valores de los datos como parámetros de la línea de comandos, consulte los nombres de los parámetros especificados en la referencia de comandos de la AWS CLI .

   Este es un resumen de los parámetros que especificamos en este ejemplo:

   • Nombre (cadena, obligatorio): nombre de la receta de imagen.

   • Descripción (cadena): descripción de la receta de imagen.

   • parentImage (cadena, obligatorio): imagen que la receta de imagen utiliza como base para su imagen personalizada. El valor puede ser el ARN de la imagen base o un ID de AMI.

     nota

     Los ejemplos de Linux y macOS utilizan una AMI de Generador de imágenes y el ejemplo de Windows utiliza un ARN.

   • semanticVersion (cadena, obligatorio): versión semántica de la receta de imagen expresada en el siguiente formato, con valores numéricos en cada posición para indicar una versión específica: <major>.<minor>.<patch>. Por ejemplo, un valor podría ser 1.0.0. Para obtener más información sobre el control de versiones semántico para los recursos de Generador de Imágenes, consulte Control de versiones semántico en Generador de imágenes.

   • componentes (matriz, obligatorio): contiene una matriz de objetos ComponentConfiguration. Debe especificarse al menos un componente de compilación:

     nota

     Generador de Imágenes instala los componentes en el orden en que se especificaron en la receta. Sin embargo, los componentes de refuerzo del CIS siempre se ejecutan en último lugar para garantizar que las pruebas de referencia se ejecutan con su imagen de salida.

     • componentARN (cadena, obligatorio): el ARN del componente.

       sugerencia

       Para usar uno de los ejemplos para crear su propia receta de imagen, debe reemplazar el ejemplo ARNs ARNs por el de los componentes que está utilizando para su receta.

     • Parámetros (matriz de objetos): contiene una matriz de objetos ComponentParameter. Si se requiere un parámetro de entrada, pero no tiene un valor predeterminado definido en el componente, debe proporcionar un valor. Generador de imágenes no creará la versión de la receta si falta algún parámetro obligatorio y no tiene definido un valor predeterminado.

       importante

       Los parámetros del componente son valores de texto sin formato y se registran en AWS CloudTrail. Le recomendamos que utilice AWS Secrets Manager o el almacén de AWS Systems Manager parámetros para almacenar sus secretos. Para obtener más información sobre Secrets Manager, consulte ¿Qué es Secrets Manager? en la Guía del usuario de AWS Secrets Manager . Para obtener más información acerca del almacén de parámetros de AWS Systems Manager , consulte Almacén de parámetros de AWS Systems Manager en la Guía del usuario de AWS Systems Manager .

       • Nombre (cadena, obligatorio): el nombre del parámetro del componente que se va a establecer.

       • valor (matriz de cadenas, obligatorio): contiene una matriz de cadenas para establecer el valor del parámetro de componente nombrado. Si hay un valor por defecto definido para el componente y no se proporciona ningún otro valor, TOE de AWS utiliza el valor por defecto.

   • additionalInstanceConfiguration(objeto): especifique ajustes adicionales y ejecute scripts para las instancias de compilación.

     • systemsManagerAgent(objeto): contiene la configuración del agente de Systems Manager en la instancia de compilación.

       • uninstallAfterBuild(Boolean): controla si el agente de Systems Manager se elimina de la imagen de compilación final antes de crear la nueva AMI. Si esta opción se establece como true, el agente se elimina de la imagen final. Si la opción se establece como false, entonces se deja al agente activo para que se incluya en la nueva AMI. El valor predeterminado es false.

         nota

         Si el atributo uninstallAfterBuild no está incluido en el archivo JSON y se cumplen las siguientes condiciones, Generador de Imágenes elimina Systems Manager Agent de la imagen final para que no esté disponible en la AMI:

         • El userDataOverride está vacío o se ha omitido del archivo JSON.

         • Generador de Imágenes instaló Systems Manager Agent automáticamente en la instancia de compilación de un sistema operativo que no tenía el agente preinstalado en la imagen base.

     • userDataOverride(cadena): proporciona comandos o un script de comandos para que se ejecuten al lanzar la instancia de compilación.

       nota

       Los datos de usuario siempre están codificados en base 64. Por ejemplo, los siguientes comandos se codifican como IyEvYmluL2Jhc2gKbWtkaXIgLXAgL3Zhci9iYi8KdG91Y2ggL3Zhcg==:

       #!/bin/bash
       mkdir -p /var/bb/
       touch /var

       El ejemplo de Linux utiliza este valor codificado.

   Linux

   La imagen base (propiedad de parentImage) del siguiente ejemplo es una AMI. Cuando utilice una AMI, debe tener acceso a la AMI y la AMI debe estar en la región de origen (la misma región en la que Generador de Imágenes ejecuta el comando). Guarde el archivo como create-image-recipe.json y utilícelo en el comando create-image-recipe.

   {
   "name": "BB Ubuntu Image recipe",
   "description": "Hello World image recipe for Linux.",
   "parentImage": "ami-0a01b234c5de6fabc",
   "semanticVersion": "1.0.0",
   "components": [
   	{
   		"componentArn": "arn:aws:imagebuilder:us-west-2:123456789012:component/bb$"
   	}
   ],
   "additionalInstanceConfiguration": {
   	"systemsManagerAgent": {
   	 	"uninstallAfterBuild": true
   	},
   	"userDataOverride": "IyEvYmluL2Jhc2gKbWtkaXIgLXAgL3Zhci9iYi8KdG91Y2ggL3Zhcg=="
   }
   }

   Windows

   El siguiente ejemplo hace referencia a la última versión de la imagen base completa en inglés de Windows Server 2016. El ARN de este ejemplo hace referencia a la imagen más reciente del SKU en función de los filtros de versión semántica que haya especificado: arn:aws:imagebuilder:us-west-2:aws:image/windows-server-2016-english-full-base-x86/x.x.x.

   {
   "name": "MyBasicRecipe",
   "description": "This example image recipe creates a Windows 2016 image.",
   "parentImage": "arn:aws:imagebuilder:us-west-2:aws:image/windows-server-2016-english-full-base-x86/x.x.x",
   "semanticVersion": "1.0.0",
   "components": [
   	{
   		"componentArn": "arn:aws:imagebuilder:us-west-2:123456789012:component/my-example-component/2019.12.02/1"
   	},
   	{
   		"componentArn": "arn:aws:imagebuilder:us-west-2:123456789012:component/my-imported-component/1.0.0/1"
   	}
   ]
   }

   nota

   Para obtener más información sobre el control de versiones semántico para los recursos de Generador de Imágenes, consulte Control de versiones semántico en Generador de imágenes.

   macOS

   La imagen base (propiedad de parentImage) del siguiente ejemplo es una AMI. Cuando utilice una AMI, debe tener acceso a la AMI y la AMI debe estar en la región de origen (la misma región en la que Generador de Imágenes ejecuta el comando). Guarde el archivo como create-image-recipe.json y utilícelo en el comando create-image-recipe.

   {
   "name": "macOS Catalina Image recipe",
   "description": "Hello World image recipe for macOS.",
   "parentImage": "ami-0a01b234c5de6fabc",
   "semanticVersion": "1.0.0",
   "components": [
   	{
   		"componentArn": "arn:aws:imagebuilder:us-west-2:123456789012:component/catalina$"
   	}
   ],
   "additionalInstanceConfiguration": {
   	"systemsManagerAgent": {
   	 	"uninstallAfterBuild": true
   	},
   	"userDataOverride": "IyEvYmluL2Jhc2gKbWtkaXIgLXAgL3Zhci9iYi8KdG91Y2ggL3Zhcg=="
   }
   }

2. Creación de la receta

   Utilice el siguiente comando para crear la receta. Introduzca el nombre del archivo JSON que creó en el paso anterior en el parámetro --cli-input-json:

   aws imagebuilder create-image-recipe --cli-input-json file://create-image-recipe.json

   nota

   • Debe incluir la notación file:// al principio de la ruta del archivo JSON.

   • La ruta del archivo JSON debe seguir la convención apropiada para el sistema operativo base donde se está ejecutando el comando. Por ejemplo, Windows utiliza la barra diagonal inversa (\) para referirse a la ruta de directorios, mientras que Linux y macOS usan la barra diagonal (/).

   La imagen final puede contener hasta cuatro códigos de producto de productos y componentes de la AWS Marketplace imagen. Si la imagen base y los componentes seleccionados contienen más de cuatro códigos de producto, Image Builder devuelve un error al ejecutar el create-image-recipe comando.

1. En la sección Seleccionar imagen para la imagen base, seleccione la opción Importar imagen base.

2. Elija el sistema operativo (SO) de la imagen y la versión del SO como lo haría normalmente.

1. Origen: puede ser un bucket de S3 o una instantánea de EBS.

2. Seleccione la ubicación S3 del disco: introduzca la ubicación en Amazon S3 en la que se almacenan las imágenes del disco. Para buscar la ubicación, elija Examinar S3.

3. Para agregar un contenedor de discos, elija Agregar contenedor de disco.

General

1. Especifique un nombre único para la imagen base. Si no introduce ningún valor, la imagen base hereda el nombre de la receta.

2. Especifique una versión para la imagen base. Use el siguiente formato: <major>.<minor>.<patch>. Si no introduce un valor, la imagen base hereda la versión de la receta.

3. También puede introducir una descripción para la imagen base.