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.

Installer la version la plus récente d’EC2Launch v2

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

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

PowerShell

Pour installer la dernière version de l’agent EC2Launch v2 avec 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’URL de votre emplacement de téléchargement. Exécutez la commande suivante avec l’URL Amazon S3 que vous allez utiliser. Pour les URL de téléchargement, veuillez consulter la rubrique Téléchargements d’EC2Launch v2 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 vous recevez une erreur lors du téléchargement du fichier et que vous utilisez Windows Server 2016 ou une version antérieure, il se peut que TLS 1.2 doive être activé pour votre terminal PowerShell. Vous pouvez activer TLS 1.2 pour la session PowerShell en cours à l'aide de la commande suivante, puis réessayer :

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

4. La commande msiexec installe EC2Launch v2 à l'emplacement suivant sur les instances Windows Server : %ProgramFiles%\Amazon\EC2Launch. Pour vérifier que l'installation s'est bien déroulé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 EC2Launch v2 avec AWS Systems Manager Configuration rapide, consultez Installez et mettez à jour automatiquement avec la configuration rapide du distributeur.

Vous pouvez également procéder à une installation unique du AWSEC2Launch-Agent package depuis le AWS Systems Manager distributeur. Pour obtenir des instructions sur l’installation d’un package à partir d’un distributeur Systems Manager, veuillez consulter la rubrique Installer ou mettre à jour des packages dans le Guide de l’utilisateur AWS Systems Manager.

EC2 Image Builder component

Vous pouvez installer le composant ec2launch-v2-windows 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, consultez Création d’un pipeline d’images à l’aide de l’assistant de la console EC2 Image Builder dans le Guide de l’utilisateur EC2 Image Builder.

AMI

EC2Launch v2 est préinstallé par défaut sur les AMI pour les systèmes d'exploitation Windows Server 2022 et supérieurs :

• Windows_Server-version-Française-Full-Base

• Windows_Server-version-Française-Core-Base

• Windows_Server-version-Française-Core-EKS_Optimized

• Les AMI de la version Windows Server dans toutes les autres langues

• Les AMI de la version Windows Server avec SQL installé

EC2Launch v2 est également préinstallé sur les AMI Windows Server suivants. Vous pouvez trouver ces AMI à partir de la console Amazon EC2, ou en utilisant le préfixe de recherche suivant : EC2LaunchV2- dans l’AWS CLI.

• EC2LaunchV2-Windows_Server-2019-English-Core-Base

• EC2LaunchV2-Windows_Server-2019-English-Full-Base

• EC2LaunchV2-Windows_Server-2016-English-Core-Base

• EC2LaunchV2-Windows_Server-2016-English-Full-Base

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

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

Avant de commencer, assurez-vous que vos instances remplissent toutes les conditions requises.

Prérequis

Pour configurer les mises à jour automatiques avec la configuration rapide du distributeur, vos instances doivent remplir les conditions préalables suivantes.

Configurez la configuration rapide du distributeur pour EC2Launch v2

Pour créer une configuration pour EC2Launch v2 avec la configuration rapide du distributeur, utilisez les paramètres suivants lorsque vous effectuez les étapes de déploiement du package du distributeur :

Pour vérifier l'état de votre configuration, accédez à l'onglet Configurations de la configuration rapide du gestionnaire de systèmes dans l'onglet AWS Management Console.

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

Téléchargements d’EC2Launch v2 sur Amazon S3

Pour installer la dernière version d’EC2Launch v2, téléchargez le programme d’installation à partir des emplacements suivants :

Configuration des options d’installation

Lorsque vous installez ou mettez à niveau EC2Launch v2, vous pouvez configurer les options d’installation à l’aide de la boîte de dialogue d’installation d’EC2Launch v2 ou de la commande msiexec dans un shell de ligne de commande.

La première fois que le programme d’installation d’EC2Launch v2 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 EC2Launch v2, vous pouvez configurer les options d’installation suivantes à l’aide de la boîte de dialogue d’installation d’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’environnement EC2LAUNCH_TELEMETRY pour déterminer si les données de télémétrie doivent être chargées. 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 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 d’EC2Launch v2 grâce à la télémétrie

L’exemple suivant montre la boîte de dialogue de configuration d’EC2Launch v2 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 EC2Launch v2, vous pouvez configurer les options d’installation suivantes avec la commande msiexec 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’environnement EC2LAUNCH_TELEMETRY pour déterminer si les données de télémétrie doivent être chargées. Si la valeur est égale à 1, il charge les données. Dans le cas contraire, il ne les charge pas.

Exemple : installation d’EC2Launch v2 avec télémétrie

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

Vérification de la version d’EC2Launch v2

Utilisez l’une des procédures suivantes pour vérifier quelle version d’EC2Launch v2 est installée sur vos instances.

PowerShell

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

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

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

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

Windows Control Panel

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

1. Lancez une instance depuis votre AMI 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 afficher les dernières mises à jour des AMI AWS Windows, consultez l'historique des versions des AMI Windows dans la Référence AMI WindowsAWS.

Pour obtenir la version la plus récente d’EC2Launch v2, consultez EC2Historique des versions de Launch v2.

Vous pouvez recevoir des notifications en cas de publication de nouvelles versions du service EC2Launch v2. Pour de plus amples informations, consultez S’abonner aux notifications de l’agent de lancement EC2 Windows.