Citrix Virtual Apps and Desktops 7 2311

Créer un catalogue AWS

(/fr-fr/citrix-virtual-apps-desktops/2311/install-configure/machine-catalogs-create.html) décrit les assistants qui créent un catalogue de machines. Les informations suivantes couvrent les détails spécifiques aux environnements de virtualisation AWS.

Remarque :

Avant de créer un catalogue AWS, vous devez terminer la création d’une connexion à AWS. Consultez (/fr-fr/citrix-virtual-apps-desktops/2311/install-configure/connections/connection-aws.html).

Limitation

À partir de Citrix Virtual Apps and Desktops™ 2203 LTSR et versions ultérieures, le plug-in MCS AWS effectue un appel d’API AWS DescribeInstanceTypes et si celui-ci réussit, MCS utilise le nom d’inventaire créé à partir de la réponse de l’API.

Par conséquent, lorsque vous effectuez une mise à niveau de CVAD 1912 vers 2203 ou une version ultérieure, désactivez l’autorisation DefineInstanceType sur AWS, puis mettez à jour le catalogue existant à l’aide de la commande Set-ProvScheme pour qu’il corresponde au schéma de dénomination AWS. Ensuite, ajoutez les autorisations DescribeInstanceType une fois la mise à jour du catalogue terminée et que l’offre de services correspond au schéma de dénomination AWS.

Paramètres réseau pendant la préparation de l’image

Pendant la préparation de l’image, une machine virtuelle (VM) de préparation est créée à partir de la VM d’origine. Cette VM de préparation est déconnectée du réseau. Pour déconnecter le réseau de la VM de préparation, un groupe de sécurité réseau est créé pour refuser tout trafic entrant et sortant. Ce groupe de sécurité réseau persiste et est réutilisé. Le nom du groupe de sécurité réseau est Citrix.XenDesktop.IsolationGroup-GUID, où GUID est généré aléatoirement.

Configurer la location AWS

AWS offre les options de location suivantes :

  • Location partagée (type par défaut) : plusieurs instances Amazon EC2 de différents clients peuvent résider sur le même matériel physique.
  • Location dédiée : vos instances EC2 s’exécutent uniquement sur du matériel avec d’autres instances que vous avez déployées. D’autres clients n’utilisent pas le même matériel.

Vous pouvez utiliser MCS pour provisionner des hôtes dédiés AWS à l’aide de PowerShell.

Configurer la location d’hôtes dédiés AWS à l’aide de PowerShell

Vous pouvez créer un catalogue de machines avec une location d’hôte définie via PowerShell.

Un hôte dédié Amazon [EC2] est un serveur physique avec une capacité d’instance [EC2] entièrement dédiée, vous permettant d’utiliser les licences logicielles existantes par socket ou par machine virtuelle.

Les hôtes dédiés ont une utilisation prédéfinie basée sur le type d’instance. Par exemple, un seul hôte dédié alloué de type d’instance C4 Large est limité à l’exécution de 16 instances. Consultez le site AWS pour plus d’informations.

Les exigences pour le provisionnement sur les hôtes AWS incluent :

  • Une image BYOL (apportez votre propre licence) importée (AMI). Avec les hôtes dédiés, utilisez et gérez vos licences existantes.
  • Une allocation d’hôtes dédiés avec une utilisation suffisante pour satisfaire les demandes de provisionnement.
  • activer l’auto-placement.

Pour provisionner sur un hôte dédié dans AWS à l’aide de PowerShell, utilisez l’applet de commande New-ProvScheme avec le paramètre TenancyType défini sur Host.

Reportez-vous à la documentation du développeur Citrix pour plus d’informations.

Capturer les propriétés de la machine à partir des AMI

Lorsque vous créez un catalogue pour provisionner des machines à l’aide de Machine Creation Services (MCS) dans AWS, vous sélectionnez une AMI pour représenter l’image maître/dorée de ce catalogue. À partir de cette AMI, MCS utilise un instantané du disque. Dans les versions précédentes, si vous vouliez des rôles ou des balises sur vos machines, vous utilisiez la console AWS pour les définir individuellement. Cette fonctionnalité est activée par défaut.

Conseil :

Pour utiliser la capture des propriétés d’instance AWS, vous devez avoir une machine virtuelle associée à l’AMI.

Pour améliorer ce processus, MCS lit les propriétés de l’instance à partir de laquelle l’AMI a été prise et applique le rôle IAM (Identity Access Management) et les balises de la machine aux machines provisionnées pour un catalogue donné. Lors de l’utilisation de cette fonctionnalité facultative, le processus de création de catalogue trouve l’instance source AMI sélectionnée, lisant un ensemble limité de propriétés. Ces propriétés sont ensuite stockées dans un modèle de lancement AWS, qui est utilisé pour provisionner les machines de ce catalogue. Toute machine du catalogue hérite des propriétés d’instance capturées.

Les propriétés capturées incluent :

  • Rôles IAM – appliqués aux instances provisionnées.
  • Balises – appliquées aux instances provisionnées, à leur disque et à leurs cartes réseau. Ces balises sont appliquées aux ressources Citrix® transitoires, notamment : les compartiments et objets S3, ainsi que les AMI, les instantanés et les modèles de lancement.

Conseil :

Le balisage des ressources Citrix transitoires est facultatif et est configurable à l’aide de la propriété personnalisée AwsOperationalResourcesTagging.

Capturer la propriété d’instance AWS

Vous pouvez utiliser cette fonctionnalité en spécifiant une propriété personnalisée, AwsCaptureInstanceProperties, lors de la création d’un schéma de provisioning pour une connexion d’hébergement AWS :

New-ProvScheme -CustomProperties "AwsCaptureInstanceProperties,true" …<standard provscheme parameters

Reportez-vous à la documentation pour développeurs Citrix pour plus d’informations.

Remarque :

Le AwsCaptureInstanceProperties est obsolète.

Capturer les propriétés de machine à partir de profils de machine

Lors de la création d’un catalogue pour provisionner des machines AWS à l’aide de MCS, vous pouvez utiliser un profil de machine pour prédéfinir certains paramètres de propriété de machine.

Pour ce faire, suivez les étapes suivantes :

  1. Stockez les profils de machine dans la même zone de disponibilité que les ressources où vous créez ce catalogue.
  2. Sur la page Modèle de machine de l’assistant de création de catalogue, sélectionnez Utiliser un profil de machine. Les profils de machine situés dans la même zone disponible que les ressources que vous avez sélectionnées sont affichés.
  3. Sélectionnez un profil de machine si nécessaire.

Remarque :

Vous pouvez utiliser un profil de machine ou une AMI pour capturer les propriétés de la machine. Dans Web Studio, lorsque vous sélectionnez Utiliser un profil de machine, l’option Appliquer les propriétés du modèle de machine aux machines virtuelles est automatiquement masquée.

Baliser la ressource opérationnelle AWS

Lors de la création d’un catalogue pour provisionner des machines dans AWS à l’aide de MCS, vous pouvez contrôler si les propriétés de rôle IAM et de balise doivent être appliquées à ces machines. Vous pouvez également contrôler si les balises de machine doivent être appliquées aux ressources opérationnelles.

Une Amazon Machine Image (AMI) représente un type d’appliance virtuelle utilisée pour créer une machine virtuelle dans l’environnement Amazon Cloud, communément appelé EC2. Vous utilisez une AMI pour déployer des services qui utilisent l’environnement EC2. Lorsque vous créez un catalogue pour provisionner des machines à l’aide de MCS pour AWS, vous sélectionnez l’AMI pour qu’elle agisse comme image principale pour ce catalogue.

Important :

La création de catalogues en capturant une propriété d’instance et un modèle de lancement est requise pour l’utilisation du balisage des ressources opérationnelles.

Pour créer un catalogue AWS, vous devez d’abord créer une AMI pour l’instance que vous souhaitez utiliser comme image principale. MCS lit les balises de cette instance et les intègre dans le modèle de lancement. Les balises du modèle de lancement sont ensuite appliquées à toutes les ressources Citrix créées dans votre environnement AWS, y compris :

  • Machines virtuelles
  • Disques VM
  • Interfaces réseau de machines virtuelles
  • Compartiments S3
  • Objets S3
  • Modèles de lancement
  • AMI

Baliser une ressource opérationnelle

Pour utiliser PowerShell afin de baliser des ressources :

  1. Ouvrez une fenêtre PowerShell à partir de l’hôte DDC.
  2. Exécutez la commande asnp citrix pour charger les modules PowerShell spécifiques à Citrix.

Pour baliser une ressource pour une VM provisionnée, utilisez la nouvelle propriété personnalisée AwsOperationalResourcesTagging. La syntaxe de cette propriété est :

New-ProvScheme -CustomProperties "AwsCaptureInstanceProperties,true; AwsOperationalResourcesTagging,true" …<standard provscheme parameters>

Où aller ensuite

Copier les balises sur les VM

Vous pouvez copier les balises sur les cartes réseau et les disques (disque d’identité, disque de cache en écriture différée et disque de système d’exploitation) spécifiés dans le profil de machine vers les VM nouvellement créées dans un catalogue de machines MCS. Vous pouvez spécifier ces balises dans n’importe quelle source de profil de machine (instance de VM AWS ou version de modèle de lancement AWS). Cette fonctionnalité s’applique aux catalogues de machines et aux VM persistants et non persistants.

Remarque :

  • Sur la console AWS EC2, vous ne pouvez pas voir les valeurs Tag Network Interfaces sous les Launch Template Version Resource Tags. Cependant, vous pouvez exécuter la commande PowerShell aws ec2 describe-launch-template-versions --launch-template-id lt-0bb652503d45dcbcd --versions 12 pour voir les spécifications de balise.
  • Si une source de profil de machine (VM ou version de modèle de lancement) possède deux interfaces réseau (eni-1 et eni-2), et que eni-1 a l’étiquette t1 et eni-2 a l’étiquette t2, alors la VM obtient les étiquettes des deux interfaces réseau.

Créer un catalogue à l’aide d’un profil de machine

Lorsque vous créez un catalogue pour provisionner des machines à l’aide de Machine Creation Services™ (MCS) dans AWS, vous pouvez désormais utiliser un profil de machine pour capturer les propriétés matérielles d’une instance EC2 (VM) ou d’une version de modèle de lancement et les appliquer aux machines provisionnées. Les propriétés capturées peuvent inclure, par exemple, les propriétés de volume EBS, le type d’instance, l’optimisation EBS et d’autres configurations AWS prises en charge. Lors de la modification du catalogue, le profil de machine des machines provisionnées peut être modifié en fournissant une VM ou un modèle de lancement différent.

Remarque :

Les propriétés de volume EBS sont dérivées uniquement d’un profil de machine.

Considérations importantes

Les considérations importantes lors de la création d’un catalogue de machines MCS :

  • Si vous ajoutez des paramètres de propriété matérielle de machine dans les commandes New-ProvScheme et Set-ProvScheme, les valeurs fournies dans les paramètres écrasent les valeurs du profil de machine.
  • Si vous définissez AwsCaptureInstanceProperties comme true et ne définissez pas la propriété MachineProfile, seuls les rôles IAM et les balises sont capturés.
  • Vous ne pouvez pas définir AwsCaptureInstanceProperties et MachineProfile en même temps.

    Remarque :

    Le AwsCaptureInstanceProperties est obsolète.

  • Vous devez fournir explicitement les valeurs des propriétés suivantes :

    • TenancyType
    • Groupe de sécurité
    • NIC ou Réseau virtuel
  • Vous ne pouvez activer AwsOperationalResourcesTagging que si vous activez AwsCaptureInstanceProperties ou spécifiez un profil de machine.

Considérations importantes après la création d’un catalogue de machines MCS :

  • Seules les nouvelles VM ajoutées au catalogue sont affectées par la modification.
  • Vous ne pouvez pas modifier un catalogue basé sur un profil de machine en un catalogue non basé sur un profil de machine.

Créer un catalogue de machines à l’aide d’un profil de machine

Pour créer un catalogue de machines à l’aide d’un profil de machine :

  1. Ouvrez une fenêtre PowerShell.
  2. Exécutez asnp citrix* pour charger les modules PowerShell spécifiques à Citrix.
  3. Créez un pool d’identités s’il n’est pas déjà créé. Par exemple,

    New-AcctIdentityPool -IdentityPoolName idPool -NamingScheme ms## -Domain abcdf -NamingSchemeType Numeric
    <!--NeedCopy-->
    
  4. Exécutez la commande New-ProvScheme. Par exemple :

    New-ProvScheme -ProvisioningSchemeName demet-test-1
    -HostingUnitUid aa633238-9xxd-4cf6-80e8-232a758a1xx1
    -IdentityPoolUid 34d5b088-e312-416f-907d-16573xxxxxc4
    -CleanOnBoot
    -MasterImageVM 'XDHyp:\HostingUnits\cvad-test-scalestress\citrix-demet-ami.0 (ami-0ca813xxxxxx061ef).template'
    -MachineProfile 'XdHyp:\HostingUnits\cvad-test-scalestress\us-east-1a.availabilityzone\machine-profile-instance i (i-0xxxxxxxx).vm'
    <!--NeedCopy-->
    
  5. Terminez la création du catalogue. Pour plus d’informations, consultez le SDK Citrix PowerShell.

Pour mettre à jour le profil de machine sur un catalogue initialement provisionné avec un profil de machine :

  1. Exécutez la commande Set-ProvScheme. Par exemple,

    Set-ProvScheme `
    -ProvisioningSchemeUid "<ID" `
    -MachineProfile "XDHyp:\HostingUnits\abc\us-east-1a.availabilityzone\citrix-cvad-machineprofile-instance (i-0xxxxxxxx).vm"
    <!--NeedCopy-->
    

Créer un catalogue avec une version de modèle de lancement

Vous pouvez créer un catalogue de machines MCS avec une version de modèle de lancement comme entrée de profil de machine. Vous pouvez également mettre à jour l’entrée d’un catalogue de profils de machine d’une VM vers une version de modèle de lancement et d’une version de modèle de lancement vers une VM.

Sur la console AWS EC2, vous pouvez fournir les informations de configuration d’instance d’un modèle de lancement ainsi que le numéro de version. Lorsque vous spécifiez la version du modèle de lancement comme entrée de profil de machine lors de la création ou de la mise à jour d’un catalogue de machines, les propriétés de cette version du modèle de lancement sont copiées vers les VM VDA provisionnées.

Les propriétés suivantes peuvent être fournies à l’aide de l’entrée de profil de machine ou explicitement en tant que paramètres dans les commandes New-ProvScheme ou Set-ProvScheme. Si elles sont fournies dans les commandes New-ProvScheme ou Set-ProvScheme, elles priment sur les valeurs de profil de machine de ces propriétés.

  • Offre de service
  • Réseaux
  • Groupes de sécurité
  • Type de location

Remarque :

Si l’offre de service n’est pas fournie dans le modèle de lancement du profil de machine ou en tant que paramètre dans la commande New-ProvScheme, une erreur appropriée s’affiche.

Pour créer un catalogue en utilisant la version du modèle de lancement comme entrée de profil de machine :

  1. Ouvrez une fenêtre PowerShell.
  2. Exécutez asnp citrix* pour charger les modules PowerShell spécifiques à Citrix.
  3. Obtenez la liste des versions de modèle de lancement d’un modèle de lancement. Par exemple :

    XDHyp:\HostingUnits\test\test-mp-sard (lt-01xxxxx).launchtemplate> ls | Select FullPath
    <!--NeedCopy-->
    
  4. Créez un pool d’identités s’il n’est pas déjà créé. Par exemple :

    New-AcctIdentityPool `
    -IdentityPoolName "abc11" `
    -NamingScheme "abc1-##" `
    -NamingSchemeType Numeric `
    -Domain "citrix-xxxxxx.local" `
    -ZoneUid "xxxxxxxx" `
    <!--NeedCopy-->
    
  5. Créez un schéma de provisionnement avec une version de modèle de lancement comme entrée de profil de machine. Par exemple :

    New-ProvScheme `
    -ProvisioningSchemeName "MPLT1" `
    -HostingUnitUid "c7f71f6a-3f45-4xxx-xxxx-xxxxxxxxxx" `
    -IdentityPoolUid "bf3a6ba2-1f80-4xxx-xxxx-xxxxxxxxx" `
    -MasterImageVM "XDHyp:\HostingUnits\xxxd-ue1a\apollo-non-persistent-vda-win2022 (ami-0axxxxxxxxxxx).template" `
    -CleanOnBoot `
    -MachineProfile "XDHyp:\HostingUnits\xxxx-ue1a\machineprofiletest (lt-01xxxxx).launchtemplate\lt-01xxxxx (1).launchtemplateversion"
    <!--NeedCopy-->
    

    Vous pouvez également remplacer des paramètres tels que l’offre de service, les groupes de sécurité, la location et les réseaux. Par exemple :

    New-ProvScheme `
    -ProvisioningSchemeName "MPLT1" `
    -HostingUnitUid " c7f71f6a-3f45-4xxx-xxxx-xxxxxxxxxx" `
    -IdentityPoolUid " bf3a6ba2-1f80-4xxx-xxxx-xxxxxxxxx" `
    -MasterImageVM "XDHyp:\HostingUnits\xxxd-ue1a\apollo-non-persistent-vda-win2022 (ami-0axxxxxxxxxxx).template" `
    -CleanOnBoot `
    -MachineProfile "XDHyp:\HostingUnits\xxxx-ue1a\machineprofiletest (lt-01xxxx).launchtemplate\lt-01xxxx (1).launchtemplateversion" `
    -ServiceOffering "XDHyp:\HostingUnits\xxxd-ue1a\T3 Large Instance.serviceoffering"
    <!--NeedCopy-->
    
  6. Enregistrer le schéma de provisionnement en tant que catalogue de courtier. Par exemple :

    New-BrokerCatalog -Name "MPLT1" `
    -AllocationType Random `
    -Description "Machine profile catalog" `
    -ProvisioningSchemeId fe7df345-244e-4xxxx-xxxxxxxxx `
    -ProvisioningType Mcs `
    -SessionSupport MultiSession `
    -PersistUserChanges Discard
    <!--NeedCopy-->
    
  7. Terminez la création du catalogue. Pour plus d’informations, consultez le SDK Citrix PowerShell

Vous pouvez également mettre à jour l’entrée d’un catalogue de profils de machine d’une VM vers une version de modèle de lancement et d’une version de modèle de lancement vers une VM. Par exemple :

  • Pour mettre à jour l’entrée d’un catalogue de profils de machine d’une VM vers une version de modèle de lancement :

     Set-ProvScheme -ProvisioningSchemeName "CloudServiceOfferingTest" `
     -MachineProfile "XDHyp:\HostingUnits\xxxx-ue1a\machineprofiletest (lt-0bxxxxxxxxxxxx).launchtemplate\lt-0bxxxxxxxxxxxx (1).launchtemplateversion"
     <!--NeedCopy-->
    
  • Pour mettre à jour l’entrée d’un catalogue de profils de machine d’une version de modèle de lancement vers une VM :

     Set-ProvScheme -ProvisioningSchemeName "CloudServiceOfferingTest" `
     -MachineProfile "XDHyp:\HostingUnits\sard-ue1a\us-east-1a.availabilityzone\apollo-non-persistent-vda-win2022-2 (i-08xxxxxxxxx).vm"
     <!--NeedCopy-->
    

Filtrer les instances de VM

Une instance AWS EC2 que vous utilisez comme VM de profil de machine doit être compatible pour que le catalogue de machines puisse être créé et fonctionner correctement. Pour lister les instances AWS EC2 qui peuvent être utilisées comme VM d’entrée de profil de machine, vous pouvez utiliser la commande Get-HypInventoryItem. La commande peut paginer et filtrer l’inventaire des VM disponibles sur une unité d’hébergement.

Pagination :

Get-HypInventoryItem prend en charge deux modes de pagination :

  • Le mode de pagination utilise les paramètres -MaxRecords et -Skip pour renvoyer des ensembles d’éléments :
    • -MaxRecords : La valeur par défaut est 1. Cela contrôle le nombre d’éléments à renvoyer.
    • -Skip : La valeur par défaut est 0. Cela contrôle le nombre d’éléments à ignorer depuis le début absolu (ou la fin absolue) de la liste dans l’hyperviseur.
  • Le mode de défilement utilise les paramètres -MaxRecords, -ForwardDirection et -ContinuationToken pour permettre le défilement des enregistrements :
    • -ForwardDirection : La valeur par défaut est True. Ceci est utilisé avec -MaxRecords pour renvoyer soit l’ensemble suivant d’enregistrements correspondants, soit l’ensemble précédent d’enregistrements correspondants.
    • -ContinuationToken : Retourne les éléments immédiatement après (ou avant si ForwardDirection est false) mais sans inclure l’élément donné dans le ContinuationToken.

Exemples de pagination :

  • Pour renvoyer un seul enregistrement du modèle de machine avec le nom le plus bas. Le champ AdditionalData contient le TotalItemsCount et le TotalFilteredItemsCount :

     Get-HypInventoryItem -LiteralPath "XDHyp:\HostingUnits\ctx-test" -ResourceType template
     <!--NeedCopy-->
    
  • Pour renvoyer 10 enregistrements du modèle de machine avec le nom le plus bas :

     Get-HypInventoryItem -LiteralPath "XDHyp:\HostingUnits\ctx-test" -ResourceType template -MaxRecords 10 | select Name
     <!--NeedCopy-->
    
  • Pour renvoyer un tableau d’enregistrements se terminant par le nom le plus élevé :

     Get-HypInventoryItem -LiteralPath "XDHyp:\HostingUnits\ctx-test" -ResourceType template -ForwardDirection $False -MaxRecords 10 | select Name
     <!--NeedCopy-->
    
  • Pour renvoyer un tableau d’enregistrements commençant par le modèle de machine associé au ContinuationToken donné :

     Get-HypInventoryItem -LiteralPath "XDHyp:\HostingUnits\ctx-test" -ResourceType template -ContinuationToken "ami-07xxxxxxxxxx" -MaxRecords 10
     <!--NeedCopy-->
    

Filtrage :

Les paramètres facultatifs supplémentaires suivants sont pris en charge pour le filtrage. Vous pouvez combiner ces paramètres avec les options de pagination.

  • -ContainsName "my_name" : Si la chaîne donnée correspond à une partie d’un nom d’AMI, alors l’AMI est incluse dans le résultat Get. Par exemple :

     Get-HypInventoryItem -LiteralPath "XDHyp:\HostingUnits\ctx-test" -ResourceType template -MaxRecords 100 -ContainName ‘apollo’ | select Name
     <!--NeedCopy-->
    
  • -Tags '{ "Key0": "Value0", "Key1": "Value1", "Key2": "Value2" }' : Si une AMI possède au moins l’une de ces balises, elle est incluse dans le résultat Get. Par exemple :

     Get-HypInventoryItem -LiteralPath "XDHyp:\HostingUnits\ctx-test" -ResourceType template -MaxRecords 100 -Tags '{"opex owner": "Not tagged"}' | select Name
     <!--NeedCopy-->
    

    Remarque :

    Deux valeurs de balise sont prises en charge. La valeur de balise Non balisé correspond aux éléments qui n’ont pas la balise donnée dans leur liste de balises. La valeur de balise Toutes les valeurs correspond aux éléments qui ont la balise, quelle que soit la valeur de la balise. Sinon, la correspondance n’a lieu que si l’élément possède la balise et que la valeur est égale à celle donnée dans le filtre.

  • -Id "ami-0a2d913927e0352f3" : Si l’AMI correspond à l’ID donné, elle est incluse dans le résultat Get. Par exemple :

     Get-HypInventoryItem -LiteralPath "XDHyp:\HostingUnits\ctx-test" -ResourceType template -Id ami-xxxxxxxxxxxxx
     <!--NeedCopy-->
    

Filtrage sur le paramètre AdditionalData :

Le paramètre de filtre AdditionalData répertorie les modèles ou les machines virtuelles en fonction de leur capacité, de leur offre de service ou de toute propriété figurant dans AdditionalData. Par exemple :

(Get-HypInventoryItem -ResourceType "launchtemplateversion" -LiteralPath "XDHyp:\HostingUnits\aws" -MaxRecords 200).AdditionalData
<!--NeedCopy-->

Vous pouvez également ajouter un paramètre -Warn pour indiquer les machines virtuelles incompatibles. Les machines virtuelles sont incluses avec un champ AdditionalData nommé Warning. Par exemple :

(Get-HypInventoryItem -ResourceType "launchtemplateversion" -LiteralPath "XDHyp:\HostingUnits\aws" -MaxRecords 200 -Template "ami-015xxxxxxxxx" -Warn $true).AdditionalData
<!--NeedCopy-->

Plus d’informations