View a markdown version of this page

Importer une image - WorkSpaces Applications Amazon

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 d' WorkSpaces applications en important vos AMI ou WorkSpaces images EC2 personnalisées. Voici comment cela fonctionne :

  1. Personnalisez votre AMI EC2 à l'aide de n'importe quelle méthode préférée, y compris EC2 Image Builder.

  2. Importez votre AMI ou vos WorkSpaces images personnalisées dans WorkSpaces Applications pour créer une image d' WorkSpaces applications

  3. Vous pouvez également utiliser Image Builder pour personnaliser davantage les images

WorkSpaces Les images d'applications créées via l'AMI EC2 ou l'importation d'images WorkSpaces Windows Server sont detype = "custom". WorkSpaces L'importation d'images Windows BYOL créera des images WorkSpaces d'applications avectype = "BYOL". WorkSpaces Les images fournies par les applications sont detype = "native".

Vous pouvez utiliser les types d'instance stream.* pour les images avec type = "native" et. type = "BYOL" Pour utiliser l'un des types d'instance suivants, vous devez importer votre AMI et créer une image avectype = "custom".

  • GeneralPurpose.*

  • MemoryOptimized.*

  • ComputeOptimized.*

  • Accéléré. *

Important

WorkSpaces les images sur lesquelles des applications incluses dans une licence sont installées ne sont pas prises en charge. Vous devez désinstaller ces applications de l'image à l'aide de la commande Gérer les applications et configurer ces applications à l'aide deGérez les applications incluses sous licence sur votre image dans Amazon WorkSpaces Applications.

Conditions préalables à l'importation d'images AMI EC2

Toutes ces conditions préalables sont importantes pour une exécution réussie du flux de travail. Les configurations d'AMI EC2 prises en charge et les autres exigences obligatoires sont répertoriées ci-dessous. Notez que cela ne s'applique pas à l'importation d' WorkSpaces images, car celle-ci est gérée par le WorkSpaces service.

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/sda1Nom du périphérique racine

Propriétés du système d'exploitation

Windows Server (base 2022/2025 complète)
  • Windows Server Core n'est pas pris en charge

  • Windows avec SQL Server n'est pas pris en charge

Agents
  • Lancement d'EC2 V2

    • Installé par défaut dans Windows Server 2022/2025

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 si Accelerated.G6e vous devez installer le pilote GRID approprié sur votre AMI. Pour plus de détails, veuillez consulter 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 il se peut que la carte graphique ne soit pas disponible.

Important

Le « ID de compte propriétaire » de l'AMI doit être votre identifiant de AWS compte. Vous ne pouvez pas importer d'AMI EC2 publique.

Effectuez toutes les mises à jour Windows et désactivez les mises à jour automatiques de Windows avant d'importer l'image.

L'importation d'AMI EC2 chiffrées n'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" } ] }

Exigences relatives à WorkSpaces l'importation d'images

Lorsque vous importez une WorkSpaces image Amazon dans WorkSpaces Applications, les exigences relatives au système d'exploitation et au protocole suivantes s'appliquent :

  • Windows Server 2022 — Seules les images WSP (WorkSpaces Streaming Protocol) sont prises en charge. Les images PCoIP ne sont pas prises en charge.

  • Windows Server 2025 — Toutes les images sont prises en charge.

  • Windows 11 — Version 24H2 ou ultérieure uniquement.

Pour importer une image

  1. Ouvrez la console WorkSpaces Applications à l'adresse https://console.aws.amazon.com/appstream2.

    Note

    Votre rôle de console devra également inclure l'workspaces:DescribeWorkspaceImagesautorisation d'importer une WorkSpaces image Amazon.

  2. Dans le volet de navigation de gauche, choisissez Images, puis choisissez Image registry.

  3. Choisissez Importer une image.

  4. Source de l'image : choisissez l'une des options ci-dessous en fonction du type d'image que vous souhaitez importer

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

    • Amazon WorkSpaces Image - Entrez un identifiant d' WorkSpaces image (qui commence par « wsi- »). Vous pouvez également rechercher votre ID WorkSpaces d'image à l'aide de ce champ.

  5. Nom de l'image - Entrez un nom unique pour l'image qui sera créée en raison de l'opération d'importation.

  6. Nom d'affichage (facultatif) - Entrez un nom d'affichage pour l'image.

  7. Description (facultatif) — Entrez une description pour l'image.

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

    • Nécessaire pour l'importation d'AMI EC2

    • Non applicable à l'importation d' WorkSpaces images

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

  10. Validation à l'exécution (facultatif) : sélectionnez cette option et le service fournira à une instance l'image importée 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 prévoyez d'utiliser pour la création de flotte.

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

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

  13. 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 avec ou type = "custom" type = "BYOL"