Creazione di una configurazione dell'infrastruttura

Apri la console EC2 Image Builder all'indirizzo https://console.aws.amazon.com/imagebuilder/.

Dal pannello di navigazione, scegli Configurazione dell'infrastruttura.

Scegli Crea configurazione dell'infrastruttura.

Nella sezione Generale, inserisci le seguenti informazioni obbligatorie:

Nel pannello dell'AWS infrastruttura, configura le restanti impostazioni dell'infrastruttura. Immetti le seguenti informazioni necessarie:

Se non si forniscono valori per le seguenti impostazioni, vengono utilizzate le impostazioni predefinite specifiche del servizio, ove applicabile.

Nella sezione Tag di infrastruttura (opzionale), puoi assegnare tag di metadati all'istanza Amazon EC2 che Image Builder avvia durante il processo di compilazione. Inserisci i tag come coppie chiave-valore.

Nella sezione Tag (opzionale), puoi assegnare tag di metadati alla risorsa di configurazione dell'infrastruttura creata da Image Builder come output. Inserisci i tag come coppie chiave-valore.

Creazione di un file JSON di input nella CLI

Gli esempi seguenti mostrano le varianti del file JSON che è possibile creare per la configurazione dell'infrastruttura. Utilizzate uno strumento di modifica dei file per creare un file JSON personalizzato.

Esempio 1: configurazione per conservare un'istanza di una build fallita

Questo esempio specifica due tipi di istanza m7i.large em7i.xlarge. Si consiglia di specificare più di un tipo di istanza perché ciò consente a Image Builder di avviare un'istanza da un pool con capacità sufficiente. Questo può ridurre gli errori transitori di compilazione.

instanceProfileNameSpecifica il profilo dell'istanza che fornisce all'istanza le autorizzazioni richieste dal profilo per eseguire le attività di personalizzazione. Ad esempio, se disponi di un componente che recupera risorse da Amazon S3, il profilo dell'istanza richiede le autorizzazioni per accedere a tali file. Il profilo dell'istanza richiede anche un set minimo di autorizzazioni affinché EC2 Image Builder possa comunicare correttamente con l'istanza. Per ulteriori informazioni, consulta Preparati per creare immagini personalizzate con Image Builder.

{
    "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"
}

Esempio 2: configurazione macOS con posizionamento automatico

Questo esempio specifica i tipi e la posizione di un'istanza Mac in cui l'host dedicato ha il posizionamento automatico abilitato.

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

Esempio 3: configurazione macOS con l'ID host specificato

Questo esempio specifica il tipo e la posizione di un'istanza Mac destinata a un host dedicato specifico.

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

Esempio 4: VPC personalizzato con registrazione IMDSv2 e Amazon S3

Questo esempio avvia istanze in una sottorete e un gruppo di sicurezza specifici, richiede token IMDSv2 e scrive i log delle applicazioni su Amazon S3. Poiché l'esempio imposta, deve anche essere impostato. subnetId 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
}

Esempio 5: posizionamento di un host dedicato con un gruppo di risorse host

Questo esempio si rivolge a un gruppo di risorse host anziché a un ID host specifico. Per questo motivohost, tenancy è possibile specificare un ARN del gruppo di risorse host. Non specificare anche 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"
    }
}

Usa il file che hai creato come input quando esegui il seguente comando.

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