View a markdown version of this page

Aggiornare una configurazione dell'infrastruttura - EC2 Image Builder

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Aggiornare una configurazione dell'infrastruttura

Questa sezione spiega come utilizzare la console o imagebuilder i comandi di Image Builder AWS CLI per aggiornare una risorsa di configurazione dell'infrastruttura. Per tenere traccia delle tue risorse, puoi applicare i tag come segue. Inserisci i tag come coppie chiave-valore.

  • I tag di risorsa assegnano tag di metadati all'istanza Amazon EC2 che Image Builder avvia durante il processo di creazione.

  • I tag assegnano tag di metadati alla risorsa di configurazione dell'infrastruttura che Image Builder crea come output.

Console

È possibile modificare i seguenti dettagli di configurazione dell'infrastruttura dalla console di Image Builder:

  • La descrizione della configurazione dell'infrastruttura.

  • Il ruolo IAM da associare al profilo dell'istanza.

  • AWS infrastruttura, incluso il tipo di istanza e un argomento SNS per le notifiche.

  • VPC, sottorete e gruppi di sicurezza.

  • Impostazioni per la risoluzione dei problemi, tra cui Terminate instance in caso di errore, la coppia di chiavi per la connessione e una posizione opzionale del bucket S3 per i log delle istanze.

Per aggiornare una risorsa di configurazione dell'infrastruttura dalla console Image Builder, segui questi passaggi:

Scegli una configurazione dell'infrastruttura di Image Builder esistente

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

  2. Per visualizzare un elenco delle risorse di configurazione dell'infrastruttura disponibili nel tuo account, scegli Configurazione dell'infrastruttura dal pannello di navigazione.

  3. Per visualizzare i dettagli o modificare una configurazione dell'infrastruttura, scegli il link Nome della configurazione. Si apre la vista dettagliata per la configurazione dell'infrastruttura.

    Nota

    Puoi anche selezionare la casella di controllo accanto al nome della configurazione, quindi scegliere Visualizza dettagli.

  4. Dall'angolo in alto a destra del pannello dei dettagli dell'infrastruttura, scegli Modifica.

  5. Quando sei pronto a salvare gli aggiornamenti apportati alla configurazione dell'infrastruttura, scegli Salva modifiche.

AWS CLI

L'esempio seguente mostra come aggiornare la configurazione dell'infrastruttura per l'immagine con il update-infrastructure-configuration comando Image Builder in AWS CLI.

  1. Creazione di un file JSON di input nella CLI

    In questo esempio, le impostazioni corrispondono all'esempio di creazione, tranne che terminateInstanceOnFailure è impostato sutrue. Dopo aver eseguito il update-infrastructure-configuration comando, le pipeline che utilizzano questa configurazione dell'infrastruttura terminano le istanze di compilazione e test quando una compilazione ha esito negativo.

    L'esempio seguente imposta i campi di infrastruttura comuni. Per richiedere i token IMDSv2 nelle istanze di build e test, aggiungi un instanceMetadataOptions blocco con set to. httpTokens required

    Nota

    Ti consigliamo di configurare tutte le istanze EC2 che Image Builder avvia da una build di pipeline per utilizzare IMDSv2 in modo che le richieste di recupero dei metadati delle istanze richiedano un'intestazione del token firmata.

    Usa uno strumento di modifica dei file per creare un file JSON con le chiavi mostrate nell'esempio seguente, più i valori validi per il tuo ambiente. In questo esempio viene utilizzato un file denominato update-infrastructure-configuration.json:

    {
"infrastructureConfigurationArn": "arn:aws:imagebuilder:us-west-2:123456789012:infrastructure-configuration/my-example-infrastructure-configuration",
"description": "An example that will terminate instances of failed builds",
"instanceTypes": [
    "m7i.large", "m7i.2xlarge"
],
"instanceProfileName": "myIAMInstanceProfileName",
"securityGroupIds": [
    "sg-12345678"
],
"subnetId": "subnet-12345678",
"logging": {
    "s3Logs": {
        "s3BucketName": "my-logging-bucket",
        "s3KeyPrefix": "my-path"
    }
},
"terminateInstanceOnFailure": true,
"snsTopicArn": "arn:aws:sns:us-west-2:123456789012:MyTopic"
}
  2. Usa il file che hai creato come input quando esegui il comando seguente.
    aws imagebuilder update-infrastructure-configuration --cli-input-json file://update-infrastructure-configuration.json