26 de agosto de 2026

Arquitectura federada para Amazon Web Services o implementación de Horizon 8 en Amazon WorkSpaces Core: Descargar e implementar Horizon Edge Gateway

Puede descargar e implementar Horizon Edge Gateway en la implementación federada de Horizon 8 en Amazon Web Services (AWS) para emparejarla con Horizon Cloud. Puede utilizar este mismo procedimiento si va a implementar una instancia de Horizon Edge para Horizon 8 en Amazon WorkSpaces Core.

Siga estos pasos para descargar e implementar el dispositivo Horizon Edge Gateway para una implementación de Edge que utilice la arquitectura federada con la solución AWS.

Siga estos mismos pasos para descargar e implementar el dispositivo de Horizon Edge Gateway para una implementación de Edge para Horizon 8 en Amazon WorkSpaces Core.

En la arquitectura federada o para implementar Horizon 8 Edge en Amazon WorkSpaces Core, debe implementar Horizon Edge Gateway en la infraestructura nativa de Amazon Elastic Computer Cloud (EC2) dentro del entorno de su implementación de Edge en Horizon Cloud.

Requisitos

Debe cumplir los siguientes requisitos antes de continuar.

Compruebe que cumple los requisitos relacionados con Horizon Edge Gateway descritos en Introducción a la implementación de Horizon 8 Edge.
Compruebe que cumple las condiciones especificadas en Hacer que las URL de destino adecuadas sean accesibles para implementar Horizon Edge Gateway en un entorno de Horizon 8 para usar Horizon Edge Gateway para emparejar un pod de Horizon 8 con Horizon Cloud.
Compruebe que esté utilizando la versión adecuada de Horizon Edge Gateway. Consulte la Matriz de interoperabilidad de productos de Omnissa.
El dispositivo virtual de Horizon Edge Gateway debe tener acceso a Internet para poder comunicarse con Horizon Control Plane. Si en el entorno se requiere el uso de un servidor proxy y su correspondiente configuración para que los dispositivos implementados puedan acceder a Internet, al configurar el proxy con el dispositivo Horizon Edge Gateway, verifique que revisó la información relacionada con dicho proxy, así como las limitaciones y los problemas conocidos.
Si tiene pensado utilizar un proxy al emparejar su implementación de Edge utilizando el script configure-edge-gateway.sh, primero debe ejecutar el siguiente comando, especificando el valor true cuando ProxySSL está habilitado y especificando el valor false en el resto de casos:
```
/opt/horizon/bin/configure-edge-gateway.sh -p 'Pairing_Code' -x -i 'IP_or FQDN_of Proxy' -r 'Proxy_Port' -m 'Proxy_User_Name' -a 'Proxy_Password' -s 'true_or_false'
```
Consulte la información relacionada con el proxy en la siguiente nota.

Nota: Actualice la configuración del proxy en la instancia de Edge.
```
/opt/horizon/bin/configure-edge-gateway.sh --configure-proxy --proxy-host 127.0.0.1 --proxy-port 3128 --proxy-username 'exampleUsername' --proxy-password 'examplePassword'
```
Para explorar más opciones, ejecute el script con la opción -h, como se muestra a continuación.
```
/opt/horizon/bin/configure-edge-gateway.sh -h
```
Debe utilizar la línea de comandos para muchos de los pasos. Sin embargo, puede realizar algunos de los pasos de implementación mediante la consola de administración de AWS o la interfaz de línea de comandos (CLI) de AWS. Para obtener información detallada sobre cómo trabajar con un entorno de Amazon EC2, consulte la documentación de Amazon Elastic Compute Cloud en https://docs.aws.amazon.com/ec2/index.html. Los pasos que siguen suelen sugerir el tipo específico de documentación de Amazon Elastic Compute Cloud que se debe consultar.

Procedimiento

Descargue la imagen de disco de Horizon Edge Gateway siguiendo el paso para obtener el archivo binario del dispositivo Horizon Edge Gateway del procedimiento descrito en la página Agregar e implementar una instancia de Horizon 8 Edge. Responda a los avisos que aparecen en pantalla.

La imagen de disco/dispositivo Horizon Edge Gateway está disponible como archivo VMDK. Descargue el archivo VMDK en el sistema local.

Nota: Descargue la versión más reciente de la imagen de disco de Horizon Edge Gateway. Le recomendamos que utilice la versión más reciente del dispositivo Edge Gateway. Consulte información sobre versiones en la Matriz de interoperabilidad de productos de Omnissa.

Guarde el archivo binario descargado en una ubicación desde la que lo implementará en la plataforma de virtualización deseada y, a continuación, vuelva a esta secuencia de pasos para continuar con el proceso de emparejamiento requerido.

Antes de cargar el archivo de imagen de disco en el entorno de Amazon EC2, primero debe crear un bucket de Amazon S3.
Cree un bucket de Amazon S3 en el entorno de Amazon EC2. Para obtener instrucciones detalladas, consulte la documentación de Amazon Elastic Compute Cloud.
Cargue el archivo VMDK descargado en el bucket de Amazon S3. Puede realizar este paso mediante la consola de administración de AWS o la interfaz de línea de comandos (CLI) de AWS.
- (Consola de administración de AWS) Inicie sesión en la consola de administración de AWS del entorno de Amazon EC2. Vaya al servicio S3, seleccione el bucket que creó anteriormente y cargue el archivo VMDK en el depósito.
- (CLI de AWS) Acceda a la CLI de AWS y ejecute el siguiente comando.
```
aws s3 cp <file-path-to-VMDK-file> <S3URI>
```
  Consulte la documentación de Amazon Elastic Compute Cloud para obtener más información sobre la ejecución del comando cp.
En la consola de administración de AWS, el archivo VMDK se muestra en la pestaña Objetos.
Cree un rol de servicio y una directiva y asocie la directiva al rol.
1. Cree el primero de los tres nuevos archivos JSON necesarios para este procedimiento.
  
  El propósito de este archivo JSON es almacenar la información del rol de servicio. Asigne el nombre que desee al archivo. En este procedimiento, el nombre de archivo de ejemplo de este archivo es trust-policy.json.
  
  El siguiente texto es un ejemplo del contenido del archivo JSON.
```
{
    "Version":"2022-10-17",
    "Statement":[
        {
            "Sid":"",
            "Effect":"Allow",
            "Principal":{
                "Service":"vmie.amazonaws.com"
            },
            "Action":"sts:AssumeRole",
            "Condition":{
                "StringEquals":{
                    "sts:ExternalId":"vmimport"
                }
            }
        }
    ]
}
```
2. Cree un rol de servicio con el nombre que desee y almacene la información del rol en el nuevo archivo JSON.
  
  Por ejemplo, con la interfaz de línea de comandos, ejecute un comando como el siguiente.
  
  El siguiente comando es un ejemplo genérico.
```
aws iam create-role --role-name <role-name> --assume-role-policy-document <file-path>
```
  El siguiente comando de ejemplo reemplaza el marcador de posición <role-name> por el ejemplo específico vmimport y el marcador de posición <file-path> por el ejemplo específico trust-policy.json.
```
aws iam create-role --role-name vmimport --assume-role-policy-document file://trust-policy.json
```
  Consulte la documentación de Amazon Elastic Compute Cloud para obtener más información sobre la ejecución del comando create-role.
3. Cree el segundo de los tres nuevos archivos JSON necesarios para este procedimiento.
  
  Proporcione el nombre del bucket en el que cargará el archivo VMDK, como <bucket-name>, el nombre utilizado en el ejemplo que aparece a continuación.
  
  El propósito de este archivo JSON es asociar una nueva directiva con el nuevo rol. Asigne el nombre que desee al archivo. En este procedimiento, el nombre de archivo de ejemplo de este archivo es role-policy.json.
  
  El siguiente texto es un ejemplo del contenido del archivo role-policy.json.
```
{
    "Version":"2022-10-17",
    "Statement":[
        {
            "Effect":"Allow",
            "Action":[
                "s3:ListBucket",
                "s3:GetBucketLocation"
            ],
            "Resource":[
                "arn:aws:s3:::<bucket-name>"
            ]
        },
        {
            "Effect":"Allow",
            "Action":[
                "s3:GetObject"
            ],
            "Resource":[
                "arn:aws:s3:::<bucket-name>/*"
            ]
        },
        {
            "Effect":"Allow",
            "Action":[
                "ec2:ModifySnapshotAttribute",
                "ec2:CopySnapshot",
                "ec2:RegisterImage",
                "ec2:Describe*"
            ],
            "Resource":"*"
        }
    ]
}
```
4. Cree una directiva, asóciela al nuevo rol y guárdela en el archivo JSON recién creado.
  
  Por ejemplo, con la interfaz de línea de comandos, ejecute un comando como el siguiente.
  
  El siguiente comando es un ejemplo genérico.
```
aws iam put-role-policy --role-name <role-name> --policy-name <policy-name> --policy-document <file-path>
```
  El siguiente ejemplo específico reemplaza el marcador de posición <role-name> por un ejemplo específico de una directiva denominada vmimport, el marcador de posición <policy-name> por el ejemplo específico de la función mencionada anteriormente, que también se llama vmimport, y el marcador de posición <file-path> por el ejemplo específico del archivo JSON mencionado anteriormente, role-policy.json.
```
aws iam put-role-policy --role-name vmimport --policy-name vmimport --policy-document file://role-policy.json
```
  Consulte la documentación de Amazon Elastic Compute Cloud para obtener más información sobre la ejecución del comando put-role-policy.
Importe una instantánea del archivo VMDK importado.
1. Cree el tercero de los tres nuevos archivos JSON necesarios para este procedimiento.
  
  Incluya la siguiente información en el archivo.
  - El nombre del bucket, como <bucket-name>, que se utiliza en el siguiente ejemplo.
  - El nombre del archivo VMDK que cargó en el bucket de Amazon S3, como <vmdk-file-name-uploaded-to-S3>, que se utiliza en el siguiente ejemplo.
  El propósito de este archivo JSON es almacenar la instantánea del archivo VMDK importado. Asigne el nombre que desee al archivo. En este procedimiento, el nombre de archivo de ejemplo de este archivo es container.json.
  
  El siguiente texto es un ejemplo del contenido del archivo container.json.
```
{
    "Description": "Adapter-VM",
    "Format": "vmdk",
    "UserBucket": {
        "S3Bucket": "<bucket-name>",
        "S3Key": "<vmdk-file-name-uploaded-to-S3>"
    }
}
```
2. Ejecute el comando para importar la instantánea del archivo VMDK importado al archivo JSON recién creado.
  
  Con la CLI, ejecute el siguiente tipo de comando.
```
aws ec2 import-snapshot --role-name <role-name> --description <description> --disk-container <file-path>
```
  Consulte la documentación de Amazon Elastic Compute Cloud para obtener más información sobre la ejecución del comando import-snapshot.
  
  El siguiente comando es un ejemplo específico del comando import-snapshot, donde el parámetro role-name es opcional y no se utiliza, la descripción es "Adapter-VM" y el nombre de archivo del contenedor es container.json.
```
aws ec2 import-snapshot --description "Adapter-VM" --disk-container file://container.json
```
  El comando import-snapshot puede tardar unos minutos en completarse. Sin embargo, después de ejecutar el comando, el comando genera un resultado, que incluye una línea ImportTaskId que puede utilizar para realizar un seguimiento del progreso de la tarea. El siguiente resultado es un ejemplo.
```
{
    "ImportTaskId": "import-snap-05b4c84af4xxxxxxx",
    "Description": "Adapter-VM",
    "SnapshotTaskDetail": {
        "StatusMessage": "pending",
        "UserBucket": {
              "S3Bucket": "awsbucket",
             "S3Key": "edge-gw-2.3.3.0-22720582.ec2.vmdk"
         },
       "Progress": "0",
       "Status": "active",
        "Description": "Adapter-VM",
        "DiskImageSize": 0.0
    }
    
}
```
3. Tome nota del valor de ImportTaskId en el resultado del comando import-snapshot.
Para realizar un seguimiento del progreso de la tarea import-snapshot y obtener el identificador de instantánea, ejecute el siguiente comando.
```
aws ec2 describe-import-snapshot-tasks --import-task-ids <import-task-id>
```
Reemplace el marcador de posición <import-task-id> por el valor indicado en el resultado del comando import-snapshot. El valor de ejemplo indicado en el resultado de ejemplo anterior es import-snap-05b4c84af4xxxxxxx. Consulte la documentación de Amazon Elastic Compute Cloud para obtener más información sobre la ejecución del comando describe-import-snapshot-tasks.

El comando describe-import-snapshot-tasks proporciona un resultado que indica el progreso de la tarea import-snapshot y, cuando se completa la tarea, proporciona el identificador de instantánea, que es necesario para registrar la imagen. Por ejemplo.
- "Progress": "43". Una línea en el resultado, como esta, indica el porcentaje de progreso de la tarea import-snapshot. En este ejemplo, la tarea está completada en un 43 %.
- "Status": "completed". Una línea en el resultado, como esta, indica que se completó la tarea import-snapshot.
- "SnapshotId": "snap-06d42e043bxxxxxxx". Cuando se completa la tarea, se incluye una línea en el resultado, como esta. En este ejemplo, el identificador de instantánea es snap-06d42e043bxxxxxxx.
Tome nota del identificador de instantánea del resultado del comando describe-import-snapshot-tasks.
Para registrar la imagen de instantánea, ejecute el comando register-image.
```
aws ec2 register-image --region us-west-2 --name <image-name> --architecture x86_64 --root-device-name '/dev/sda1' --virtualization-type hvm --ena-support --block-device-mappings DeviceName=/dev/sda1,Ebs={SnapshotId=<SnapshotId>} 
```
Donde debe proporcionar respuestas específicas de su implementación para cada opción, como --region, --architecture y otros valores. Consulte la documentación de Amazon Elastic Compute Cloud para obtener más información sobre la ejecución del comando register-image.

La siguiente información es específica de la opción --name y el parámetro SnapshotId.
- --name: proporcione un nombre para la imagen de acuerdo con las restricciones de la cadena.
- SnapshotId: proporcione el identificador de instantánea del resultado del comando describe-import-snapshot-tasks. El comando register-image proporciona una salida que incluye el identificador de la AMI (Amazon Machine Image). A continuación se incluye un resultado de register-image habitual.
```
 {
        "ImageId": "ami-0721ee000321c4685"
    }
```
La AMI indicada en la salida del comando register-image también aparece en la consola de administración de AWS entre la lista de AMI.
Para admitir la creación y configuración de la instancia de AMI de Horizon Edge Gateway, prepare un script de inicio similar al siguiente ejemplo.
```
#!/bin/bash
/opt/horizon/bin/configure-adapter.py --sshEnable
echo -e '<password>\n<password>' | passwd admin
echo -e '<password>\n<password>' | passwd ccadmin
echo 'cs_ip cs_fqdn' >> /etc/hosts
```
En el ejemplo, el script admite las siguientes configuraciones:
- Habilitación del acceso SSH al dispositivo Horizon Edge Gateway.
- Creación de una cuenta de usuario admin en el dispositivo con la contraseña definida (\n). Asegúrese de definir una contraseña segura. Las contraseñas seguras tienen al menos 8 caracteres y deben incluir uno o varios números, letras mayúsculas y minúsculas, y caracteres especiales.
- Creación de una cuenta de usuario ccadmin en el dispositivo con la contraseña definida (\n). Asegúrese de definir una contraseña segura. Las contraseñas seguras tienen al menos 8 caracteres y deben incluir uno o varios números, letras mayúsculas y minúsculas, y caracteres especiales.
- Resolución del nombre de host de Connection Server (cs_fqdn) en la dirección IP de Connection Server (cs_ip). Debe agregar este script a user-data en el siguiente paso, en el que iniciará la instancia de AMI de Horizon Edge Gateway.
Inicie la instancia de AMI para Horizon Edge Gateway.

Nota: Para asegurarse de que la instancia de proporciona suficientes capacidades, utilice el modelo c5.2xlarge o una versión posterior.

Puede iniciar una instancia mediante la CLI o la consola de administración de AWS. En cualquier caso, utilice el identificador de imagen de máquina de Amazon (AMI) proporcionado en la salida del comando register-image y agregue el script de inicio que preparó en el paso anterior a user-data.

Nota: Debe agregar el script de inicio en este momento porque user-data solo se ejecuta en la primera secuencia de arranque de la instancia de AMI.

Para utilizar la CLI, consulte la documentación de Amazon Elastic Compute Cloud para obtener más información sobre la ejecución del comando run-instances.

Para utilizar la consola de administración de AWS, consulte la documentación de Amazon Elastic Compute Cloud para obtener más información, como iniciar una instancia de mediante el asistente de inicio de instancias.

Si decide iniciar la instancia de mediante la consola de administración de AWS, busque la nueva AMI mediante el identificador de imagen, seleccione la AMI y haga clic en Iniciar. A continuación, puede continuar a través del asistente proporcionando los detalles específicos de la implementación.
Después de iniciar la AMI de Horizon Edge Gateway, edite la configuración de la instancia de máquina virtual y elimine el script de inicio.
SSH a la instancia de AWS de la máquina virtual de Horizon Edge Gateway.

Para utilizar la CLI o la consola de administración de AWS, consulte la documentación de Amazon Elastic Compute Cloud para obtener más información sobre la conexión a la instancia. Se recomienda utilizar SSH para permitir copiar y pegar la clave de emparejamiento.

Para obtener información relacionada, consulte Habilitar el acceso de SSH para Horizon Edge.

Para obtener información relacionada, consulte también Conexión a la instancia de Linux y Conexión a la instancia de Linux con EC2 Instance Connect en la documentación del producto de AWS.
Ejecute un script de emparejamiento de instancias de Edge utilizando el siguiente formato de comando, donde pairing_code es el código de emparejamiento que copió de la captura de pantalla del Paso 9 descrito en Agregar e implementar una instancia de Horizon 8 Edge.
```
sudo su -
/opt/horizon/bin/configure-edge-gateway.sh -p <pairing_code>
```
Para mejorar la seguridad, considere la posibilidad de desactivar SSH cuando haya completado estos pasos.
Vuelva a Horizon Universal Console para completar la configuración de los detalles de Horizon Connection Server. Consulte Agregar e implementar una instancia de Horizon 8 Edge.

¿Le resultó útil esta página?

Arquitectura federada para Amazon Web Services o implementación de Horizon 8 en Amazon WorkSpaces Core: Descargar e implementar Horizon Edge Gateway

Requisitos

Procedimiento

Enviar comentarios sobre este tema

Escriba su reseña