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.
# Importer une image
Vous pouvez créer des images WorkSpaces d'applications en important vos images personnalisées EC2 AMIs. Voici comment cela fonctionne :
1. Personnalisez votre EC2 AMI à l'aide de n'importe quelle méthode préférée, y compris [EC2 Image Builder](https://docs.aws.amazon.com/imagebuilder/).
1. Importez votre AMI personnalisée dans WorkSpaces Applications pour créer une image d' WorkSpaces applications
1. Vous pouvez également utiliser Image Builder pour personnaliser davantage les images
Les images créées via l'importation d'AMI sont de`type = "custom"`, tandis que WorkSpaces les images fournies par les applications sont de`type = "native"`.
Vous pouvez utiliser les types d'instance stream.\$1 pour les images avec. `type = "native"` Pour utiliser l'un des types d'instance suivants, vous devez importer votre AMI et créer une image avec`type = "custom"`.
+ GeneralPurpose.\$1
+ MemoryOptimized.\$1
+ ComputeOptimized.\$1
+ Accéléré. \$1
## Conditions préalables à l'importation d'images
Toutes ces conditions préalables sont importantes pour une exécution réussie du flux de travail. Les configurations AMI prises en charge et les autres exigences obligatoires sont répertoriées ci-dessous.
### Propriétés de l'AMI requises
EBS
+ Taille inférieure ou égale à 500 Go
+ Vous pouvez importer une AMI de moins de 200 Go, mais l'image importée utilisera au moins 200 Go.
+ GP2
+ Vous pouvez importer une AMI avec le type de volume EBS gp2 ou gp3, mais l'image importée utilisera gp2.
+ Un volume par image
+ `/dev/sda1`Nom du périphérique racine
+ Type d'image : Machine
+ Architecture : x86\$164
+ Type de virtualisation : HVM
+ Mode de démarrage : UEFI
+ Support TPM : version 2.0. Ceci est obligatoire. Reportez-vous à [https://docs.aws.amazon.com/ec2/latest/windows-ami-reference/ami-windows-tpm.html\$1](https://docs.aws.amazon.com/ec2/latest/windows-ami-reference/ami-windows-tpm.html#ami-windows-tpm-find) pour ami-windows-tpm-find trouver une AMI compatible avec le TPM.
+ Support ENA : vrai
+ Plateforme : Windows
+ Détails de la plateforme : Windows
### Propriétés du système d'exploitation
**Windows Server 2022/2025 (base complète)**
+ Windows Server **Core** n'est pas pris en charge
+ Windows avec SQL Server n'est pas pris en charge
Agents
+ EC2 Lancer la version V2 >= 2.1.1
+ Agent SSM requis
Pilotes
+ EC2 Version du pilote ENA >= 2.9.0
+ EC2 NVMe Version du pilote >= 1.6.0
Support aux bibliothèques
+ .NET Framework 4.8 ou supérieur
+ Installé par défaut dans Windows Server 2022/2025
+ PowerShell 5.1 ou supérieur
+ Installé par défaut dans Windows Server 2022/2025
+ Fonctionnalités Windows : L'hôte de session des services de bureau à distance et de licence des services de bureau à distance ne doit pas être installé
+ Ports : les ports 8000, 8300 et 8443 doivent être débloqués et inoccupés
+ Mode de démarrage : UEFI
Si vous souhaitez utiliser une image avec des instances graphiques telles que Accelerated.G4DN, Accelerated.G5, Accelerated.G6 ou Accelerated.G6E, vous devez installer le pilote GRID approprié sur votre AMI. Pour plus de détails, veuillez consulter le [https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/nvidiafichier -GRID-driver.html](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/nvidia-GRID-driver.html). Si les pilotes ne sont pas correctement configurés, le streaming fonctionnera, mais la carte graphique peut ne pas être disponible.
**Important**
Le « ID de compte propriétaire » de l'AMI doit être votre identifiant de AWS compte. Vous ne pouvez pas importer une EC2 AMI publique.
Effectuez toutes les mises à jour de Windows et désactivez les mises à jour automatiques de Windows avant d'importer l'image.
L'importation de données chiffrées n' EC2 AMIs est actuellement pas prise en charge
### Exigences relatives au rôle IAM
**Important**
« Créez un rôle IAM avec les autorisations suivantes à utiliser pour l'importation d'images :
```
{
"Version": "2012-10-17",
"Statement": [
{
"Sid": "AllowModifyImageAttributeWithTagCondition",
"Effect": "Allow",
"Action": "ec2:ModifyImageAttribute",
"Resource": "*"
},
{
"Sid": "AllowDescribeImages",
"Effect": "Allow",
"Action": "ec2:DescribeImages",
"Resource": "*"
}
]
}
```
Ajoutez la relation de confiance suivante pour ce rôle IAM
```
{
"Version": "2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Principal": {
"Service": "appstream.amazonaws.com"
},
"Action": "sts:AssumeRole"
}
]
}
```
## Pour importer une image
1. Ouvrez la console WorkSpaces Applications à l'adresse [https://console.aws.amazon.com/appstream2](https://console.aws.amazon.com/appstream2).
1. Dans le volet de navigation de gauche, choisissez **Images**, puis choisissez **Image registry**.
1. Choisissez **Importer une image**.
1. **ID AMI** - Entrez un ID AMI pour l'AMI que vous souhaitez importer dans WorkSpaces Applications. Vous pouvez également rechercher votre AMI à l'aide de ce champ.
1. **Nom de l'image** - Entrez un nom unique pour l'image qui sera créée en raison de l'opération d'importation.
1. **Nom d'affichage** *(facultatif)* - Entrez le nom à afficher pour l'image.
1. **Description** *(facultatif)* — Entrez une description pour l'image.
1. Rôle **IAM : sélectionnez le rôle** IAM que vous avez créé pour l'importation d'images. Pour plus de détails, reportez-vous à[Exigences relatives au rôle IAM](#iam-role-requirements).
1. **Agent de gestion WorkSpaces des applications** : sélectionnez cette option si vous souhaitez toujours utiliser la dernière version de l'agent d' WorkSpaces applications. Vos instances de streaming sont automatiquement mises à jour avec les dernières fonctionnalités, améliorations de performances et mises à jour de sécurité disponibles AWS dès la publication d'une nouvelle version de l'agent.
1. **Validation à l'exécution** *(facultatif)* : sélectionnez cette option et le service fournira à une instance l'image en cours d'importation et exécutera des tests de streaming.
+
**Note**
Ces tests de streaming seront exécutés en arrière-plan, vous ne pouvez pas vous connecter à cette instance via le client WorkSpaces Applications.
+ Nous vous recommandons d'utiliser cette option pour être plus sûr que votre image est adaptée aux WorkSpaces applications.
+ Le prix horaire de cette instance vous sera facturé.
+ Vous pouvez éviter d'exécuter la validation d'exécution si vous réimportez votre AMI après avoir apporté des modifications mineures susceptibles de ne pas affecter le test de streaming, et si la validation d'exécution a réussi la dernière fois, vous avez importé cette AMI.
+ **Choisissez le type d'instance** *(facultatif)* : sélectionnez la famille, le type et la taille d'instance appropriés pour exécuter le test de streaming. Il est recommandé d'utiliser la même instance que celle que vous avez l'intention d'utiliser pour la création de flotte.
1. **Catalogue des applications et manifeste des performances de lancement** *(facultatif)* : fournissez des informations détaillées pour créer un catalogue d'applications pour vos utilisateurs finaux et améliorer les performances de lancement de vos applications.
+ **Catalogue d'applications** : pour créer un catalogue d'applications, spécifiez les informations relatives aux applications installées sur votre image. Pour chaque application que vous prévoyez de diffuser, vous pouvez spécifier le nom, le nom d'affichage, le fichier exécutable à lancer et l'icône à afficher.
+ **Performances de lancement** : l'ajout de fichiers au manifeste d'optimisation de l'application réduit le temps nécessaire au premier lancement de l'application sur une nouvelle instance de flotte. Le manifeste d'optimisation est un fichier texte délimité par des lignes spécifique à l’application.
Pour en savoir plus, reportez-vous à[Détails des applications](applications-details.md).
1. **Balises** *(facultatif)* - Choisissez **Ajouter une balise** et saisissez la clé et la valeur de la balise. Répétez cette étape pour ajouter d’autres balises. Pour de plus amples informations, veuillez consulter [Marquer les ressources de vos WorkSpaces applications Amazon](tagging-basic.md).
1. **Importer une image** — Vérifiez toutes les informations que vous avez saisies et choisissez **Importer une image**. Le service exécutera des contrôles de compatibilité pour s'assurer que l'AMI est compatible avec WorkSpaces les applications.
+ Si les contrôles statiques échouent, vous recevrez immédiatement un message d'erreur.
+ Si les vérifications statiques réussissent, votre demande d'importation sera soumise et, selon les options que vous avez sélectionnées, la création d'une nouvelle image d' WorkSpaces applications peut prendre 30 à 60 minutes avec `type = "custom"`
# Détails des applications
Les détails des applications contiennent des informations sur les manifestes de préchauffage et les configurations du catalogue d'applications.
## Manifestes de PreWarm candidature
Lorsque vous créez WorkSpaces des images d'applications, vous pouvez spécifier les applications à mettre à la disposition de vos utilisateurs. Pour accélérer le lancement de l'application, vous pouvez préparer un PreWarm manifeste. Il s'agit essentiellement d'un catalogue des fichiers dont votre application a besoin pour être lancée lorsque les utilisateurs lancent votre application. Lors du provisionnement de l'instance, ces fichiers seront préparés avant les connexions de session afin d'accélérer le lancement des applications lors des sessions utilisateur.
Les manifestes de préchauffage doivent être créés au préalable sur votre AMI avant d'être importés dans l'environnement WorkSpaces Applications. Vous pouvez choisir de créer un fichier manifeste Prewarm commun ou un fichier par application. Cela change la façon dont vous allez importer votre AMI ultérieurement.
### Manifeste de préchauffage courant
Pour chaque application que vous souhaitez préchauffer, lancez l'application et effectuez les interactions initiales que vos utilisateurs peuvent effectuer. Utilisez ensuite la commande suivante pour cibler le répertoire dans lequel les données de vos applications sont stockées.
```
dir -path "C:\Path\To\Folder\To\Optimize" -Recurse -ErrorAction SilentlyContinue | %{$_.FullName} | Out-File "C:\ProgramData\Amazon\Photon\Prewarm\PrewarmManifest.txt" -encoding UTF8 -append
```
Cela ajoutera les fichiers à optimiser pour chaque application dans le `C:\\ProgramData\\Amazon\\Photon\\Prewarm\\PrewarmManifest.txt` fichier commun. Aucune action supplémentaire n'est nécessaire pour effectuer le préchauffage de l'application. WorkSpaces Les applications rechercheront le fichier de préchauffage à l'emplacement ci-dessus et l'utiliseront s'il est présent.
Ce processus est facultatif et à mesure que la taille du manifeste de préchauffage augmente, le temps de provisionnement de la flotte augmentera également. Veillez donc à trouver un équilibre entre optimisation et approvisionnement de flotte.
### Manifestes spécifiques à l'application
Lors de l'importation d'images, vous souhaiterez peut-être spécifier des fichiers manifestes d'application distincts par application pour faciliter le suivi des actifs de préchauffage par application. Pour ce faire, suivez les mêmes étapes que ci-dessus, mais au lieu de créer un `C:\\ProgramData\\Amazon\\Photon\\Prewarm\\PrewarmManifest.txt` fichier commun, créez un fichier par application sur votre AMI.
Pour chaque application que vous souhaitez préchauffer, lancez l'application et effectuez les interactions initiales que vos utilisateurs peuvent effectuer. Utilisez ensuite la commande suivante pour cibler le répertoire dans lequel les données de vos applications sont stockées.
```
dir -path "C:\Path\To\Folder\To\Optimize" -Recurse -ErrorAction SilentlyContinue | %{$_.FullName} | Out-File "C:\Path\To\My\PreWarm.txt" -encoding UTF8 -append
```
Nous utiliserons ces fichiers de préchauffage de l'application pendant le processus d'importation des images. Encore une fois, c'est totalement facultatif. Vous pouvez choisir d'utiliser cette méthode, la méthode Common Prewarm Manifest, ou de ne pas utiliser de manifeste Prewarm du tout.
## Configurations du catalogue d'applications
`AppCatalogConfig`qui vous permet de spécifier les applications que vous souhaitez enregistrer sur votre image d' WorkSpaces applications lors de l'importation d'AMI. `AppCatalogConfig`Il s'agit d'une liste JSON d'objets de configuration d'application de la structure suivante.
```
[
{
"Name": "Rufus", //Required and must be unique among the list of applications
"DisplayName": "Rufus",
"AbsoluteAppPath": "Rufus", //Required
"AbsoluteIconPath": "Rufus",
"AbsoluteManifestPath": "Rufus",
"WorkingDirectory": "Rufus",
"LaunchParameters": "Rufus"
}
...
// Up to 50 applications total
]
```
Les seuls champs obligatoires par candidature sont le `Name` et le`AbsoluteAppPath`. Les détails de chaque champ sont les suivants :
Nom [**Obligatoire**]
+ Un prénom pour votre application afin de l'identifier
+ Entre 1 et 100 caractères
+ Caractères autorisés regex `^[a-zA-Z0-9][a-zA-Z0-9_.-]{0,99}$`
+ Doit être unique dans un domaine donné AppCatalogConfig
DisplayName
+ Le nom d'affichage d'une application donnée à afficher aux utilisateurs
+ Entre 0 et 100 caractères
+ Caractères autorisés regex `^[a-zA-Z0-9][a-zA-Z0-9_. -]{0,99}$`
AbsoluteAppPath [**Obligatoire**]
+ Le chemin d'accès à l'exécutable pour lancer votre application
+ Il s'agit de l'exécutable qui sera lancé lorsque les utilisateurs sélectionneront votre application
+ Entre 1 et 32 767 caractères
+ Cette limite supérieure de longueur de caractères est destinée à prendre en charge les chemins de fichiers étendus sous Windows. Assurez-vous que votre AMI et votre application sont correctement configurées pour prendre en charge les chemins de fichiers étendus de Windows si vous utilisez des chemins de fichiers de plus de 260 caractères.
+ Utilisez des chaînes de chemin de fichier échappées telles que
+ `"C:\\Windows\\System32\\notepad.exe"`
AbsoluteManifestPath
+ Applicable uniquement si vous utilisez [Manifestes spécifiques à l'application](#application-specific-manifests)
+ Chemin d'accès au fichier manifeste de préchauffage pour cette application
+ Entre 0 et 32767 caractères
+ Cette limite supérieure de longueur de caractères est destinée à prendre en charge les chemins de fichiers étendus sous Windows. Assurez-vous que votre AMI et votre application sont correctement configurées pour prendre en charge les chemins de fichiers étendus de Windows si vous utilisez des chemins de fichiers de plus de 260 caractères.
+ Utilisez des chaînes de chemin de fichier échappées telles que
+ `"C:\\Path\\To\\PrewarmManifest.txt"`
AbsoluteIconPath
+ Chemin d'accès au fichier d'icône sur l'AMI à utiliser pour l'application.
+ Cette icône sera montrée aux utilisateurs lors de la diffusion sur cette image.
+ Si aucune icône n'est fournie, l'icône sera dérivée de l'exécutable lui-même.
+ Veillez à sélectionner des fichiers d'icônes avec une transparence d'arrière-plan gérée de manière appropriée pour une bonne expérience client pour vos utilisateurs
+ Utiliser des images PNG
+ Entre 1 et 32 767 caractères
+ Cette limite supérieure de longueur de caractères est destinée à prendre en charge les chemins de fichiers étendus sous Windows. Assurez-vous que votre AMI et votre application sont correctement configurées pour prendre en charge les chemins de fichiers étendus de Windows si vous utilisez des chemins de fichiers de plus de 260 caractères.
+ Utilisez des chaînes de chemin de fichier échappées telles que
+ `"C:\\Path\\To\\ApplicationIcon.png"`
WorkingDirectory
+ Le répertoire de travail dans lequel lancer votre application
+ Entre 0 et 32767 caractères
+ Cette limite supérieure de longueur de caractères est destinée à prendre en charge les chemins de fichiers étendus sous Windows. Assurez-vous que votre AMI et votre application sont correctement configurées pour prendre en charge les chemins de fichiers étendus de Windows si vous utilisez des chemins de fichiers de plus de 260 caractères.
+ Utilisez des chaînes de chemin de fichier échappées telles que
+ `"C:\\Path\\To\\Working\\Directory"`
LaunchParameters
+ Chaîne à utiliser comme paramètres de lancement pour l'exécutable spécifié dans `AbsoluteAppPath`
+ Entre 0 et 1024 caractères
+ Utilisez des chaînes échappées avec la liste complète des paramètres de lancement requis, comme dans l'exemple suivant, qui montre comment vous pouvez utiliser PowerShell des scripts en tant qu'applications en utilisant l' PowerShell exécutable en tant qu'application avec un script fourni dans les paramètres de lancement.
+ AbsoluteAppPath
+ `"C:\\Windows\\System32\\WindowsPowerShell\\v1.0\\powershell.exe"`
+ LaunchParameters
+ `"-File \"C:\\Path\\To\\App\\Script.ps1\""`
### Exemple AppCatalogConfig
Ceci est un simple exemple d'un AppCatalogConfig pour Notepad, Google Chrome et Mozilla Firefox
```
[
{
"Name": "Notepad",
"DisplayName": "Notepad",
"AbsoluteAppPath": "C:\\Windows\\System32\\notepad.exe"
},
{
"Name": "Chrome",
"DisplayName": "Chrome",
"AbsoluteAppPath": "C:\\Program Files\\Google\\Chrome\\Application\\chrome.exe",
"LaunchParameters": "https://www.amazon.com/"
},
{
"Name": "Firefox",
"DisplayName": "Firefox",
"AbsoluteAppPath": "C:\\Program Files\\Mozilla Firefox\\firefox.exe",
"LaunchParameters": "https://aws.amazon.com/"
}
]
```