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.
Utiliser l'agent EC2 Launch v1 pour effectuer des tâches lors du lancement de l'instance EC2 Windows
Amazon Managed AMIs pour Windows Server 2016 et 2019 inclut un ensemble de scripts Windows Powershell appelé EC2 Launch. EC2Launch exécute des tâches lors du démarrage initial de l'instance. Pour plus d'informations sur les versions de EC2 lancement incluses dans AWS Windows AMIs, consultez le manuel AWS Windows AMI Reference. Pour consulter les modifications apportées à chaque version de AWS Windows AMIs, consultez l'historique des versions de l'AMI AWS Windows.
Note
Le dernier agent de lancement pour Windows Server 2016 et les versions ultérieures du système d'exploitation est EC2 Launch v2, qui remplace EC2 Config et EC2 Launch. Il est préinstallé sur AWS Windows Server 2016 et 2019 AMIs avec des noms commençant par. EC2LaunchV2-Windows_Server-* Vous pouvez également avec l’outil de migration Migrer vers la EC2Launch version v2 ou vous pouvez installer et configurer manuellement l’agent sur Windows Server 2016 et 2019.
Pour utiliser EC2 Launch avec IMDSv2, la version doit être 1.3.2002730 ou ultérieure.
Vous pouvez utiliser la PowerShell commande Windows suivante pour vérifier la version installée de EC2 Launch.
Test-ModuleManifest -Path "C:\ProgramData\Amazon\EC2-Windows\Launch\Module\Ec2Launch.psd1" | Select Version
EC2Tâches de lancement
EC2Launch exécute les tâches suivantes par défaut lors du démarrage initial de l'instance :
-
Configure un nouveau fond d’écran qui présente les informations relatives à l’instance.
-
Définit le nom de l'ordinateur comme étant l' IPv4 adresse privée de l'instance.
-
Envoie les informations relatives à l'instance à la EC2 console Amazon.
-
Envoie l'empreinte numérique du certificat RDP à la console. EC2
-
Définit un mot de passe aléatoire pour le compte d’administrateur.
-
Ajoute des suffixes DNS.
-
Etend de manière dynamique la partition du système d’exploitation pour inclure l’espace non partitionné.
-
Exécute les données utilisateur (si spécifié). Pour plus d’informations sur la spécification de données utilisateur, consultez Exécuter des commandes lorsque vous lancez une EC2 instance avec saisie de données utilisateur.
-
Définit des itinéraires statiques persistants pour atteindre le service de métadonnées et AWS KMS les serveurs.
Important
Si une AMI personnalisée est créée à partir de cette instance, ces routes sont capturées dans le cadre de la configuration du système d’exploitation et toutes les nouvelles instances lancées à partir de cette AMI conserveront les mêmes routes, quel que soit leur placement sur le sous-réseau. Pour mettre à jour les routes, consultez Mettre à jour les routes des métadonnées/serveurs KMS pour Server 2016 et versions ultérieures lors du lancement d’une AMI personnalisée.
Les tâches suivantes permettent de maintenir la rétrocompatibilité avec le service EC2 Config. Vous pouvez également configurer EC2 Launch pour effectuer les tâches suivantes au démarrage :
-
Initialiser des volumes EBS secondaires.
-
Envoyez les journaux d'événements Windows vers les journaux de EC2 la console.
-
Envoyez le message Windows est prêt à être utilisé à la EC2 console.
EC2Structure du répertoire de lancement
EC2Launch est installé par défaut sur Windows Server 2016 et versions ultérieures AMIs dans le répertoire racineC:\ProgramData\Amazon\EC2-Windows\Launch.
Note
Par défaut, Windows masque les fichiers et les dossiers qui se trouvent sous C:\ProgramData. Pour afficher les répertoires et les fichiers de EC2 lancement, vous devez saisir le chemin dans l'Explorateur Windows ou modifier les propriétés du dossier pour afficher les fichiers et dossiers cachés.
Le répertoire Launch contient les sous-répertoires suivants.
-
Scripts— Contient les PowerShell scripts qui constituent EC2 Launch. -
Module— Contient le module permettant de créer des scripts liés à Amazon EC2. -
Config— Contient les fichiers de configuration de script que vous pouvez personnaliser. -
Sysprep— Contient les ressources Sysprep. -
Settings— Contient une application pour l’interface utilisateur graphique de Sysprep. -
Library— Contient des bibliothèques partagées pour les agents de EC2 lancement. -
Logs— Contient les fichiers journaux générés par des scripts.
Télémétrie
La télémétrie est une information supplémentaire qui permet de mieux AWS comprendre vos besoins, de diagnostiquer les problèmes et de fournir des fonctionnalités pour améliorer votre expérience avec AWS les services.
EC2Lancez la version 1.3.2003498 et collectez ultérieurement des données télémétriques, telles que les métriques d'utilisation et les erreurs. Ces données sont collectées à partir de l' EC2 instance Amazon sur laquelle EC2 Launch s'exécute. Cela inclut tous les appareils Windows AMIs détenus par AWS.
Les types de télémétrie suivants sont collectés par EC2 Launch :
-
Usage information (Informations d’utilisation) : commandes de l’agent, méthode d’installation et fréquence d’exécution planifiée.
-
Errors and diagnostic information (Erreurs et informations de diagnostic) : installation de l’agent et exécution des codes d’erreur.
Exemples de données collectées :
2021/07/15 21:44:12Z: EC2LaunchTelemetry: IsAgentScheduledPerBoot=true
2021/07/15 21:44:12Z: EC2LaunchTelemetry: IsUserDataScheduledPerBoot=true
2021/07/15 21:44:12Z: EC2LaunchTelemetry: AgentCommandCode=1
2021/07/15 21:44:12Z: EC2LaunchTelemetry: AgentCommandErrorCode=5
2021/07/15 21:44:12Z: EC2LaunchTelemetry: AgentInstallCode=2
2021/07/15 21:44:12Z: EC2LaunchTelemetry: AgentInstallErrorCode=0La télémétrie est activée par défaut. Vous pouvez désactiver la collecte de données de télémétrie à tout moment. Si la télémétrie est activée, EC2 Launch envoie des données de télémétrie sans notification supplémentaire au client.
Le choix d’activer ou de désactiver la télémétrie est collecté.
Vous pouvez choisir de vous inscrire ou de vous désinscrire de la collecte de télémétrie. Votre choix est collecté afin de nous assurer que nous le respectons.
Visibilité de la télémétrie
Lorsque la télémétrie est activée, elle apparaît dans la sortie de EC2 la console Amazon comme suit :
2021/07/15 21:44:12Z: Telemetry: <Data>
Désactiver la télémétrie sur une instance
Pour désactiver la télémétrie en paramétrant une variable d’environnement système, exécutez la commande suivante en tant qu’administrateur :
setx /M EC2LAUNCH_TELEMETRY 0
Pour désactiver la télémétrie pendant l’installation, exécutez install.ps1 comme suit :
. .\install.ps1 -EnableTelemetry:$false
Autres sujets pour EC2 Launch
