Documentación de productos
Citrix Virtual Apps and Desktops
Service Current Release 2311 2308 2305 2303 2212 2209 2206 2203 LTSR 1912 LTSR
Ver PDF

Crear un catálogo de AWS

February 15, 2024
Contribución de: 
C

Crear catálogos de máquinas describe los asistentes con los que se crea un catálogo de máquinas. La siguiente información incluye detalles específicos de los entornos de virtualización de AWS.

Nota:

Antes de crear un catálogo de AWS, debe terminar de crear una conexión con AWS. Consulte Conexión con AWS.

Configuración de la red durante la preparación de imágenes

Durante la preparación de la imagen, se crea una máquina virtual (VM) de preparación basada en la máquina virtual original. Esta máquina virtual de preparación está desconectada de la red. Para desconectar la red de la máquina virtual de preparación, se crea un grupo de seguridad de red para denegar todo el tráfico entrante y saliente. Este grupo de seguridad de red persiste y se reutiliza. El nombre del grupo de seguridad de red es Citrix.XenDesktop.IsolationGroup-GUID, donde el GUID se genera aleatoriamente.

Configurar el arrendamiento de AWS

AWS ofrece las siguientes opciones de arrendamiento:

  • Arrendamiento compartido (el tipo predeterminado): Varias instancias de Amazon EC2 de diferentes clientes pueden residir en el mismo hardware físico.
  • Arrendamiento dedicado: Sus instancias de EC2 se ejecutan únicamente en hardware con otras instancias que haya implementado. Los demás clientes no utilizan el mismo hardware.

Puede usar MCS para aprovisionar hosts dedicados de AWS a través de PowerShell.

Configurar el arrendamiento de host dedicado de AWS mediante PowerShell

Puede crear un catálogo de máquinas con el arrendamiento del host definido a través de PowerShell.

Un host dedicado Amazon [EC2] es un servidor físico con una capacidad de instancia [EC2] totalmente dedicada, lo que permite utilizar licencias de software por socket o por máquina virtual existente.

Los hosts dedicados tienen una utilización predeterminada basada en el tipo de instancia. Por ejemplo: un único host dedicado asignado de los tipos de instancia C4 Large está limitado a ejecutar 16 instancias. Consulte el sitio de AWS para obtener más información.

Los requisitos para el aprovisionamiento a los hosts AWS son:

  • Una imagen (AMI) importada de BYOL (bring your own license). Con hosts dedicados, puede usar y administrar sus licencias existentes.
  • Una asignación de hosts dedicados con suficiente utilización para abarcar las solicitudes de aprovisionamiento.
  • Habilite auto-placement.

Para aprovisionar a un host AWS dedicado mediante PowerShell, utilice el cmdlet New-ProvScheme con el parámetro TenancyType establecido en Host.

Consulte la documentación para desarrolladores de Citrix para obtener más información.

Capture las propiedades de la máquina desde las AMI

Cuando crea un catálogo para aprovisionar máquinas con Machine Creation Services (MCS) en AWS, selecciona una imagen AMI que represente la imagen maestra de ese catálogo. A partir de esa imagen AMI, MCS utiliza una instantánea del disco. En versiones anteriores, si quería incluir roles o etiquetas en sus máquinas, tenía que usar la consola de AWS para definirlos individualmente. Esta funcionalidad está habilitada de forma predeterminada.

Sugerencia:

Para utilizar la captura de propiedades de instancias de AWS, debe tener una máquina virtual asociada a la imagen AMI.

Para mejorar este proceso, MCS lee las propiedades de la instancia de la que se obtuvo la imagen AMI y aplica el rol y etiquetas de IAM (Administración de acceso e identidad) de la máquina a las máquinas aprovisionadas de un catálogo determinado. Cuando se utiliza esta función opcional, el proceso de creación de catálogos busca la instancia AMI de origen seleccionada, leyendo un conjunto limitado de propiedades. Estas propiedades se almacenan en una plantilla de inicio de AWS, que sirve para aprovisionar las máquinas de ese catálogo. Cualquier máquina del catálogo heredará las propiedades de instancia capturadas.

Las propiedades capturadas incluyen:

  • Roles de IAM: Aplicados a las instancias aprovisionadas.
  • Etiquetas: Aplicadas a las instancias aprovisionadas, su disco y NIC. Estas etiquetas se aplican a los recursos transitorios de Citrix, incluidos: el depósito y objetos de S3, imágenes AMI, instantáneas y plantillas de inicio.

Sugerencia:

El etiquetado de los recursos transitorios de Citrix es optativo y se puede configurar mediante la propiedad personalizada AwsOperationalResourcesTagging.

Capturar la propiedad de instancia de AWS

Puede utilizar esta funcionalidad especificando una propiedad personalizada, AwsCaptureInstanceProperties, al crear un esquema de aprovisionamiento para una conexión de host de AWS:

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

Consulte la documentación para desarrolladores de Citrix para obtener más información.

Nota:

AwsCaptureInstanceProperties se ha retirado.

Capture las propiedades de la máquina desde los perfiles de la máquina

Al crear un catálogo para aprovisionar máquinas de AWS mediante MCS, puede usar un perfil de máquina para preestablecer ciertos parámetros de propiedades de la máquina.

Para ello, siga estos pasos:

  1. Almacene los perfiles de las máquinas en la misma zona de disponibilidad que los recursos en los que va a crear este catálogo.
  2. En la página Plantilla de máquina del asistente de creación de catálogos, seleccione Usar un perfil de máquina. Se muestran los perfiles de máquina que se encuentran en la misma zona disponible que los recursos que seleccionó.
  3. Seleccione un perfil de máquina según sea necesario.

Nota:

Puede usar un perfil de máquina o una AMI para capturar las propiedades de la máquina. En Web Studio, al seleccionar Usar un perfil de máquina, la opción Aplicar propiedades de plantilla de máquina a máquinas virtuales se oculta automáticamente.

Etiquetar un recurso operativo de AWS

Al crear un catálogo para aprovisionar máquinas mediante MCS en AWS, puede decidir si aplicar las propiedades de etiqueta y el rol de IAM a esas máquinas. También puede decidir si aplicar etiquetas de máquina a los recursos operativos.

Una imagen AMI (Amazon Machine Image) representa un tipo de dispositivo virtual utilizado para crear una máquina virtual dentro del entorno de Amazon Cloud, conocido comúnmente como EC2. Puede utilizar una imagen AMI para implementar servicios que utilicen el entorno EC2. Cuando crea un catálogo para aprovisionar máquinas con MCS en AWS, selecciona una imagen AMI que sirve de imagen maestra para ese catálogo.

Importante:

La creación de catálogos mediante la captura de una propiedad de instancia y una plantilla de inicio es necesaria para utilizar el etiquetado de recursos operativos.

Para crear un catálogo de AWS, primero debe crear una imagen AMI de la instancia que quiere que sirva de imagen maestra. MCS lee las etiquetas de esa instancia y las incorpora a la plantilla de inicio. A continuación, las etiquetas de la plantilla de inicio se aplican a todos los recursos de Citrix creados en su entorno de AWS, incluidos:

  • Máquinas virtuales
  • Discos de VM
  • Interfaces de red de VM
  • Depósitos de S3
  • Objetos de S3
  • Plantillas de lanzamiento
  • Imágenes AMI

Etiquetar un recurso operativo

Para usar PowerShell para etiquetar recursos:

  1. Abra una ventana de PowerShell desde el host de DDC (Desktop Delivery Controller).
  2. Ejecute el comando asnp citrix para cargar módulos de PowerShell específicos de Citrix.

Para etiquetar un recurso para una máquina virtual aprovisionada, utilice la nueva propiedad personalizada AwsOperationalResourcesTagging. La sintaxis de esta propiedad es:

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

Qué hacer a continuación

Copiar etiquetas en máquinas virtuales

Puede copiar las etiquetas de las NIC y los discos (disco de identidad, disco de caché de reescritura y disco de sistema operativo) que se especifican en el perfil de la máquina a las máquinas virtuales recién creadas en un catálogo de máquinas de MCS. Puede especificar estas etiquetas en cualquiera de las fuentes de perfiles de máquinas (instancia de máquina virtual de AWS o versión de plantilla de lanzamiento de AWS). Esta función se aplica a máquinas virtuales y catálogos de máquinas persistentes y no persistentes.

Nota:

  • En la consola AWS EC2, no puede ver los valores de Etiquetar interfaces de red en las etiquetas de recursos de la versión de la plantilla de lanzamiento. Sin embargo, puede ejecutar el comando de PowerShell aws ec2 describe-launch-template-versions --launch-template-id lt-0bb652503d45dcbcd --versions 12 para ver las especificaciones de las etiquetas.
  • Si un origen de perfil de máquina (máquina virtual o versión de plantilla de lanzamiento) tiene dos interfaces de red (eni-1 y eni-2), y eni-1 tiene la etiqueta t1 y eni-2 tiene la etiqueta t2, la VM obtiene las etiquetas de las dos interfaces de red.

Crear un catálogo mediante un perfil de máquina

Al crear un catálogo para aprovisionar máquinas mediante Machine Creation Services (MCS) en AWS, ahora puede usar un perfil de máquina para capturar las propiedades del hardware de una instancia de EC2 (VM) o versión de plantilla de inicio y aplicarlas a las máquinas aprovisionadas. Las propiedades que se capturan pueden incluir, por ejemplo, las propiedades del volumen de EBS, el tipo de instancia, la optimización de EBS y otras configuraciones de AWS compatibles. Al modificar el catálogo, se puede cambiar el perfil de máquina de las máquinas aprovisionadas proporcionando una máquina virtual o una plantilla de inicio diferentes.

Nota:

Las propiedades del volumen de EBS se derivan únicamente de un perfil de máquina.

Consideraciones importantes

Consideraciones importantes a la hora de crear un catálogo de máquinas de MCS:

  • Si agrega parámetros de propiedades de hardware de máquina en los comandos New-ProvScheme y Set-ProvScheme, los valores proporcionados en los parámetros sobrescriben los valores del perfil de máquina.
  • Si asigna a AwsCaptureInstanceProperties el valor true y no establece la propiedad MachineProfile, solo se capturarán los roles y etiquetas de IAM.

  • No puede establecer AwsCaptureInstanceProperties y MachineProfile al mismo tiempo.

    **Nota:

    AwsCaptureInstanceProperties se ha retirado.

  • Debe proporcionar de forma explícita los valores de las siguientes propiedades:

    • TenancyType
    • Grupo de seguridad
    • NIC o red virtual
  • Solo puede habilitar AwsOperationalResourcesTagging si habilita AwsCaptureInstanceProperties o especifica un perfil de máquina.

Consideraciones importantes después de crear un catálogo de máquinas de MCS:

  • El cambio solo afecta a las nuevas máquinas virtuales agregadas al catálogo.
  • No puede cambiar un catálogo de un catálogo basado en perfiles de máquinas a uno que no esté basado en perfiles de máquinas.

Crear un catálogo de máquinas mediante un perfil de máquina

Para crear un catálogo de máquinas mediante un perfil de máquina

  1. Abra una ventana de PowerShell.
  2. Ejecute asnp citrix* para cargar los módulos de PowerShell específicos de Citrix.

  3. Cree un grupo de identidades si aún no se ha creado. Por ejemplo,

    New-AcctIdentityPool -IdentityPoolName idPool -NamingScheme ms## -Domain abcdf -NamingSchemeType Numeric
<!--NeedCopy-->

  4. Ejecute el comando New-ProvScheme. Por ejemplo:

    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. Complete la creación del catálogo. Para obtener más información, consulte SDK de PowerShell de Citrix.

Para actualizar el perfil de máquina en un catálogo al que inicialmente se aprovisionó un perfil de máquina:

  1. Ejecute el comando Set-ProvScheme. Por ejemplo,

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

Crear un catálogo con una versión de plantilla de inicio

Puede crear un catálogo de máquinas de MCS con una versión de plantilla de inicio como entrada del perfil de máquina. También puede actualizar la entrada de un catálogo de perfiles de máquina de una máquina virtual a una versión de plantilla de inicio y de una versión de plantilla de inicio a una máquina virtual.

En la consola EC2 de AWS, puede proporcionar la información de configuración de instancia de una plantilla de inicio junto con el número de versión. Cuando se especifica la versión de la plantilla de inicio como entrada del perfil de máquina al crear o actualizar un catálogo de máquinas, las propiedades de esa versión de la plantilla de inicio se copian en las máquinas virtuales con VDA aprovisionadas.

Las siguientes propiedades se pueden proporcionar mediante la entrada del perfil de máquina o de forma explícita como parámetros en los comandos New-ProvScheme y Set-ProvScheme. Si se proporcionan en los comandos New-ProvScheme o Set-ProvScheme, tienen prioridad sobre los valores de estas propiedades del perfil de máquina.

  • Oferta de servicios
  • Redes
  • Grupos de seguridad
  • Tipo de arrendamiento

Nota:

Si la oferta de servicios no se proporciona en la plantilla de inicio del perfil de la máquina o como parámetro del comando New-ProvScheme, aparecerá el error correspondiente.

Para crear un catálogo con la versión de la plantilla de inicio como entrada del perfil de máquina:

  1. Abra una ventana de PowerShell.
  2. Ejecute asnp citrix* para cargar los módulos de PowerShell específicos de Citrix.

  3. Obtenga la lista de versiones de una plantilla de inicio. Por ejemplo:

    XDHyp:\HostingUnits\test\test-mp-sard (lt-01xxxxx).launchtemplate> ls | Select FullPath
<!--NeedCopy-->

  4. Cree un grupo de identidades si no se ha creado. Por ejemplo:

    New-AcctIdentityPool `
-IdentityPoolName "abc11" `
-NamingScheme "abc1-##" `
-NamingSchemeType Numeric `
-Domain "citrix-xxxxxx.local" `
-ZoneUid "xxxxxxxx" `
<!--NeedCopy-->

  5. Cree un esquema de aprovisionamiento con una versión de plantilla de inicio como entrada del perfil de máquina. Por ejemplo:

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

    También puede anular parámetros como la oferta de servicios, los grupos de seguridad, el arrendamiento y las redes. Por ejemplo:

    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. Registre el esquema de aprovisionamiento como un catálogo de broker. Por ejemplo:

    New-BrokerCatalog -Name "MPLT1" `
-AllocationType Random `
-Description "Machine profile catalog" `
-ProvisioningSchemeId fe7df345-244e-4xxxx-xxxxxxxxx `
-ProvisioningType Mcs `
-SessionSupport MultiSession `
-PersistUserChanges Discard
<!--NeedCopy-->
  7. Complete la creación del catálogo. Para obtener más información, consulte SDK de PowerShell de Citrix

También puede actualizar la entrada de un catálogo de perfiles de máquina de una máquina virtual a una versión de plantilla de inicio y de una versión de plantilla de inicio a una máquina virtual. Por ejemplo:

  • Para actualizar la entrada de un catálogo de perfiles de máquina de una VM a una versión de plantilla de inicio:

     Set-ProvScheme -ProvisioningSchemeName "CloudServiceOfferingTest" `
 -MachineProfile "XDHyp:\HostingUnits\xxxx-ue1a\machineprofiletest (lt-0bxxxxxxxxxxxx).launchtemplate\lt-0bxxxxxxxxxxxx (1).launchtemplateversion"
 <!--NeedCopy-->

  • Para actualizar la entrada de un catálogo de perfiles de máquina de una versión de plantilla de inicio a una VM:

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

Filtrar instancias de VM

Una instancia de máquina virtual de AWS EC2 que utilice como máquina virtual de perfil de máquina debe ser compatible para que el catálogo de máquinas se cree y funcione correctamente. Para enumerar las instancias de máquinas virtuales de AWS EC2 que se pueden usar como máquinas virtuales de entrada de perfil de máquina, puede usar el comando Get-HypInventoryItem. El comando puede buscar en páginas y filtrar el inventario de máquinas virtuales disponibles en una unidad de alojamiento.

Paginación:

Get-HypInventoryItem admite dos modos de paginación:

  • El modo de paginación utiliza los parámetros -MaxRecords y -Skip para devolver conjuntos de elementos:
    • -MaxRecords: El valor predeterminado es 1. Esto controla la cantidad de elementos que devolverán.
    • -Skip: El valor predeterminado es 0. Esto controla la cantidad de elementos que se deben omitir desde el principio absoluto (o el final absoluto) de la lista en el hipervisor.
  • El modo de desplazamiento utiliza los parámetros -MaxRecords, -ForwardDirection y -ContinuationToken para permitir el desplazamiento por los registros:
    • -ForwardDirection: El valor predeterminado es True. Esto se usa junto con -MaxRecords para devolver el siguiente conjunto de registros coincidentes o el conjunto anterior de registros coincidentes.
    • -ContinuationToken: Devuelve los elementos inmediatamente después (o antes si ForwardDirection es false), pero sin incluir el elemento indicado en ContinuationToken.

Ejemplos de paginación:

  • Para devolver un solo registro de la plantilla de máquina con el nombre más bajo. El campo AdditionalData tiene TotalItemsCount y TotalFilteredItemsCount:

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

  • Para devolver diez registros de la plantilla de máquina con el nombre más bajo:

     Get-HypInventoryItem -LiteralPath "XDHyp:\HostingUnits\ctx-test" -ResourceType template -MaxRecords 10 | select Name
 <!--NeedCopy-->

  • Para devolver una matriz de registros que termine con el nombre más alto:

     Get-HypInventoryItem -LiteralPath "XDHyp:\HostingUnits\ctx-test" -ResourceType template -ForwardDirection $False -MaxRecords 10 | select Name
 <!--NeedCopy-->

  • Para devolver una matriz de registros que comience en la plantilla de máquina asociada al ContinuationToken correspondiente:

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

Filtros:

Se admiten estos parámetros opcionales adicionales para el filtrado. Puede combinar estos parámetros con las opciones de paginación.

  • -ContainsName "my_name": Si la cadena dada coincide con parte del nombre de una AMI, la AMI se incluye en el resultado de Get. Por ejemplo:

     Get-HypInventoryItem -LiteralPath "XDHyp:\HostingUnits\ctx-test" -ResourceType template -MaxRecords 100 -ContainName ‘apollo’ | select Name
 <!--NeedCopy-->

  • -Tags '{ "Key0": "Value0", "Key1": "Value1", "Key2": "Value2" }': Si una AMI tiene al menos una de estas etiquetas, se incluye en el resultado de Get . Por ejemplo:

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

    Nota:

    Se admiten dos valores de etiqueta. El valor de la etiqueta Not Tagged coincide con elementos que no tienen la etiqueta especificada en su lista de etiquetas. El valor de la etiqueta All values coincide con elementos que tienen la etiqueta, independientemente del valor de la etiqueta. De lo contrario, la coincidencia solo se produce si el elemento tiene la etiqueta y el valor es igual al indicado en el filtro.

  • -Id "ami-0a2d913927e0352f3": Si la AMI coincide con el ID proporcionado, se incluye en el resultado de Get. Por ejemplo:

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

Filtrado en el parámetro AdditionalData:

El parámetro de filtrado AdditionalData muestra plantillas o máquinas virtuales en función de su capacidad, oferta de servicio o cualquier propiedad que se encuentre en AdditionalData. Por ejemplo:

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

También puede agregar un parámetro -Warn para indicar las máquinas virtuales incompatibles. Las máquinas virtuales se incluyen en un campo de AdditionalData denominado Warning. Por ejemplo:

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

Más información

Crear un catálogo de AWS
February 15, 2024
Contribución de: 
C
February 15, 2024
Contribución de: 
C

En este artículo

Comentarios sobre el sitio | Condiciones legales y de privacidad | Preferencias de cookies | Parámetros de consentimiento | docs.cloud.com
© 1999- Cloud Software Group, Inc. All rights reserved.