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.

Installez la dernière version de EC2Launch v2

Vous pouvez utiliser l'une des méthodes suivantes pour installer l'agent EC2Launch v2 sur votre EC2 instance :

Pour les étapes d’installation, sélectionnez l’onglet correspondant à votre méthode préférée.

Windows PowerShell

Pour installer la dernière version de l'agent EC2Launch v2 sous Windows PowerShell, procédez comme suit.

1. Créez votre répertoire local.

   New-Item -Path "$env:USERPROFILE\Desktop\EC2Launchv2" -ItemType Directory

2. Définissez l'emplacement URL de votre téléchargement. Exécutez la commande suivante avec l'Amazon S3 URL que vous allez utiliser. Pour le téléchargementURLs, voir EC2Launchtéléchargements de la version 2 sur Amazon S3

   $Url = "Amazon S3 URL/AmazonEC2Launch.msi"

3. Utilisation de la commande combinée suivante pour télécharger et installer l’agent

   $DownloadFile = "$env:USERPROFILE\Desktop\EC2Launchv2\" + $(Split-Path -Path $Url -Leaf)
   Invoke-WebRequest -Uri $Url -OutFile $DownloadFile
   msiexec /i "$DownloadFile"

   Note

   Si un message d'erreur s'affiche lors du téléchargement du fichier et que vous utilisez Windows Server 2016 ou une version antérieure, il est possible que la version TLS 1.2 doive être activée sur votre PowerShell terminal. Vous pouvez activer la TLS version 1.2 pour la PowerShell session en cours à l'aide de la commande suivante, puis réessayer :

   [Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12

4. La msiexec commande installe la EC2Launch v2 à l'emplacement suivant sur les instances Windows Server :%ProgramFiles%\Amazon\EC2Launch. Pour vérifier que l'installation a été exécutée, vous pouvez vérifier le système de fichiers local de votre instance.

AWS Systems Manager Distributor

Pour configurer les mises à jour automatiques pour la EC2Launch version 2 avec AWS Systems Manager Configuration rapide, voirInstallation et mise à jour automatiques avec le programme de configuration rapide du distributeur.

Vous pouvez également effectuer une installation unique du AWSEC2Launch-Agent package à partir de AWS Systems Manager Distributeur. Pour obtenir des instructions sur l'installation d'un package depuis Systems Manager Distributor, voir Installer ou mettre à jour des packages dans le AWS Systems Manager Guide de l'utilisateur.

EC2 Image Builder component

Vous pouvez installer le ec2launch-v2-windows composant lorsque vous créez une image personnalisée avec EC2 Image Builder. Pour obtenir des instructions sur la création d'une image personnalisée avec EC2 Image Builder, voir Création d'un pipeline d'images à l'aide de l'assistant de console EC2 Image Builder dans le guide de l'utilisateur d'EC2Image Builder.

AMI

EC2LaunchLa v2 est préinstallée par défaut sur les systèmes Windows Server 2022 suivants et UEFI AMIs :

• Windows_Server-2022-English-Full-Base

• Windows_Server-2022-English-Core-Base

• Windows Server 2022 AMIs avec toutes les autres langues

• Windows Server 2022 AMIs avec SQL installation

• Windows_Server-2_English-Core- _Optimisé EKS

EC2LaunchLa v2 est également préinstallée sur le serveur AMIs Windows suivant. Vous pouvez les trouver sur AMIs la EC2 console Amazon ou en utilisant le préfixe de recherche suivant : EC2LaunchV2- dans le AWS CLI.

• EC2LaunchV2-Windows_Server-2019-Anglais-Core-Base

• EC2LaunchV2-Windows_Server-2019-Anglais-Base complète

• EC2LaunchV2-Windows_Server-2016-Anglais-Core-Base

• EC2LaunchV2-Windows_Server-2016-Anglais-Base complète

• EC2LaunchV2-Windows_Server-2012_R2_ -Anglais-Base complète RTM

• EC2LaunchV2-Windows_Server-2012_ -Anglais-Base complète RTM

Installez et mettez à jour automatiquement la EC2Launch v2 avec AWS Systems Manager Configuration rapide du distributeur

Avec AWS Systems Manager Configuration rapide du distributeur, vous pouvez configurer des mises à jour automatiques pour la EC2Launch v2. Le processus suivant permet de configurer une association Systems Manager sur votre instance qui met automatiquement à jour l'agent EC2Launch v2 à une fréquence que vous spécifiez. L'association créée par le programme de configuration rapide du distributeur peut inclure des instances au sein d'un Compte AWS et une région, ou des instances au sein d'un AWS Organisation. Pour plus d'informations sur la configuration d'une organisation, voir Tutoriel : Création et configuration d'une organisation dans le AWS Organizations Guide de l'utilisateur.

Avant de commencer, assurez-vous que vos instances répondent à tous les prérequis.

Prérequis

Pour configurer les mises à jour automatiques avec Distributor Quick Setup, vos instances doivent répondre aux conditions préalables suivantes.

Configurer la configuration rapide du distributeur pour la EC2Launch version 2

Pour créer une configuration pour la EC2Launch version 2 à l'aide de la configuration rapide du distributeur, utilisez les paramètres suivants lorsque vous terminez les étapes du déploiement du package du distributeur :

Pour vérifier l'état de votre configuration, accédez à l'onglet Configurations de configuration rapide de Systems Manager dans le AWS Management Console.

Pour plus d'informations et pour connaître les étapes de résolution des problèmes, consultez la section Résolution des problèmes liés aux résultats de la configuration rapide dans le AWS Systems Manager Guide de l'utilisateur.

EC2Launchtéléchargements de la version 2 sur Amazon S3

Pour installer la dernière version de EC2Launch v2, téléchargez le programme d'installation depuis l'un des emplacements suivants :

Configuration des options d’installation

Lorsque vous installez ou mettez à niveau la version EC2Launch v2, vous pouvez configurer les options d'installation à l'aide de la boîte de dialogue d'installation de la EC2Launch version 2 ou à l'aide de la msiexec commande dans un interpréteur de ligne de commande.

La première fois que le programme d'EC2Launchinstallation de la version 2 s'exécute sur une instance, il initialise les paramètres de l'agent de lancement sur votre instance comme suit :

Pour les détails de configuration, sélectionnez l’onglet correspondant à la méthode de configuration que vous allez utiliser.

Amazon EC2Launch Setup dialog

Lorsque vous installez ou mettez à niveau la version EC2Launch v2, vous pouvez configurer les options d'installation suivantes via la boîte de dialogue d'installation de la EC2Launch v2.

Options d’installation de base

Envoyer des données de télémétrie

Lorsque vous incluez cette fonctionnalité dans la boîte de dialogue de configuration, le programme d’installation définit la variable d’environnement EC2LAUNCH_TELEMETRY sur une valeur de 1. Si vous désactivez Envoyer des données de télémétrie, le programme d’installation définit la valeur de la variable d’environnement sur 0.

Lorsque l'agent EC2Launch v2 s'exécute, il lit la variable d'EC2LAUNCH_TELEMETRYenvironnement pour déterminer s'il convient de télécharger des données de télémétrie. Si la valeur est égale à 1, il charge les données. Dans le cas contraire, il ne les charge pas.

Configuration par défaut

La configuration par défaut pour la EC2Launch v2 consiste à remplacer l'agent de lancement local s'il existe déjà. La première fois que vous exécutez une installation sur une instance, la configuration par défaut effectue une installation propre. Si vous désactivez la configuration par défaut lors de l’installation initiale, l’installation échoue.

Si vous réexécutez l’installation sur l’instance, vous pouvez désactiver la configuration par défaut afin d’effectuer une mise à niveau qui ne remplace pas le fichier %ProgramData%/Amazon/EC2Launch/config/agent-config.yml.

Exemple : mise à niveau de la EC2Launch v2 avec la télémétrie

L'exemple suivant montre la boîte de dialogue EC2Launch de configuration de la version 2 configurée pour mettre à niveau l'installation actuelle et activer la télémétrie. Cette configuration effectue une installation sans remplacer le fichier de configuration de l’agent et définit la valeur de la variable d’environnement EC2LAUNCH_TELEMETRY sur 1.

Command line

Lorsque vous installez ou mettez à niveau la version EC2Launch v2, vous pouvez configurer les options d'installation suivantes à l'aide de la msiexec commande dans un shell de ligne de commande.

Valeurs de paramètres ADDLOCAL

De base (obligatoire)

Installez l’agent de lancement. Si cette valeur n’est pas présente dans le paramètre ADDLOCAL, l’installation se termine.

Propre

Lorsque vous incluez la valeur Clean dans le paramètre ADDLOCAL, le programme d’installation écrit le fichier de configuration de l’agent à l’emplacement suivant : %ProgramData%/Amazon/EC2Launch/config/agent-config.yml. Si le fichier de configuration de l’agent existe déjà, il le remplace.

Lorsque vous enlevez la valeur Clean du paramètre ADDLOCAL, le programme d’installation effectue une mise à niveau qui ne remplace pas le fichier de configuration de l’agent.

Télémétrie

Lorsque vous incluez la valeur Telemetry dans le paramètre ADDLOCAL, le programme d’installation définit la valeur de la variable d’environnement EC2LAUNCH_TELEMETRY sur 1.

Lorsque vous enlevez la valeur Telemetry du paramètre ADDLOCAL, le programme d’installation définit la valeur de la variable d’environnement sur 0.

Lorsque l'agent EC2Launch v2 s'exécute, il lit la variable d'EC2LAUNCH_TELEMETRYenvironnement pour déterminer s'il convient de télécharger des données de télémétrie. Si la valeur est égale à 1, il charge les données. Dans le cas contraire, il ne les charge pas.

Exemple : installation de la EC2Launch v2 avec télémétrie

& msiexec /i "C:\Users\Administrator\Desktop\EC2Launchv2\AmazonEC2Launch.msi" ADDLOCAL="Basic,Clean,Telemetry" /q

Vérifiez la version EC2Launch v2

Utilisez l'une des procédures suivantes pour vérifier la version de EC2Launch v2 installée sur vos instances.

Windows PowerShell

Vérifiez la version installée de EC2Launch v2 avec Windows PowerShell, comme suit.

1. Lancez une instance depuis votre AMI ordinateur et connectez-vous à celle-ci.

2. Exécutez la commande suivante PowerShell pour vérifier la version installée de la EC2Launch v2 :

   & "C:\Program Files\Amazon\EC2Launch\EC2Launch.exe" version

Windows Control Panel

Vérifiez la version installée de EC2Launch v2 dans le panneau de configuration Windows, comme suit.

1. Lancez une instance depuis votre AMI ordinateur et connectez-vous à celle-ci.

2. Ouvrez le panneau de configuration Windows, puis choisissez Programmes et fonctionnalités.

3. Recherchez Amazon EC2Launch dans la liste des programmes installés. Son numéro de version s’affiche dans la colonne Version.

Pour consulter les dernières mises à jour concernant AWS WindowsAMIs, consultez l'historique des AMI versions de Windows dans le AWS AMIRéférence Windows.

Pour la dernière version de la EC2Launch v2, voirEC2Launchhistorique des versions v2.

Pour obtenir la dernière version de l'outil de migration EC2Launch v2, consultezEC2Launchhistorique des versions de l'outil de migration v2.

Vous pouvez recevoir des notifications lorsque de nouvelles versions du service EC2Launch v2 sont publiées. Pour de plus amples informations, veuillez consulter Abonnez-vous aux notifications de l'agent de lancement EC2 Windows.