Utiliser l'agent EC2Launch v1 pour effectuer des tâches lors du lancement de l'instance EC2 Windows - Amazon Elastic Compute Cloud
EC2LaunchtâchesStructure de répertoire EC2LaunchTélémétrie

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 EC2Launch v1 pour effectuer des tâches lors du lancement de l'instance EC2 Windows

EC2Launchest un ensemble de PowerShell scripts Windows qui a remplacé le EC2Config service sur Windows Server 2016 et 2019AMIs. Beaucoup d'entre eux AMIs sont toujours disponibles. EC2Launchv2 est le dernier agent de lancement pour toutes les versions de Windows prises en charge, qui remplace à la fois EC2Config etEC2Launch. Pour de plus amples informations, veuillez consulter Utiliser l'agent EC2Launch v2 pour effectuer des tâches lors du lancement de l'instance EC2 Windows.

Note

Pour être utilisée EC2Launch avecIMDSv2, 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 deEC2Launch.

Test-ModuleManifest -Path "C:\ProgramData\Amazon\EC2-Windows\Launch\Module\Ec2Launch.psd1" | Select Version

EC2Launchtâches

EC2Launchexé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'IPv4adresse privée de l'instance.

  • Envoie les informations de l'instance à la EC2 console Amazon.

  • Envoie l'empreinte numérique du RDP certificat à la EC2 console.

  • Définit un mot de passe aléatoire pour le compte d’administrateur.

  • Ajoute des DNS suffixes.

  • 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 configuration personnalisée AMI 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 instance AMI conserveront les mêmes routes, quel que soit l'emplacement du sous-réseau. Pour mettre à jour les routes, consultez Mettre à jour les KMS métadonnées/routes pour Server 2016 et versions ultérieures lors du lancement d'une version personnalisée AMI.

Les tâches suivantes permettent de maintenir la rétrocompatibilité avec le EC2Config service. Vous pouvez également configurer EC2Launch pour effectuer les tâches suivantes au démarrage :

  • Initialisez les EBS volumes secondaires.

  • Envoyez les journaux d'événements Windows aux journaux de la EC2 console.

  • Envoyez le message Windows est prêt à être utilisé à la EC2 console.

Pour plus d’informations concernant Windows Server 2019, consultez la page relative à la comparaison des fonctions dans les versions de Windows Server sur Microsoft.com.

Structure de répertoire EC2Launch

EC2Launchest 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 EC2Launch répertoires et les fichiers, 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 le composentEC2Launch.

  • Module— Contient le module permettant de créer des scripts liés à AmazonEC2.

  • 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.

EC2Launchversion 1.3.2003498 et versions ultérieures collectent 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'EC2instance Amazon sur laquelle EC2Launch 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 : EC2Launch

  • 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=0

La 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, EC2Launch envoie les 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
Plus de sujets pour EC2Launch