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. Se abre la página de creación de recetas con imágenes.

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

   La imagen final puede contener hasta nueve códigos de producto de productos y componentes de AWS Marketplace imágenes. Image Builder muestra un error durante la creación de la receta si la imagen base y los componentes superan este límite.

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 para 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 de Image Builder. Para revisar los parámetros de solicitud de operación de la API, consulte el CreateImageRecipe comando en la referencia de la 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. Puede especificar la imagen principal mediante una de las siguientes opciones:

     • ID de AMI: utilícelo cuando tenga una AMI específica (por ejemploami-1234567890abcdef1) que desee personalizar. Como el ID de AMI es estático, te recomendamos utilizar un ARN de imagen de Image Builder o un parámetro SSM si quieres que tu receta recoja automáticamente las imágenes base más nuevas.

     • ARN, recurso de imágenes de Image Builder: utilízalo cuando quieras crear sobre una imagen de Image Builder. Esto incluye Amazon-managed las imágenes que Image Builder proporciona para los sistemas operativos más populares, así como las imágenes que haya creado anteriormente. Especifique el ARN de la imagen con una versión semántica o utilice un comodín de versión para obtener siempre la versión más reciente.

     • AWS Systems Manager Parámetro del almacén de parámetros (SSM): utilícelo cuando desee que la receta recoja automáticamente los nuevos ID de AMI sin crear una nueva versión de la receta. Añada el prefijo al parámetro conssm:, seguido del nombre del parámetro o ARN. Esto es ideal para las canalizaciones que siempre deben usar la imagen base más reciente de Amazon Linux o Windows.

     • AWS Marketplace ID de producto: utilícelo cuando se suscriba a un producto de AMI AWS Marketplace y desee personalizarlo aún más.

     nota

     • Cuando usas un identificador de AMI o un parámetro de SSM que se convierte en una AMI, debes tener acceso a esa AMI en tu cuenta. La AMI también debe existir en la misma región en la que Image Builder ejecuta la compilación.

     • Los ejemplos de Linux y macOS especifican un ID de AMI y el ejemplo de Windows usa un ARN de imagen de Image Builder.

   • <major>SemanticVersion (cadena, obligatoria): introduzca el número de versión que desea crear en el formato. <minor>. <patch>. Image Builder admite el incremento automático de versiones para las recetas, lo que le permite utilizar patrones comodín en sus versiones de recetas. Al crear una receta con una versión comodín, por ejemplo1.0.x, Image Builder incrementa automáticamente la versión (por ejemplo,,,, 1.0.1 1.0.21.0.3, etc.). Esto elimina la necesidad de rastrear e incrementar manualmente las versiones de las recetas. 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, opcional): contiene una matriz de ComponentConfiguration objetos. Los componentes son opcionales: puede crear recetas sin ningún componente para los flujos de trabajo de prueba o distribució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 utilizar uno de los ejemplos para crear su propia receta de imagen, debe sustituir los ARN de ejemplo por los ARN de los componentes que utiliza en 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 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 predeterminado definido para el componente y no se proporciona ningún otro valor, TOE de AWS utiliza el valor predeterminado.

   • AMIWatermarks (matriz de cadenas, opcional): una lista de nombres de marcas de agua para adjuntar a las AMI de salida creadas a partir de esta receta. Las marcas de agua son marcadores de linaje que ayudan a trazar el historial de las imágenes. Especifique de 1 a 5 nombres. Cada nombre debe tener de 3 a 128 caracteres y puede incluir letras, números, espacios y los siguientes caracteres especiales:( ) [ ] . / - ' @ _. Para obtener más información, consulte Rastrea el linaje de AMI con marcas de agua.

   • adicional InstanceConfiguration (objeto): especifica ajustes adicionales e inicia scripts para tus instancias de compilación.

     • systems ManagerAgent (object): contiene la configuración del agente de Systems Manager en tu instancia de compilación.

       nota

       Las recetas de Windows no admiten la systemsManagerAgent configuración. Si la incluye con una imagen principal de Windows, la solicitud fallará.

       • desinstalar AfterBuild (booleano): 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.

     • usuario DataOverride (cadena): proporciona comandos o un script de comandos para ejecutarlos 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-1234567890abcdef1",
   "semanticVersion": "1.0.0",
   "components": [
   	{
   		"componentArn": "arn:aws:imagebuilder:us-west-2:111122223333: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 en función de los filtros de versión semántica que has 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:111122223333:component/my-example-component/2019.12.02/1"
   	},
   	{
   		"componentArn": "arn:aws:imagebuilder:us-west-2:111122223333: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-1234567890abcdef1",
   "semanticVersion": "1.0.0",
   "components": [
   	{
   		"componentArn": "arn:aws:imagebuilder:us-west-2:111122223333:component/catalina$"
   	}
   ],
   "additionalInstanceConfiguration": {
   	"systemsManagerAgent": {
   	 	"uninstallAfterBuild": true
   	},
   	"userDataOverride": "IyEvYmluL2Jhc2gKbWtkaXIgLXAgL3Zhci9iYi8KdG91Y2ggL3Zhcg=="
   }
   }

   Ejemplo: receta sin componentes

   Puede crear recetas sin ningún componente para probar las AMI existentes o los flujos de trabajo exclusivos de distribución. El siguiente ejemplo muestra una receta que usa una AMI existente sin aplicar ningún componente adicional:

   {
   	"name": "Test Distribution Recipe",
   	"description": "Recipe for testing and distributing existing AMI without modifications.",
   	"parentImage": "ami-1234567890abcdef1",
   	"semanticVersion": "1.0.0",
   	"additionalInstanceConfiguration": {
   		"systemsManagerAgent": {
   		 	"uninstallAfterBuild": true
   		}
   	}
   }

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 nueve códigos de producto de productos y componentes de AWS Marketplace imágenes. Image Builder muestra un error durante la creación de la receta si la imagen base y los componentes superan este límite al ejecutar el create-image-recipe comando.

   El comando devuelve el ARN de la nueva receta de imagen, como se muestra en el siguiente ejemplo de salida.

   {
   	"requestId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
   	"clientToken": "a1b2c3d4-5678-90ab-cdef-EXAMPLE22222",
   	"imageRecipeArn": "arn:aws:imagebuilder:us-west-2:123456789012:image-recipe/my-recipe/1.0.1"
   }

3. Verifica tu receta

   Para confirmar que Image Builder creó la receta según lo previsto, ejecute el get-image-recipe comando con el ARN que arrojó el paso anterior.

   aws imagebuilder get-image-recipe --image-recipe-arn arn:aws:imagebuilder:us-west-2:123456789012:image-recipe/my-recipe/1.0.1

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.