Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
Administración de recetas en Generador de imágenes
Una receta de EC2 Image Builder es el modelo para crear una imagen de máquina personalizada. Una receta especifica tres elementos clave:
-
Imagen base: el punto de partida de la imagen (una AMI, una imagen de contenedor o una máquina virtual importada).
-
Componentes: los pasos de creación y prueba que personalizan la imagen. Los componentes son opcionales. Este diseño admite flujos de trabajo exclusivos de prueba y distribución.
-
Configuración: los volúmenes de almacenamiento, la configuración de las instancias, el directorio de trabajo y otros parámetros del tiempo de compilación.
Image Builder admite dos tipos de recetas:
-
Las recetas de imágenes producen imágenes de máquina de Amazon (AMI) que puede usar para lanzar instancias de Amazon EC2.
-
Las recetas de contenedores producen imágenes de Docker contenedores almacenadas en los repositorios de Amazon ECR.
Las recetas son inmutables. Después de crear una receta, no puede modificarla ni reemplazarla. Para actualizar los componentes o cualquier otra configuración, debe crear una nueva receta o versión de receta. Image Builder conserva todas las versiones anteriores. Esto le permite rastrear el linaje de las imágenes hasta la receta exacta que produjo cada salida. Siempre puede aplicar etiquetas a sus recetas existentes. Para obtener más información sobre cómo etiquetar los recursos mediante los comandos de Image Builder del AWS CLI, consulte la Etiquetar recursos sección de esta guía.
sugerencia
Puede usar los componentes gestionados por Amazon en sus recetas o puede desarrollar sus propios componentes personalizados. Para obtener más información, consulte Desarrollo de componentes personalizados para su imagen de Generador de imágenes. En el caso de las recetas de imágenes que crean AMI de salida, también puede utilizar productos y componentes de AWS Marketplace imágenes. Para obtener más información sobre la integración con AWS Marketplace los productos, consulteAWS Marketplace integración en Image Builder.
Utilice los temas de esta sección para administrar sus recetas de EC2 Image Builder, lo que incluye enumerar las recetas existentes, ver sus detalles y crear nuevas versiones de recetas.
Contenido
Recetas de imágenes comparadas con recetas de contenedores
En la tabla siguiente se comparan las características de las recetas con imágenes y las recetas con recipientes.
| Característica | Receta de imagen | Receta de contenedor |
|---|---|---|
| Output | AMI | Dockerimagen de contenedor en Amazon ECR |
| Fuentes de imágenes base | ID de AMI, ARN de imagen de Image Builder, parámetro SSM, producto AWS Marketplace | Docker Hubimagen, imagen de Amazon ECR, imagen, ARN de Amazon-managed imagen de Image Builder |
| Dockerfile | No aplicable | Obligatorio (plantilla con variables contextuales) |
| Repositorio de destino | No aplicable | Amazon ECR (obligatorio) |
| Configuración de almacenamiento | Bloquee las asignaciones de dispositivos para la AMI de salida | Bloquee las asignaciones de dispositivos para la instancia de compilación |
| Datos de usuario | Compatible (anula el inicio de nube predeterminado) | No se admite a nivel de receta |
| Control de agentes de Systems Manager | Configurable (desinstalación después de la compilación) | No configurable |
| AWS Marketplace componentes | compatible | No compatible |
| Anulación de plataforma | No aplicable (detectado en la AMI) | Disponible para Amazon ECR e imágenes Docker Hub |
Control de versiones de recetas
<major>Todas las recetas utilizan versiones semánticas en el formato. <minor>. <patch>. Cada nodo de versión acepta valores de 0 a 1.073.741.823 (2^30 - 1).
Puede usar un comodín (x) en una posición para habilitar el incremento automático de versiones. Al crear una receta con una versión comodín, Image Builder x reemplaza la por el siguiente número disponible para esa posición.
| Patrón | Comportamiento | Secuencia de ejemplo |
|---|---|---|
1.0.x |
Incrementa el número de parche | 1.0.1, 1.0.2, 1.0.3,... |
1.x.0 |
Incrementa el número menor | 1.1.0, 1.2.0, 1.3.0,... |
x.0.0 |
Incrementa el número principal | 1.0.0, 2.0.0, 3.0.0,... |
Las siguientes reglas se aplican a las versiones comodín:
-
Solo se permite un
xcomodín por cadena de versión. -
El comodín puede aparecer en cualquier posición (principal, secundaria o parche).
-
Los valores numéricos de las posiciones restantes deben ser enteros explícitos.
sugerencia
Usa versiones comodín en tu CI/CD automatización para no tener que rastrear e incrementar manualmente las versiones de las recetas. Cada vez que creas una receta con el mismo comodín, Image Builder resuelve la siguiente versión disponible. Por ejemplo, una receta que siempre usa se 1.0.x resuelve en 1.0.11.0.2, luego y así sucesivamente. 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.
Restricciones y límites de la receta
Antes de crear una receta, revise las siguientes restricciones.
| Restricción | Límite | Notas |
|---|---|---|
| Componentes por receta | 20 (predeterminado) | Incluye componentes de compilación y de prueba. Puedes solicitar un aumento a través de AWS Support. |
| Tamaño máximo de receta | 25 KB | El tamaño acumulado de todas las configuraciones de componentes, incluidos los valores de los parámetros. |
| Códigos de producto por imagen de salida | 9 | Combinados a partir de la imagen base y AWS Marketplace los componentes. |
| Unicidad de los componentes | Uno por receta | El mismo componente (independientemente de la versión) solo puede aparecer una vez. |
| Número máximo de nodos de versión | 1.073.741.823 | Por nodo (principal, secundario o parche). |
| Nombre de la fórmula | No se puede cambiar | El nombre se fija después de la creación. Crea una receta nueva con un nombre diferente. |
Los componentes también deben cumplir los siguientes requisitos de compatibilidad:
-
Los componentes deben coincidir con la plataforma de la receta (Linux, Windows o macOS).
-
Los componentes deben ser compatibles con la versión del sistema operativo de la imagen principal, cuando los metadatos de la versión del sistema operativo estén disponibles.
-
Los componentes con el
DISABLEDestadoDEPRECATEDo no se pueden agregar a las recetas nuevas. -
Los componentes de refuerzo del CIS requieren una imagen CIS-published principal.
Eliminar recursos
Para evitar cargos inesperados, asegúrese de limpiar los recursos y canalizaciones que haya creado a partir de los ejemplos de esta guía. Para obtener más información sobre cómo eliminar recursos en Generador de Imágenes, consulte Eliminación de recursos de Generador de imágenes obsoletos o no utilizados.
