Crear una configuración de infraestructura

Abra la consola de EC2 Image Builder en https://console.aws.amazon.com/imagebuilder/.

En el panel de navegación, elija Configuración de la infraestructura..

Elija Crear configuración de infraestructura.

En la sección General, introduzca las siguientes casillas obligatorias:

En el panel de AWS infraestructura, configure los ajustes de infraestructura restantes. Introduzca la siguiente información necesaria:

Si no proporcionas valores para las siguientes configuraciones, usarán los valores predeterminados específicos del servicio, cuando corresponda.

En la sección Etiquetas de infraestructura (opcional), puede asignar etiquetas de metadatos a la instancia de Generador de imágenes de Amazon EC2 lanza durante el proceso de compilación. Introduzca las etiquetas como pares clave-valor.

En la sección Etiquetas (opcional), puede asignar etiquetas de metadatos al recurso de configuración de infraestructura que Generador de imágenes crea como salida. Introduzca las etiquetas como pares clave-valor.

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

Los siguientes ejemplos muestran variaciones del archivo JSON que puede crear para la configuración de la infraestructura. Utilice una herramienta de edición de archivos para crear un archivo JSON de su propiedad.

Ejemplo 1: configuración para retener una instancia de una compilación fallida

En este ejemplo se especifican dos tipos de instancias, m7i.large y m7i.xlarge. Te recomendamos que especifiques más de un tipo de instancia, ya que esto permite a Generador de Imágenes lanzar una instancia desde un grupo con capacidad suficiente. Esto puede reducir los errores de compilación transitorios.

instanceProfileName especifica el perfil de instancia que proporciona a la instancia los permisos que el perfil necesita para realizar actividades de personalización. Por ejemplo, si tiene un componente que recupera recursos de Amazon S3, el perfil de instancia requiere permisos para acceder a esos archivos. El perfil de instancia también requiere un conjunto mínimo de permisos para que Generador de Imágenes de EC2 se comunique correctamente con la instancia. Para obtener más información, consulte Preparación para crear imágenes personalizadas con Generador de imágenes.

{
    "name": "ExampleInfraConfigDontTerminate",
    "description": "An example that will retain instances of failed builds",
    "instanceTypes": [
        "m7i.large", "m7i.xlarge"
    ],
    "instanceProfileName": "myIAMInstanceProfileName",
    "securityGroupIds": [
        "sg-12345678"
    ],
    "subnetId": "subnet-12345678",
    "logging": {
        "s3Logs": {
            "s3BucketName": "my-logging-bucket",
            "s3KeyPrefix": "my-path"
        }
    },
    "keyPair": "myKeyPairName",
    "terminateInstanceOnFailure": false,
    "snsTopicArn": "arn:aws:sns:us-west-2:123456789012:MyTopic"
}

Ejemplo 2: configuración de macOS con ubicación automática

En este ejemplo, se especifican los tipos de instancia y la ubicación de una instancia de Mac en la que el host dedicado tiene habilitada la ubicación automática.

{
   "name": "macOSInfraConfigAutoPlacement",
   "description": "An example infrastructure configuration for macOS.",
   "instanceProfileName": "EC2InstanceProfileForImageBuilder",
   "instanceTypes": ["mac1.metal", "mac2.metal"],
   "terminateInstanceOnFailure": false,
   "placement": {
      "tenancy": "host"
   }
}

Ejemplo 3: configuración de macOS con el ID de host especificado

En este ejemplo, se especifica el tipo de instancia y la ubicación de una instancia de Mac que se dirige a un host dedicado específico.

{
   "name": "macOSInfraConfigHostPlacement",
   "description": "An example infrastructure configuration for macOS.",
   "instanceProfileName": "EC2InstanceProfileForImageBuilder",
   "instanceTypes": ["mac2-m1ultra.metal"],
   "terminateInstanceOnFailure": false,
   "placement": {
      "tenancy": "host",
      "hostId" : "h-1234567890abcdef0"
   }
}

Ejemplo 4: VPC personalizada con registros de IMDSv2 y Amazon S3

En este ejemplo, se lanzan instancias en una subred y un grupo de seguridad específicos, se requieren tokens de IMDSv2 y se escriben los registros de las aplicaciones en Amazon S3. Como el ejemplo se establecesubnetId, también se debe establecer. securityGroupIds

{
    "name": "VpcInfraConfigWithLogging",
    "description": "Build in a custom VPC with IMDSv2 and S3 logging",
    "instanceTypes": ["m7i.large", "m8i.large"],
    "instanceProfileName": "EC2InstanceProfileForImageBuilder",
    "subnetId": "subnet-12345678",
    "securityGroupIds": ["sg-12345678"],
    "instanceMetadataOptions": {
        "httpTokens": "required",
        "httpPutResponseHopLimit": 2
    },
    "logging": {
        "s3Logs": {
            "s3BucketName": "my-logging-bucket",
            "s3KeyPrefix": "image-builder-logs"
        }
    },
    "resourceTags": {
        "Project": "golden-ami"
    },
    "terminateInstanceOnFailure": true
}

Ejemplo 5: ubicación de un host dedicado con un grupo de recursos de anfitriones

Este ejemplo se dirige a un grupo de recursos de host en lugar de a un ID de host específico. De tenancy este modohost, puede especificar un ARN del grupo de recursos de host. No especifique también unhostId.

{
    "name": "HostResourceGroupInfraConfig",
    "instanceProfileName": "EC2InstanceProfileForImageBuilder",
    "instanceTypes": ["mac2.metal"],
    "terminateInstanceOnFailure": false,
    "placement": {
        "tenancy": "host",
        "hostResourceGroupArn": "arn:aws:resource-groups:us-west-2:123456789012:group/my-host-group"
    }
}

Utilice el archivo creado como entrada cuando ejecute el siguiente comando.

aws imagebuilder create-infrastructure-configuration --cli-input-json file://create-infrastructure-configuration.json