View a markdown version of this page

Mettre à jour une configuration d'infrastructure - EC2 Image Builder

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Mettre à jour une configuration d'infrastructure

Cette section explique comment utiliser la console Image Builder ou imagebuilder les commandes de la ressource de configuration AWS CLI pour mettre à jour une infrastructure. Pour suivre vos ressources, vous pouvez appliquer des balises comme suit. Entrez les balises sous forme de paires clé-valeur.

  • Les balises de ressources attribuent des balises de métadonnées à l'instance Amazon EC2 qu'Image Builder lance pendant le processus de création.

  • Les balises attribuent des balises de métadonnées à la ressource de configuration de l'infrastructure qu'Image Builder crée en sortie.

Console

Vous pouvez modifier les détails de configuration d'infrastructure suivants depuis la console Image Builder :

  • Description de la configuration de votre infrastructure.

  • Le rôle IAM à associer au profil d'instance.

  • AWS infrastructure, y compris le type d'instance et une rubrique SNS pour les notifications.

  • VPC, sous-réseau et groupes de sécurité.

  • Paramètres de résolution des problèmes, notamment l'arrêt de l'instance en cas de panne, la paire de clés pour la connexion et l'emplacement facultatif du compartiment S3 pour les journaux d'instance.

Pour mettre à jour une ressource de configuration d'infrastructure depuis la console Image Builder, procédez comme suit :

Choisissez une configuration d'infrastructure Image Builder existante

  1. Ouvrez la console EC2 Image Builder à https://console.aws.amazon.com/imagebuilder/ l'adresse.

  2. Pour consulter la liste des ressources de configuration de l'infrastructure associées à votre compte, choisissez Configuration de l'infrastructure dans le volet de navigation.

  3. Pour afficher les détails ou modifier une configuration d'infrastructure, cliquez sur le lien Nom de la configuration. Cela ouvre la vue détaillée de la configuration de l'infrastructure.

    Note

    Vous pouvez également cocher la case à côté du nom de la configuration, puis choisir Afficher les détails.

  4. Dans le coin supérieur droit du panneau Détails de l'infrastructure, choisissez Modifier.

  5. Lorsque vous êtes prêt à enregistrer les mises à jour que vous avez apportées à la configuration de votre infrastructure, choisissez Enregistrer les modifications.

AWS CLI

L'exemple suivant montre comment mettre à jour la configuration de l'infrastructure de votre image à l'aide de la update-infrastructure-configuration commande Image Builder du AWS CLI.

  1. Créer un fichier JSON d'entrée CLI

    Dans cet exemple, les paramètres correspondent à ceux de l'exemple de création, sauf que terminateInstanceOnFailure celui-ci est défini surtrue. Après avoir exécuté la update-infrastructure-configuration commande, les pipelines qui utilisent cette configuration d'infrastructure mettent fin à la génération et testent les instances en cas d'échec d'une génération.

    L'exemple suivant définit les champs d'infrastructure courants. Pour exiger des jetons IMDSv2 sur les instances de build et de test, ajoutez un instanceMetadataOptions bloc avec httpTokens set to. required

    Note

    Nous vous recommandons de configurer toutes les instances EC2 qu'Image Builder lance à partir d'une génération de pipeline pour utiliser IMDSv2 afin que les demandes de récupération des métadonnées d'instance nécessitent un en-tête de jeton signé.

    Utilisez un outil d'édition de fichier pour créer un fichier JSON avec les clés illustrées dans l'exemple suivant, ainsi que des valeurs valides pour votre environnement. Cet exemple utilise un fichier nommé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. Utilisez le fichier que vous avez créé comme entrée lorsque vous exécutez la commande suivante.
    aws imagebuilder update-infrastructure-configuration --cli-input-json file://update-infrastructure-configuration.json