Crear un catálogo de AWS
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. En su lugar, recomendamos usar perfiles de máquina para especificar las propiedades de las máquinas virtuales.
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:
- 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.
- 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ó.
- 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:
- Abra una ventana de PowerShell desde el host de DDC (Desktop Delivery Controller).
- 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
- Si este es el primer catálogo creado, Web Studio le guiará para crear un grupo de entrega
- Para revisar todo el proceso de configuración, consulte Instalar y configurar
- Para administrar catálogos, consulte Administrar catálogos de máquinas y Administrar un catálogo de AWS
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. No obstante, 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 inicio) 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
ySet-ProvScheme
, los valores proporcionados en los parámetros sobrescriben los valores del perfil de máquina. - Si asigna a
AwsCaptureInstanceProperties
el valortrue
y no establece la propiedadMachineProfile
, solo se capturarán los roles y etiquetas de IAM. -
No puede establecer
AwsCaptureInstanceProperties
yMachineProfile
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 habilitaAwsCaptureInstanceProperties
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
- Abra una ventana de PowerShell.
- Ejecute
asnp citrix*
para cargar los módulos de PowerShell específicos de Citrix. -
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-->
-
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-->
- 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:
-
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:
- Abra una ventana de PowerShell.
- Ejecute
asnp citrix*
para cargar los módulos de PowerShell específicos de Citrix. -
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-->
-
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-->
-
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-->
-
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-->
- 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 siForwardDirection
es false), pero sin incluir el elemento indicado enContinuationToken
.
-
Ejemplos de paginación:
-
Para devolver un solo registro de la plantilla de máquina con el nombre más bajo. El campo
AdditionalData
tieneTotalItemsCount
yTotalFilteredItemsCount
: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 deGet
. 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 deGet
. 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 deGet
. 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
En este artículo
- Configuración de la red durante la preparación de imágenes
- Configurar el arrendamiento de AWS
- Capture las propiedades de la máquina desde las AMI
- Capture las propiedades de la máquina desde los perfiles de la máquina
- Etiquetar un recurso operativo de AWS
- Qué hacer a continuación
- Copiar etiquetas en máquinas virtuales
- Crear un catálogo mediante un perfil de máquina
- Filtrar instancias de VM
- Más información