Citrix DaaS™

Crear catálogos con imágenes preparadas en AWS EC2

Cree imágenes preparadas y utilícelas para crear un catálogo de máquinas MCS mediante:

  • Studio
  • Comandos de PowerShell

Los pasos clave para crear un catálogo de máquinas MCS con la imagen preparada son:

  1. Crear la definición de imagen y las versiones iniciales de la imagen.
  2. Usar la versión de la imagen como imagen preparada para crear un catálogo

Crear una definición de imagen y la versión inicial de la imagen

Usar Studio

Para crear una definición de imagen y la versión inicial de la imagen, haga lo siguiente:

  1. En Studio, vaya al nodo Imágenes y haga clic en Crear definición de imagen. Haga clic en Siguiente en la página Introducción.
  2. En la página Definición de imagen, especifique el tipo de SO y el tipo de sesión para la definición de imagen.
  3. En la página Imagen, seleccione Recursos (solo se enumeran los recursos aplicables para la conexión establecida), una imagen maestra para usar como plantilla para crear la versión de la imagen y un perfil de máquina del que capturar las propiedades de hardware. Seleccione un perfil de máquina para capturar las propiedades de hardware de una instancia de VM o una versión de plantilla de lanzamiento.

    Nota:

    • Antes de seleccionar una imagen, verificar que la imagen maestra tenga VDA 2311 o posterior instalado y que el controlador MCSIO esté instalado en el VDA.
    • El Servicio de metadatos de instancia (IMDS) V1 y V2 son compatibles.
  4. En la página Especificación de la máquina, seleccione un tamaño de máquina. El tamaño de máquina del perfil de máquina (seleccionado en la página Imagen) se selecciona de forma predeterminada.
  5. En la página NICs, seleccione o añada NIC para la imagen de preparación. Para cada NIC, seleccione una subred de VPC asociada.
  6. En la página Descripción de la versión, introduzca una descripción para la versión de imagen inicial creada.
  7. En la página Resumen, compruebe los detalles de la definición de imagen y la versión de imagen inicial creada. Introduzca un nombre y una descripción para la definición de imagen. Haga clic en Finalizar.

Crear versiones de imagen

Las versiones de imagen permiten la gestión de diferentes iteraciones o actualizaciones de una imagen en particular. Esta funcionalidad le permite mantener varias versiones de una imagen para diferentes propósitos.

Para crear versiones de imagen a partir de la versión de imagen inicial, haga lo siguiente:

Nota:

La unidad de alojamiento de todas las versiones de imagen debe ser la misma.

  1. Vaya al nodo Imágenes, seleccione una versión de imagen o una definición de imagen y haga clic en Crear versión de imagen.
  2. En la página Definición de imagen, puede cambiar la unidad de alojamiento y volver a seleccionar la imagen maestra y el perfil de máquina para esa versión de imagen.
  3. Si desea que la configuración de la versión de imagen sea diferente de la versión de imagen configurada inicialmente, configure los ajustes en las páginas Especificación de la máquina y NICs del cuadro de diálogo Crear versión de imagen.
  4. Añada una descripción para la versión de imagen. Haga clic en Finalizar.

Nota:

Si la creación de la versión de la imagen falla por cualquier motivo, la pestaña Solucionar problemas en la parte inferior proporciona una opción de Reintentar.

Usar PowerShell

Los comandos detallados de PowerShell para crear una especificación de versión de imagen preparada son los siguientes:

  1. Compruebe los nombres de definición de imagen disponibles mediante Test-ProvImageDefinitionNameAvailable command. Por ejemplo,

    Test-ProvImageDefinitionNameAvailable -ImageDefinitionName <string[]>
    <!--NeedCopy-->
    
  2. Cree una definición de imagen mediante el comando New-ProvImageDefinition. Por ejemplo,

    New-ProvImageDefinition -ImageDefinitionName image1 -OsType Windows -VdaSessionSupport MultiSession
    <!--NeedCopy-->
    
  3. Cree una nueva configuración para la definición de imagen en la conexión de alojamiento especificada mediante el comando Add-ProvImageDefinitionConnection.

    Add-ProvImageDefinitionConnection -ImageDefinitionName image1 -HypervisorConnectionName test-conn
    <!--NeedCopy-->
    
  4. Cree una versión de imagen mediante el comando New-ProvImageVersion. Por ejemplo,

    New-ProvImageVersion -ImageDefinitionName image1 -Description "version 1"
    <!--NeedCopy-->
    
  5. Agregue una especificación de versión de imagen maestra a la versión de imagen mediante el comando Add-ProvImageVersionSpec. Por ejemplo,

    Add-ProvImageVersionSpec -ImageDefinitionName  image1  -ImageVersionNumber  1 -HostingUnitName aws -MasterImagePath "XDHyp:\HostingUnits\aws\win10-2411-ami (ami-00123456789abcdef).template”"
    <!--NeedCopy-->
    

    Nota:

    Solo puede agregar una especificación de versión de imagen maestra a una versión de imagen para una unidad de alojamiento.

  6. Cree una especificación de versión de imagen preparada a partir de la especificación de versión de imagen maestra mediante el comando New-ProvImageVersionSpec. El parámetro SourceImageVersionSpecUid se deriva del comando Add-ProvImageVersionSpec. Por ejemplo,

    New-ProvImageVersionSpec
    -SourceImageVersionSpecUid  00000000-0000-0000-0000-00000000000
    -MachineProfile 'XDHyp:\HostingUnits\aws\w2022-2411 (lt-00123456789abcdef).launchtemplate\lt-00123456789abcdef (1).launchtemplateversion' -RunAsynchronously
    <!--NeedCopy-->
    

Ejemplo del conjunto completo de comandos de PowerShell para crear una definición de imagen, una versión de imagen y una especificación de versión de imagen preparada:

New-ProvImageDefinition -ImageDefinitionName image1 -OsType Windows -VdaSessionSupport MultiSession


Add-ProvImageDefinitionConnection -ImageDefinitionName image1 -HypervisorConnectionName aws-CustomProperties $CustomProperties

$imageVersion = New-ProvImageVersion -ImageDefinitionName image1 -Description "version 1"

$SourceImageVersionSpec = Add-ProvImageVersionSpec -ImageVersionUid $imageVersion.ImageVersionUid `
    -HostingUnitUid $hostingunit.HostingUnitUid `
    -MasterImagePath "XDHyp:\HostingUnits\aws\win10-2411-ami (ami-00123456789abcdef).template”

New-ProvImageVersionSpec -MachineProfile 'XDHyp:\HostingUnits\aws\w2022-2411 (lt-00123456789abcdef).launchtemplate\lt-00123456789abcdef (1).launchtemplateversion' -SourceImageVersionSpecUid $SourceImageVersionSpec.ImageVersionSpecUid
Add-ProvImageVersionSpecHostingUnit -ImageVersionSpecUid 00000000-0000-0000-0000-00000000000-HostingUnitName aws
$PreparedImageVersionSpec = Get-ProvImageVersionSpec -ImageVersionUid $imageVersion.ImageVersionUid | Where SourceImageVersionSpecUid-eq $SourceImageVersionSpec.ImageVersionSpecUid
<!--NeedCopy-->

Nota:

  • Todas las especificaciones de versión de imagen en una definición de imagen deben pertenecer a la misma unidad de alojamiento.
  • Una versión de imagen solo puede tener una especificación de versión de imagen maestra y una especificación de versión de imagen preparada.
  • Todas las especificaciones de la versión de la imagen deben tener un perfil de máquina.

Compartir imágenes preparadas entre zonas de disponibilidad y regiones

Ahora puede compartir una única imagen preparada entre diferentes zonas de disponibilidad, vinculadas a diferentes unidades de alojamiento, dentro de la misma región de AWS o en diferentes regiones para sus entornos de AWS EC2. Esto le permite usar una imagen preparada para crear y actualizar catálogos de máquinas MCS en varias zonas de disponibilidad y regiones. Al compartir entre diferentes zonas de disponibilidad en diferentes regiones, la versión de la imagen preparada se copiará de la región original a las regiones de destino.

Puede mantener una única imagen preparada y usarla para crear y actualizar catálogos de máquinas en varias zonas de disponibilidad y regiones vinculadas a diferentes unidades de alojamiento. Esto reduce significativamente la sobrecarga de administración de imágenes, garantiza la coherencia en las implementaciones y agiliza el proceso de aprovisionamiento. También puede actualizar sin problemas los catálogos de máquinas existentes con imágenes preparadas de una zona de disponibilidad o región diferente.

Casos de uso

  • Administración centralizada de imágenes: Cree una imagen preparada en una zona de disponibilidad (por ejemplo, us-east-1a). A continuación, puede compartir esta imagen con otras zonas de disponibilidad como us-east-1b dentro de la misma región de AWS us-east-1 o us-west-1a en una región us-west-1 diferente. Esto permite que una sola imagen sirva a varias unidades de alojamiento y simplifica el mantenimiento.
  • Creación y actualizaciones eficientes de catálogos: Puede usar una imagen preparada creada en AZ 1 (por ejemplo, us-east-1a) para crear nuevos catálogos en AZ 1. Después de compartir esta imagen con AZ 2 (por ejemplo, us-east-1b), puede usar la imagen compartida en AZ 2 para crear y actualizar catálogos en AZ 2.
  • Implementaciones entre unidades de alojamiento y conexiones de alojamiento: Si su entorno tiene varias unidades de alojamiento en la misma región de AWS o en diferentes, puede compartir de forma eficiente las imágenes preparadas entre estas unidades de alojamiento.

Limitaciones

Compartir dentro de la misma cuenta de AWS: En la implementación actual, solo puede compartir dentro de la misma cuenta de AWS.

Consideraciones importantes

  • Orden de eliminación: Para eliminar una especificación de versión de imagen preparada original, primero debe eliminar todas sus especificaciones de versión de imagen compartidas. Alternativamente, debe eliminar las especificaciones originales y compartidas simultáneamente.
  • Dependencia de la versión de la imagen: Al eliminar una versión de imagen, primero debe eliminar cualquier configuración de uso compartido que dependa de esa versión de imagen específica. Los catálogos que creó a partir de la imagen original (no compartida) pueden permanecer intactos.
  • Compatibilidad con versiones anteriores del catálogo: Puede actualizar los catálogos de máquinas existentes que implementó antes de la introducción de esta función. Utilice imágenes preparadas que haya creado en una zona de disponibilidad o región diferente de donde implementó originalmente el catálogo.
  • Eliminación completa: Cuando elimina una imagen preparada, ya no puede usarla en ninguna zona de disponibilidad donde la compartió o la creó originalmente. Además, una versión de imagen preparada no se puede eliminar hasta que se eliminen primero todos los catálogos vinculados a esa versión de imagen preparada.

Requisitos previos

Antes de configurar o usar esta función, asegúrese de cumplir las siguientes condiciones:

  • Su entorno debe ser un entorno de AWS EC2.
  • Debe configurar varias unidades de alojamiento (cada una puede estar vinculada a diferentes zonas de disponibilidad) y conexiones de host (cada una puede estar vinculada a una región diferente) en la misma cuenta de AWS.

Configurar mediante PowerShell

Actualmente, solo puede compartir imágenes preparadas entre zonas de disponibilidad vinculadas a diferentes unidades de alojamiento mediante comandos de PowerShell.

Para compartir una imagen preparada

  1. Asegúrese de tener el ImageVersionSpecUid de la imagen preparada que quiere compartir. Puede recuperarlo mediante Get-ProvImageVersionSpec o comandos Get- similares en PowerShell.
  2. Determine el HostingUnitName de la zona de disponibilidad (puede ser la misma región o una diferente) donde quiere que la imagen preparada esté disponible. Este es el nombre de la unidad de alojamiento que configuró para esa zona de disponibilidad específica.
  3. Ejecute el comando Add-ProvImageVersionSpecHostingUnit: Utilice el siguiente comando de PowerShell. Sustituya <ImageVersionSpecUid> por el Uid de su imagen y <targetHostingUnitName> por el nombre de la unidad de alojamiento en la zona de disponibilidad de destino a la que quiere compartir la especificación de la versión de la imagen:

    Add-ProvImageVersionSpecHostingUnit -ImageVersionSpecUid <ImageVersionSpecUid> -HostingUnitName <targetHostingUnitName>
    <!--NeedCopy-->
    
  4. Después de una ejecución correcta, puede ver el estado de la imagen en la interfaz de usuario de Studio, lo que indica que la ha compartido con la unidad de alojamiento especificada.

Para dejar de compartir una imagen preparada

  1. Asegúrese de tener el ImageVersionSpecUid de la imagen preparada de la que quiere dejar de compartir.
  2. Determine el HostingUnitName de la zona de disponibilidad de la que quiere eliminar la imagen compartida.
  3. Ejecute el comando Remove-ProvImageVersionSpecHostingUnit: Utilice el siguiente comando de PowerShell. Sustituya <ImageVersionSpecUid> por el Uid de su imagen y <targetHostingUnitName> por el nombre de la unidad de alojamiento en la zona de disponibilidad de destino de la que quiere eliminar el uso compartido de la especificación de la versión de la imagen:

    Remove-ProvImageVersionSpecHostingUnit -ImageVersionSpecUid <ImageVersionSpecUid> -HostingUnitName <targetHostingUnitName>
    <!--NeedCopy-->
    

Crear un catálogo de máquinas

Usar Studio

Crear un catálogo de máquinas desde el nodo Imágenes

Use la opción Crear catálogo en el nodo Imágenes para crear un catálogo con la versión de la imagen.

También puede seleccionar la versión al crear un catálogo en el nodo Catálogos de máquinas, vinculando a la opción de imagen preparada en el flujo de trabajo de creación de catálogos. Consulte Crear un catálogo de máquinas desde el nodo Catálogos de máquinas.

Para crear un catálogo de máquinas MCS desde el nodo Imágenes, haga lo siguiente:

  1. Seleccione una versión de imagen y haga clic en Crear catálogo. Haga clic en Siguiente en la página Introducción.
  2. En las páginas Administración de máquinas e Imagen, la configuración está preseleccionada según la versión de imagen seleccionada. En la página Imagen, introduzca una nota para la imagen preparada seleccionada.
  3. Complete la configuración en las siguientes páginas.
  4. En la página Resumen, compruebe los detalles del catálogo de máquinas. Introduzca un nombre y una descripción para el catálogo de máquinas. Haga clic en Finalizar.
  5. Vaya al nodo Catálogos de máquinas para ver el catálogo de máquinas creado.

Crear un catálogo de máquinas desde el nodo Catálogos de máquinas

Para crear un catálogo de máquinas MCS desde el nodo Catálogos de máquinas, haga lo siguiente:

  1. Haga clic en Catálogos de máquinas en el panel de navegación izquierdo.
  2. Haga clic en Crear catálogo de máquinas. Aparece la página Configuración del catálogo de máquinas.
  3. En la página Tipo de máquina, seleccione un tipo de máquina para el catálogo, por ejemplo, SO multisesión.
  4. En la página Administración de máquinas, seleccione la siguiente configuración:

    1. Seleccione Máquinas con administración de energía (por ejemplo, máquinas virtuales o PC blade).
    2. Seleccione Tecnología de aprovisionamiento de Citrix. A continuación, seleccione Citrix Machine Creation Services™.
    3. En el campo Recursos, seleccione los recursos (Zona de disponibilidad) que configuró al crear la conexión de host y haga clic en Siguiente.
  5. En la página Experiencia de escritorio, seleccione un escritorio aleatorio o estático que los usuarios tendrán al iniciar sesión. Si se selecciona un escritorio estático, especifique además si desea guardar los cambios que el usuario realice en el disco local (persistente o no persistente).
  6. En la página Imagen, haga clic en Seleccionar una imagen para seleccionar una imagen preparada para el catálogo de máquinas. Seleccione la versión preparada que creó. Haga clic en el nombre de la versión de la imagen. Para ver más detalles sobre la versión de imagen seleccionada, haga clic en el número de versión, que está subrayado. Haga clic en Listo.

    Aparece el perfil de máquina asociado a la imagen preparada y sus propiedades de hardware (por ejemplo, tipo de instancia, tipo de tenencia, asignaciones de red, grupos de seguridad, propiedades de volumen) se utilizan para crear máquinas en los catálogos. Para cambiar el origen del perfil de máquina a otra VM o versión de plantilla de lanzamiento, haga clic en el botón de edición.

  7. En la página Máquinas virtuales:

    1. Introduzca el número de máquinas virtuales para el catálogo.
    2. Se muestra la especificación de máquina predeterminada, que se basa en el perfil de máquina. Para cambiarla, seleccione el icono de edición y seleccione una especificación de máquina.
  8. En la página NIC, seleccione las NIC (o ENI) para las máquinas virtuales.
  9. En la página Identidades de máquina, configure Active Directory local o Microsoft Entra híbrido unido para las máquinas del catálogo seleccionando el dominio y creando nuevas cuentas de AD para las máquinas virtuales que se crearán en este catálogo de máquinas. Las máquinas virtuales aprovisionadas se unen al dominio seleccionado. Especifique el esquema de nombres de cuenta para las nuevas cuentas de AD que se crearán para las máquinas virtuales. Haga clic en Siguiente.
  10. En la página Credenciales de dominio, haga clic en Introducir credenciales para proporcionar las credenciales del dominio seleccionado. Introduzca el nombre de usuario y la contraseña de nivel de administrador cuando se le solicite. También puede usar una cuenta de servicio si ya ha guardado credenciales de dominio anteriormente siguiendo nuestra (/es-es/citrix-daas/install-configure/on-premises-ad-service-accounts).
  11. Haga clic en las páginas restantes hasta llegar a la página Resumen. Introduzca un nombre para el catálogo de máquinas y seleccione Finalizar para crear el catálogo de máquinas.

Usar PowerShell

Crear un catálogo mediante una especificación de versión de imagen preparada y un perfil de máquina

  • Cree un catálogo de máquinas no persistentes de MCS a partir de la especificación de versión de imagen preparada mediante el comando New-ProvScheme. Por ejemplo,

     New-ProvScheme -ProvisioningSchemeName <string> -ImageVersionSpecUid <Guid> -HostingUnitUid <Guid> -IdentityPoolUid <Guid> [-CleanOnBoot $true] [-MachineProfile <string>] [-ProvisioningSchemeType “MCS”]
     <!--NeedCopy-->
    
  • Cree un catálogo de máquinas persistentes de MCS a partir de la especificación de versión de imagen preparada mediante el comando New-ProvScheme. Por ejemplo,

     New-ProvScheme -ProvisioningSchemeName <string> -ImageVersionSpecUid <Guid> -HostingUnitUid <Guid> -IdentityPoolUid <Guid> [-CleanOnBoot $false] [-MachineProfile <string>] [-ProvisioningSchemeType “MCS”]
     <!--NeedCopy-->
    

Ejemplo del conjunto completo de comandos de PowerShell para crear un catálogo:

$Catalog = New-BrokerCatalog  -AllocationType "Random"  -IsRemotePC $False  -MinimumFunctionalLevel "L7_20" -Name "awscatalog" -PersistUserChanges "Discard" -ProvisioningType "MCS" -Scope @() -SessionSupport "MultiSession"

$IdentityPool = New-AcctIdentityPool  -AllowUnicode  -Domain "domainname" -IdentityPoolName "awscatalog" -IdentityType "ActiveDirectory"  -NamingScheme "aws##" -NamingSchemeType "Numeric" -Scope @()

$PreparedImageVersionSpec = Get-ProvImageVersionSpec -ImageDefinitionName image1 -ImageVersionNumber 1 -Filter "PreparationType -eq 'Mcs'"

$Task = New-ProvScheme -ProvisioningSchemeName awscatalog -ImageVersionSpecUid $PreparedImageVersionSpec.ImageVersionSpecUid -HostingUnitName aws -IdentityPoolName awscatalog -CleanOnBoot -Scope @() -SecurityGroup @() -MachineProfile 'XdHyp:\HostingUnits\cvad-test-scalestress\us-east-1a.availabilityzone\machine-profile-instance i (i-0xxxxxxxx).vm' -RunAsynchronously

Get-ProvTask -TaskId $Task.TaskId
$ProvScheme = Get-ProvScheme -ProvisioningSchemeName awscatalog

Set-BrokerCatalog -Name $Catalog.Name -ProvisioningSchemeId $ProvScheme.ProvisioningSchemeUid
<!--NeedCopy-->

Pasos siguientes

Más información

Crear catálogos con imágenes preparadas en AWS EC2