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.

Configuration des paramètres de EC2 Launch v2 pour les instances Windows

Cette section contient des informations sur la façon de configurer les paramètres de EC2 Launch v2.

Modifier les paramètres à l'aide de la boîte de dialogue des paramètres de EC2 Launch v2

Voici un exemple de fichier YAML de configuration créé à partir des paramètres saisis dans la boîte de dialogue de EC2 lancement.

version: 1.0
config:
  - stage: boot
	tasks:
      - task: extendRootPartition
  - stage: preReady
    tasks:
      - task: activateWindows
        inputs:
          activation:
            type: amazon
      - task: setDnsSuffix
        inputs:
          suffixes:
            - $REGION.ec2-utilities.amazonaws.com
      - task: setAdminAccount
        inputs:
          password:
            type: random
      - task: setWallpaper
        inputs:
          path: C:\ProgramData\Amazon\EC2Launch\wallpaper\Ec2Wallpaper.jpg
          attributes:
            - hostName
            - instanceId
            - privateIpAddress
            - publicIpAddress
            - instanceSize
            - availabilityZone
            - architecture
            - memory
            - network
  - stage: postReady
    tasks:
      - task: startSsm

Configurer EC2 Launch v2 à l'aide de la CLI

Vous pouvez utiliser l'interface de ligne de commande (CLI) pour configurer vos paramètres de EC2 lancement et gérer le service. La section suivante contient des descriptions et des informations d'utilisation des commandes CLI que vous pouvez utiliser pour gérer EC2 Launch v2.

collect-logs

Collecte les fichiers journaux pour EC2 Launch, les compresse et les place dans un répertoire spécifié.

Exemple

ec2launch collect-logs -o C:\Mylogs.zip

Utilisation

ec2launch collect-logs [flags]

Indicateurs

-h, --help

aide pour collect-logs

-o, --output string

chemin d’accès aux fichiers journaux de sortie compressés

get-agent-config

Imprime agent-config.yml au format spécifié (JSON ou YAML). Si aucun format n’est spécifié, agent-config.yml est imprimé dans le format précédemment spécifié.

Exemple

ec2launch get-agent-config -f json

Utilisation

ec2launch get-agent-config [flags]

Indicateurs

-h, --help

aide pour get-agent-config

-f, --format string

format de sortie du fichier agent-config : json, yaml

list-volumes

Répertorie tous les volumes de stockage attachés à l’instance, y compris les volumes éphémères et EBS.

Exemple

ec2launch list-volumes

Utilisation

ec2launch list-volumes

Indicateurs

-h, --help

aide pour list-volumes

reset

L’objectif principal de cette tâche est de réinitialiser l’agent pour sa prochaine exécution. Pour ce faire, la reset commande supprime toutes les données d'état de l'agent pour EC2 Launch v2 du EC2Launch répertoire local (voirEC2Lancer la structure du répertoire v2). Reset supprime éventuellement le service et les journaux Sysprep.

Le comportement des scripts dépend du mode dans lequel l’agent exécute les scripts : en ligne ou détaché.

Exemple

ec2launch reset -c

Utilisation

ec2launch reset [flags]

Indicateurs

-c, --clean

nettoie les journaux d’instance avant la reset

-h, --help

aide pour reset

run

Exécute EC2 Launch v2.

Exemple

ec2launch run

Utilisation

ec2launch run [flags]

Indicateurs

-h, --help

aide pour run

status

Obtient le statut de l'agent EC2 Launch v2. Il est possible de bloquer le processus jusqu’à ce que l’agent soit terminé. Le code de sortie du processus détermine l’état de l’agent :

Exemple :

ec2launch status -b

Utilisation

ec2launch status [flags]

Indicateurs

-b,--block

bloque le processus jusqu’à la fin de l’exécution de l’agent

-h,--help

aide pour status

sysprep

L’objectif principal de cette tâche est de réinitialiser l’agent pour sa prochaine exécution. Pour ce faire, la commande sysprep réinitialise l’état de l’agent, met à jour le fichier unattend.xml, désactive RDP et exécute Sysprep.

Le comportement des scripts dépend du mode dans lequel l’agent exécute les scripts : en ligne ou détaché.

Exemple :

ec2launch sysprep

Utilisation

ec2launch sysprep [flags]

Indicateurs

-c,--clean

nettoie les journaux d’instance avant la sysprep

-h,--help

aide pour Sysprep

-s,--shutdown

arrête l’instance après l’exécution de sysprep

valider

Valide le fichier agent-config C:\ProgramData\Amazon\EC2Launch\config\agent-config.yml.

Exemple

ec2launch validate

Utilisation

ec2launch validate [flags]

Indicateurs

-h , --help

aide pour validate

version

Obtient la version exécutable.

Exemple

ec2launch version

Utilisation

ec2launch version [flags]

Indicateurs

-h, --help

aide pour version

fond d’écran

Définit le nouveau fond d’écran sur le chemin d’écran fourni (fichier .jpg) et affiche les détails de l’instance sélectionnée.

Syntaxe

ec2launch wallpaper ^
--path="C:\ProgramData\Amazon\EC2Launch\wallpaper\Ec2Wallpaper.jpg" ^
--all-tags ^
--attributes=hostName,instanceId,privateIpAddress,publicIpAddress,instanceSize,availabilityZone,architecture,memory,network

Inputs

EC2Configuration des tâches de lancement de la version 2

Cette section inclut les schémas de configuration, les tâches, les détails et les exemples pour agent-config.yml et les données utilisateur.

Schéma : agent-config.yml

La structure du fichier agent-config.yml est illustrée ci-dessous. Notez qu’une tâche ne peut pas être répétée dans la même étape. Pour connaître les propriétés des tâches, consultez les descriptions de tâches suivantes.

Structure du document : agent-config.yml

JSON

{
	"version": "1.1",
	"config": [
		{
			"stage": "string",
			"tasks": [
				{
					"task": "string",
					"inputs": {
						...
					}
				},
				...
			]
		},
		...
	]
}

YAML

version: 1.1
config:
- stage: string
  tasks:
  - task: string
	inputs:
	  ...
  ...
...

Exemple : agent-config.yml

L’exemple suivant montre les paramètres du fichier de configuration agent-config.yml.

version: 1.1
config:
- stage: boot
  tasks:
  - task: extendRootPartition
- stage: preReady
  tasks:
  - task: activateWindows
    inputs:
      activation:
        type: amazon
  - task: setDnsSuffix
    inputs:
      suffixes:
      - $REGION.ec2-utilities.amazonaws.com
  - task: setAdminAccount
    inputs:
      password:
        type: random
  - task: setWallpaper
    inputs:
      path: C:\ProgramData\Amazon\EC2Launch\wallpaper\Ec2Wallpaper.jpg
      attributes:
      - hostName
      - instanceId
      - privateIpAddress
      - publicIpAddress
      - instanceSize
      - availabilityZone
      - architecture
      - memory
      - network
- stage: postReady
  tasks:
  - task: startSsm

Configuration des scripts de données utilisateur de EC2 Launch v2 exécutés lors du lancement ou du redémarrage

Les exemples JSON et YAML suivants illustrent la structure du document pour les données utilisateur. Amazon EC2 analyse chaque tâche nommée dans le tasks tableau que vous spécifiez dans le document. Chaque tâche possède son propre ensemble de propriétés et d’exigences. Pour obtenir des détails, veuillez consulter le Définitions de tâches pour les tâches de démarrage de EC2 Launch v2.

Structure du document : données utilisateur

JSON

{
	"version": "1.1",
	"tasks": [
		{
			"task": "string",
			"inputs": {
				...
			},
		},
		...
	]
}

YAML

version: 1.1
tasks:
- task: string
  inputs:
    ...
...

Exemple : données utilisateur

Pour plus d’informations sur les rôles d’utilisateur, consultez Comment Amazon EC2 gère les données utilisateur pour les instances Windows.

L'exemple de document YAML suivant montre un PowerShell script que EC2 Launch v2 exécute sous forme de données utilisateur pour créer un fichier.

version: 1.1
tasks:
- task: executeScript
  inputs:
  - frequency: always
    type: powershell
    runAs: localSystem
    content: |-
      New-Item -Path 'C:\PowerShellTest.txt' -ItemType File

Vous pouvez utiliser un format XML pour les données utilisateur compatible avec les versions précédentes de l'agent de lancement. EC2Launch v2 exécute le script en tant que executeScript tâche dans la UserData phase. Pour se conformer au comportement de EC2 Launch v1 et EC2 Config, le script de données utilisateur s'exécute par défaut en tant que processus attaché/en ligne.

Vous pouvez ajouter des balises facultatives pour personnaliser l’exécution de votre script. Par exemple, pour exécuter le script de données utilisateur lors du redémarrage de l’instance et lors du lancement de l’instance, vous pouvez utiliser la balise suivante :

<persist>true</persist>

Exemple :

<powershell>
  $file = $env:SystemRoot + "\Temp" + (Get-Date).ToString("MM-dd-yy-hh-mm")
  New-Item $file -ItemType file
</powershell>
<persist>true</persist>

Vous pouvez spécifier un ou plusieurs PowerShell arguments à l'aide de la <powershellArguments> balise. Si aucun argument n'est transmis, EC2 Launch v2 ajoute l'argument suivant par défaut : -ExecutionPolicy Unrestricted

Exemple :

<powershell>
  $file = $env:SystemRoot + "\Temp" + (Get-Date).ToString("MM-dd-yy-hh-mm")
  New-Item $file -ItemType file
</powershell>
<powershellArguments>-ExecutionPolicy Unrestricted -NoProfile -NonInteractive</powershellArguments>

Pour exécuter un script de données utilisateur XML en tant que processus détaché, ajoutez la balise suivante à vos données utilisateur.

<detach>true</detach>

Exemple :

<powershell>
  $file = $env:SystemRoot + "\Temp" + (Get-Date).ToString("MM-dd-yy-hh-mm")
  New-Item $file -ItemType file
</powershell>
<detach>true</detach>

Journal des modifications : données utilisateur

Le tableau suivant répertorie les modifications apportées aux données utilisateur et les référence à la version de l'agent EC2 Launch v2 applicable.

* Lorsqu’il est utilisé avec le fichier agent-config.yml par défaut.

EC2Lancez les codes de sortie de la v2 et redémarrez

Vous pouvez utiliser EC2 Launch v2 pour définir la manière dont les codes de sortie sont gérés par vos scripts. Par défaut, le code de sortie de la dernière commande exécutée dans un script est signalé comme le code de sortie pour l’ensemble du script. Par exemple, si un script inclut trois commandes et que la première commande échoue mais que les suivantes réussissent, le statut d’exécution est signalé comme success étant donné que la commande finale a réussi.

Si vous souhaitez qu'un script redémarre une instance, vous devez le spécifier exit 3010 dans votre script, même si le redémarrage est la dernière étape de votre script. exit 3010demande à EC2 Launch v2 de redémarrer l'instance et d'appeler à nouveau le script jusqu'à ce qu'il renvoie un code de sortie qui ne l'est pas 3010 ou jusqu'à ce que le nombre maximal de redémarrages soit atteint. EC2Launch v2 autorise un maximum de 5 redémarrages par tâche. Si vous tentez de redémarrer une instance à partir d’un script à l’aide d’un mécanisme différent, tel que Restart-Computer, le statut d’exécution du script sera incohérent. Par exemple, il peut être bloqué dans une boucle de redémarrage ou ne pas effectuer le redémarrage.

Si vous utilisez un format de données utilisateur XML qui est compatible avec les anciens agents, les données utilisateur peuvent s’exécuter plus de fois que vous le souhaitez. Pour plus d’informations, consultez Le service exécute les données utilisateur plus d’une fois dans la section de résolution des problèmes.

EC2Lancez la v2 et Sysprep

Le service EC2 Launch v2 exécute Sysprep, un outil Microsoft qui permet de créer une AMI Windows personnalisée qui peut être réutilisée. Lorsque EC2 Launch v2 appelle Sysprep, il utilise les fichiers qu'il contient %ProgramData%\Amazon\EC2Launch pour déterminer les opérations à effectuer. Vous pouvez modifier ces fichiers indirectement à l'aide de la boîte de dialogue des paramètres de EC2 lancement, ou directement à l'aide d'un éditeur YAML ou d'un éditeur de texte. Cependant, certains paramètres avancés ne sont pas disponibles dans la boîte de dialogue des paramètres de EC2 lancement. Vous devez donc modifier ces entrées directement.

Si vous créez une AMI directement dans une instance après avoir mis à jour ses paramètres, ceux-ci sont appliqués à n’importe quelle instance lancée dans la nouvelle AMI. Pour plus d’informations sur la création d’une AMI, consultez Créer une AMI basée sur Amazon EBS.