Agregar e implementar una instancia de Horizon Edge para OpenStack

Puede agregar e implementar una instancia de Horizon Edge para los tipos de capacidad de Horizon Cloud on OpenStack (implementación administrada por el cliente o Platform9 Private Cloud Director). A continuación, puede configurar Unified Access Gateway (UAG) para la instancia de Edge.

Nota: Horizon Cloud on OpenStack solo está disponible actualmente en modo de disponibilidad limitada (LA).

Requisitos generales

Configure los requisitos para Horizon Cloud Service, Unified Access Gateway (UAG) y Private Cloud Director.

• Revise y complete el proceso de acceso a Horizon Cloud descrito en Implementaciones de Horizon Cloud on OpenStack Edge, incluido el proceso de incorporación.

• Revise y cumpla los requisitos de indicados en Lista de comprobación de requisitos para implementar Horizon Cloud on OpenStack Edge y Requisitos de puertos y protocolos para Horizon Cloud on OpenStack Edge en el documento Introducción a Horizon Cloud.

• Determine el nombre de dominio completo (FQDN) que utilizará para el dispositivo Horizon Edge Gateway implementado. El asistente de la interfaz de usuario le pide que introduzca ese FQDN. Como referencia, consulte el artículo del foro de la comunidad de Omnissa Understanding Omnissa Horizon Edge Gateway: Purpose, Architecture & Best Practices (en inglés).

• Debe cumplir los requisitos de Private Cloud Director (PCD) en la siguiente sección.

Requisitos de Private Cloud Director

Si va a crear una instancia de Horizon Edge para OpenStack con el tipo de capacidad Platform9, asegúrese de que tiene acceso a una instancia local o SaaS de Private Cloud Director (PCD). Las versiones compatibles actualmente son:

• Local multinodo: PCD 2025.6-151
  
• SaaS multinodo: PCD 2025.8-112

Acceso a identidades: credenciales de usuario y de aplicación

Asegúrese de que sus credenciales de usuario proporcionen el acceso adecuado a identidades. Necesitará una cuenta de usuario válida para el inquilino o proyecto de destino con, como mínimo, un rol de administrador que permita la creación de recursos y otras tareas operativas en PCD.

Asegúrese también de que la cuenta pertenezca al dominio adecuado. El ámbito del dominio es esencial para que la autenticación de Keystone se realice correctamente.

1. Defina las variables de entorno para establecer el ámbito.

2. Cree unas credenciales de aplicación mediante la CLI de OpenStack Platform9. A continuación se muestra un ejemplo de sintaxis. Para obtener información relacionada, consulte Credenciales de aplicación en la documentación de Red Hat.

   openstack application credential create \
   --role admin \
   --description "credential with admin privileges" \
   my-admin-appcred
   

3. Utilice --role admin para asignar el rol de administrador y poder realizar todas las operaciones a nivel de proyecto.

4. Asegúrese de que la credencial se crea en el dominio y el ámbito del proyecto correctos.

5. Guarde de forma segura el ID y el secreto de la credencial de aplicación generados. Los necesitará más adelante para crear la instancia de Edge del proveedor.

6. Compruebe que el método de descarga web para la creación de imágenes está habilitado.

Preparar el host KVM

Prepare su host KVM siguiendo las recomendaciones de OpenStack Platform9. Actualmente, Ubuntu LTS 22.04 es el sistema operativo compatible con el host KVM. Para obtener más información, consulte los requisitos del host del hipervisor en la documentación del producto Private Cloud Director de Platform9.

1. Asegúrese de tener acceso al menos a un clúster con un mínimo de 3 hosts KVM.

2. Asegúrese de que la opción de almacenamiento de la implementación sea compatible con OpenStack Platform9. Consulte los controladores de almacenamiento compatibles en la documentación del producto Private Cloud Director de Platform9.

3. Configure el controlador Cinder para el almacenamiento según corresponda. Consulte información sobre los controladores Cinder en la documentación del producto OpenStack.

4. Para una clonación rápida, asegúrese de que la descarga de la matriz para XCOPY esté configurada en Cinder si el controlador de la matriz ofrece la función XCOPY.

Obtener los parámetros de OpenRC

Obtenga el parámetro del archivo OpenRC necesario tal y como se describe a continuación. El archivo openrc de OpenStack suele llamarse PROJECT-openrc.sh y es un script de Bash que se utiliza para configurar las variables de entorno necesarias para que las herramientas de línea de comandos interactúen con su proyecto en la nube.

1. Inicie sesión en Private Cloud Director (PCD) con sus credenciales de usuario.

2. Asegúrese de haber seleccionado la región y el proyecto correctos. Si es necesario, haga clic en el icono de configuración para seleccionar Acceso a la API.

3. Vaya a la sección pcdctl RC e introduzca los valores para su archivo OpenRC. A continuación se muestran las variables de entorno pcdctl RC necesarias, con valores de ejemplo.

   export OS_USERNAME=admin@airct1.localnet
   export OS_PASSWORD=<your-password>
   export OS_AUTH_URL=https://pcd-region1.steslabs.ney/keystone/v3
   export OS_AUTH_TYPE=password
   export OS_IDENTITY_API_VERSION=3
   export OS_REGION_NAME=Default
   export OS_USER_DOMAIN_NAME=Default
   export OS_PROJECT_DOMAIN_NAME=Default
   export OS_PROJECT_NAME=PROD
   export OS_INTERFACE=public
   

Requisitos de identidad de la máquina y del usuario

Consulte la Lista de comprobación de requisitos para implementar una instancia de Horizon Cloud on OpenStack Edge e Administración de identidades y acceso en Horizon Cloud en Introducción a Horizon Cloud.

Requisitos de redes, equilibrador de carga y máquina virtual

Consulte Configurar los ajustes de red para implementaciones de Horizon Cloud on OpenStack Edge en la guía Usar y administrar Horizon Cloud.

Procedimiento: Crear la implementación de Edge mediante el acceso local autoalojado en el plano de control

Horizon Universal Console en Horizon Cloud hace que la página de la interfaz de usuario Agregar Horizon Edge esté disponible desde varios puntos de entrada. El punto de partida en la consola para este paso suele depender de si su entorno es totalmente nuevo o si ya existen implementaciones de Horizon Edge.

• Aún no hay instancias de Horizon Edge: Si aún no hay instancias de Horizon Edge implementadas en el entorno, normalmente se inicia el proceso haciendo clic en Iniciar implementación. A continuación, la consola mostrará la página del asistente de interfaz Agregar Horizon Edge.

  También puede comenzar haciendo clic en Capacidad > Agregar > Platform9. A continuación, la consola mostrará la página del asistente de interfaz Agregar Horizon Edge.

• Al menos una instancia de Horizon Edge: Si ya se ha creado e implementado al menos una instancia de Horizon Edge en su entorno de Horizon Cloud, haga clic en Capacidad > Instancias de Horizon Edge > Agregar > Horizon Cloud > Platform9 en Horizon Universal Console para abrir el asistente Agregar Horizon Edge.

1. Inicie sesión en Horizon Cloud. En concreto, vaya a https://connect.omnissa.com y abra el mosaico de Horizon Cloud.

2. En la interfaz de Horizon Universal Console, haga clic en Capacidad > Instancias de Horizon Edge en el panel de navegación de la izquierda. Este procedimiento de ejemplo utilizará la selección del tipo de capacidad Platform9.

3. En la pestaña Instancias de Horizon Edge, haga clic en Agregar y, en el menú desplegable, seleccione Horizon Cloud > Platform9.

   Nota: Puede seleccionar Platform9 u OpenStack. Si utiliza Platform9 Private Cloud Director para proporcionar la infraestructura OpenStack, seleccione Platform9. Si tiene otro software genérico o de código abierto para implementar o administrar automáticamente la infraestructura OpenStack, seleccione OpenStack. En este ejemplo, asumiremos que utiliza Platform9 Private Cloud Director para proporcionar la infraestructura OpenStack, así que seleccionaremos Platform9.

4. Responda a todas las páginas del asistente que aparecen tal y como se describe a continuación.

Requisitos

Revise los requisitos que se muestran, confirme que los cumple y, a continuación, haga clic en Siguiente.

Nota: Antes de continuar, debe descargar la imagen de la máquina virtual de Horizon Edge desde el vínculo proporcionado en esta sección de requisitos y agregarla al repositorio de imágenes de OpenStack.

Información general

En la página Información general, introduzca un nombre y una descripción (opcional) para Horizon Edge y, a continuación, haga clic en Siguiente.

Proveedor de capacidad

En la página Proveedor de capacidad, introduzca la siguiente información y, a continuación, haga clic en Siguiente.

1. En Tipo de plataforma, especifique el tipo de capacidad en el que se implementará Edge Gateway. En este ejemplo, se trata del SDDC de OpenStack Platform9 al que se conectará esta instancia de Edge.

2. Para Ubicación de la consola de administración, seleccione Autoalojado para implementaciones locales o Alojadas en SaaS para implementaciones alojadas en la nube. En este ejemplo, seleccionaremos Autoalojado.

3. Para URL de Keystone, introduzca la URL de autorización tal como se define en la configuración OS_AUTH_URL= de su archivo openrc.sh.

4. Para Ubicación, elija la ubicación física más cercana a usted de la lista de opciones disponibles. Comience a introducir la ciudad donde se encuentra el SDDC de OpenStack Platform9 y, a continuación, realice la selección en la lista desplegada.

5. Para Nombre de dominio del proyecto, introduzca el nombre de dominio del proyecto tal como se especifica en la opción OS_PROJECT_DOMAIN_NAME= de su archivo openrc.sh.

6. Para Nombre del proyecto, introduzca el nombre del proyecto tal como se especifica en la opción OS_PROJECT_NAME= de su archivo openrc.sh.

7. Para Región, introduzca el nombre de la región tal como se especifica en la opción OS_REGION_NAME= de su archivo openrc.sh. Esta especificación es opcional.

8. Para Tipo de credencial, seleccione Credenciales de usuario y, a continuación, especifique el nombre de dominio de usuario, el nombre de usuario y la contraseña según se define en el archivo openrc.sh, O BIEN Credenciales de la aplicación y, a continuación, especifique el identificador de aplicación, el valor de la clave secreta de la aplicación y la huella digital. Para Huella digital, introduzca la huella del certificado SHA-256 de la consola de administración. Hay ayuda en pantalla disponible.

Sitio

En la página Sitio, haga clic en Agregar nuevo y responda a los mensajes, o bien seleccione un sitio existente en el menú desplegable y, a continuación, haga clic en Siguiente.

Horizon Edge Gateway - Autoalojado

1. En la página Horizon Edge Gateway, introduzca la siguiente información y, a continuación, haga clic en Siguiente.

   • FQDN: introduzca el nombre de dominio completo (FQDN) de Edge Gateway. El FQDN debe poder resolverse desde los escritorios VDI.

   • Usar SSO: mantenga esta opción deshabilitada si aún no existen configuraciones de SSO. De lo contrario, active esta opción si ya se ha creado una configuración de SSO y desea asociarla a esta instancia de Edge.

   • Configuraciones de SSO: esta opción está disponible si la opción Usar SSO está habilitada. Comience a introducir el nombre de la configuración de SSO deseada, selecciónelo en la lista y haga clic en Siguiente.

2. Al hacer clic en Siguiente, se mostrará el mensaje Se está iniciando la creación de Horizon Edge Gateway. Tardará unos minutos en completarse. informándole de que se ha iniciado la creación de Horizon Edge Gateway. Cuando se complete la iniciación, aparecerá la siguiente página (Dispositivo Edge Gateway). Una página de resumen le indicará cuándo se ha completado la iniciación. Sin embargo, también debe esperar hasta que se complete la implementación de la instancia de la máquina virtual de Platform9, que puede tardar aproximadamente 20 minutos.

3. Haga clic en Descargar en la página Dispositivo Edge Gateway para descargar el dispositivo.

4. Copie el código de emparejamiento y, a continuación, haga clic en Finalizar en la página Implementar y emparejar Horizon Edge Gateway.

5. Inicie sesión en la consola de Platform9 Private Cloud Director.

6. En el panel de navegación de la izquierda, seleccione Imágenes en la sección Máquinas virtuales.

7. Haga clic en Cargar y, a continuación, desplácese hasta la imagen QCOW2 que descargó anteriormente y selecciónela.

8. Especifique un Nombre para la imagen y, en Formato de disco, seleccione QCOW2.

9. Asegúrate de que todas las casillas estén desmarcadas.

10. Haga clic en Agregar imagen para completar el proceso de carga.

11. Mientras aún está en la consola de Platform9 Private Cloud Director, acceda a Máquinas virtuales > Máquinas virtuales > Implementar nueva máquina virtual y especifique la siguiente información a medida que se le solicite:

    • Proporcione un nombre para la máquina virtual de Edge.
    • Seleccione el clúster en el que desea implementar la máquina virtual de Edge.
    • En Arrancar máquina virtual desde, seleccione Nuevo volumen.
    • Establezca el tamaño del volumen en 40 GiB.
    • Seleccione el tipo de volumen adecuado para la implementación.
    • Marque la opción Eliminar volumen al cerrar la máquina virtual.
    • Elija la imagen VMDK de Edge que importó en el paso anterior.
    • Haga clic en Siguiente para continuar.

12. En la sección Selección de tipo, especifique la siguiente información y, a continuación, haga clic en Siguiente.

    • En Compatible con conexión en caliente, deshabilite la opción.
    • En Compatible con GPU, deshabilite la opción.
    • En Tipo, seleccione la especificación recomendada de 8 vCPU y 16 GB de RAM.

13. En la sección Redes, seleccione una red para la máquina virtual que cumpla los requisitos descritos en el documento Puertos y protocolos y, a continuación, haga clic en Siguiente.

14. En la sección Personalizar máquina virtual, especifique la siguiente información y, a continuación, haga clic en Implementar máquina virtual.

    • En Número de máquinas virtuales, indique 1.
    • En Clave SSH, selecciona la opción correspondiente en el menú desplegable.
    • En Grupo de servidores, selecciona la opción correspondiente en el menú desplegable.
    • Habilite la opción Usar cloud-init.
    • Copie y pegue el siguiente código de ejemplo en el cuadro de código YAML de Cloud-init.
    • Nota: En el código YAML de Cloud-init que aparece en pantalla, reemplace FILL_IN_PAIRING_CODE_FROM_ABOVE_STEP con el código de emparejamiento obtenido en Horizon Cloud Console.
    • Nota: En el código YAML de Cloud-init que aparece en pantalla, reemplace FILL_IN_ROOT_PASSWORD con una contraseña de su elección para el acceso raíz.

     #cloud-config
     write_files:
       - path: /opt/horizon/var/data/env-vars.json
     content: |
      {
        "defaultGateway": "",
        "dns": "",
        "dockerCIDR": "",
        "hostName": "",
        "edgeGwBuildNumber": "258",
        "edgeGwVersion": "2506.1.1",
        "ipAddress": "",
        "netMask": "",
        "pairingCode": "FILL_IN_PAIRING_CODE_FROM_ABOVE_STEP",
        "podCIDR": "192.168.240.0/21",
        "proxyHost": "",
        "proxyNoProxyFor": "",
        "proxyPassword": "",
        "proxyPort": "0",
        "proxySsl": "False",
        "proxyUsername": "",
        "publicKey": "",
        "rootPassword": "FILL_IN_ROOT_PASSWORD",
        "serviceCIDR": "192.168.236.0/23",
        "isMultiNic": "False",
        "vmname": "Horizon_Edge_Gateway"
      }
    

15. Opcionalmente, habilite la opción Asignar grupos de seguridad y especifique los grupos de seguridad de su elección.

16. Deshabilite la opción Establecer prioridad de migración.

17. En Horizon Cloud Console, desplácese hasta Capacidad > Horizon Edges y haga clic en la instancia de Edge implementada. Si la implementación se realizó correctamente, debería ver marcas de verificación verdes en Supervisión del agente, Estado de implementación y Estado de conectividad.

18. Después de crear la instancia de Edge, puede configurar Unified Access Gateway (UAG). Consulte Crear una implementación de UAG para una instancia de OpenStack Edge.

Procedimiento: Crear la implementación de Edge mediante el acceso a la nube alojado en SaaS en el plano de control

Horizon Universal Console en Horizon Cloud hace que la página de la interfaz de usuario Agregar Horizon Edge esté disponible desde varios puntos de entrada. El punto de partida en la consola para este paso suele depender de si su entorno es totalmente nuevo o si ya existen implementaciones de Horizon Edge.

• Aún no hay instancias de Horizon Edge: Si aún no hay instancias de Horizon Edge implementadas en el entorno, normalmente se inicia el proceso haciendo clic en Iniciar implementación. A continuación, la consola mostrará la página del asistente de interfaz Agregar Horizon Edge.

  También puede comenzar haciendo clic en Capacidad > Agregar > Platform9. A continuación, la consola mostrará la página del asistente de interfaz Agregar Horizon Edge.

• Al menos una instancia de Horizon Edge: Si ya se ha creado e implementado al menos una instancia de Horizon Edge en su entorno de Horizon Cloud, haga clic en Capacidad > Instancias de Horizon Edge > Agregar > Horizon Cloud > Platform9 en Horizon Universal Console para abrir el asistente Agregar Horizon Edge.

1. Inicie sesión en Horizon Cloud. En concreto, vaya a https://connect.omnissa.com y abra el mosaico de Horizon Cloud.

2. En la interfaz de Horizon Universal Console, haga clic en Capacidad > Instancias de Horizon Edge en el panel de navegación de la izquierda.

3. En la pestaña Instancias de Horizon Edge, haga clic en Agregar y, en el menú desplegable, seleccione Horizon Cloud > Platform9.

   Nota: Puede seleccionar Platform9 u OpenStack. Si utiliza Platform9 Private Cloud Director para proporcionar la infraestructura OpenStack, seleccione Platform9. Si tiene otro software genérico o de código abierto para implementar o administrar automáticamente la infraestructura OpenStack, seleccione OpenStack. En este ejemplo, asumiremos que utiliza Platform9 Private Cloud Director para proporcionar la infraestructura OpenStack, así que seleccionaremos Platform9.

4. Responda a todas las páginas del asistente que aparecen tal y como se describe a continuación.

Requisitos

Revise los requisitos que se muestran, confirme que los cumple y, a continuación, haga clic en Siguiente.

Información general

En la página Información general, introduzca un nombre y una descripción (opcional) para Horizon Edge y, a continuación, haga clic en Siguiente.

Proveedor de capacidad

En la página Proveedor de capacidad, introduzca la siguiente información y, a continuación, haga clic en Siguiente.

1. En Tipo de plataforma, especifique el tipo de capacidad en el que se implementará Edge Gateway. En este ejemplo, se trata del SDDC de OpenStack Platform9 al que se conectará esta instancia de Edge.

2. Para Ubicación de la consola de administración, seleccione Autoalojado para implementaciones locales o Alojadas en SaaS para implementaciones alojadas en la nube. En este ejemplo, seleccionaremos Alojado en SaaS.

3. Para URL de Keystone, introduzca la URL de autorización tal como se define en la configuración OS_AUTH_URL= de su archivo openrc.sh.

4. Para Ubicación, elija la ubicación física más cercana a usted de la lista de opciones disponibles. Comience a introducir la ciudad donde se encuentra el SDDC de OpenStack Platform9 y, a continuación, realice la selección en la lista desplegada.

5. Para Nombre de dominio del proyecto, introduzca el nombre de dominio del proyecto tal como se especifica en la opción OS_PROJECT_DOMAIN_NAME= de su archivo openrc.sh.

6. Para Nombre del proyecto, introduzca el nombre del proyecto tal como se especifica en la opción OS_PROJECT_NAME= de su archivo openrc.sh.

7. Para Región, introduzca el nombre de la región tal como se especifica en la opción OS_REGION_NAME= de su archivo openrc.sh. Esta especificación es opcional.

8. Para Tipo de credencial, seleccione Credenciales de usuario y, a continuación, especifique el nombre de dominio de usuario, el nombre de usuario y la contraseña según se define en el archivo openrc.sh, O BIEN Credenciales de la aplicación y, a continuación, especifique el identificador de aplicación, el valor de la clave secreta de la aplicación y la huella digital. Para Huella digital, introduzca la huella del certificado SHA-256 de la consola de administración. Hay ayuda en pantalla disponible.

Sitio

En la página Sitio, haga clic en Agregar nuevo y responda a los mensajes, o bien seleccione un sitio existente en el menú desplegable y, a continuación, haga clic en Siguiente.

Horizon Edge Gateway - Alojado en SaaS

En la sección Horizon Edge Gateway, introduzca la siguiente información y, a continuación, haga clic en Guardar y cerrar.

• FQDN: introduzca el nombre de dominio completo (FQDN) de Edge Gateway. El FQDN debe poder resolverse desde los escritorios VDI.

• Tipo: seleccione un tamaño de tipo en el menú desplegable.

• Tipo de volumen: seleccione un tipo de volumen en el menú desplegable.

• Supervisión de agentes: mantenga esta opción habilitada.

• Usar SSO: mantenga esta opción deshabilitada si aún no existen configuraciones de SSO. De lo contrario, active esta opción si ya se ha creado una configuración de SSO y desea asociarla a esta instancia de Edge.

• Configuraciones de SSO: esta opción está disponible si la opción Usar SSO está habilitada. Comience a introducir el nombre de la configuración de SSO deseada y, a continuación, selecciónelo en la lista.

• Red de administración: seleccione la subred de administración especificada en Platform9 en el menú desplegable de opciones. Puede abrir la aplicación Platform9 Private Cloud Director (PCD) para consultar los detalles de estas distintas opciones de red.

• Dirección IP (opcional): introduzca una dirección IP o permita que el sistema la asigne por usted según su selección de red.

• Grupos de seguridad de red: seleccione el grupo de seguridad de red especificado en Platform9 en el menú desplegable de opciones. Puede abrir la aplicación Platform9 Private Cloud Director (PCD) para consultar los detalles de estas distintas opciones de grupo de seguridad.

• Proxy: opcionalmente, especifique la configuración de proxy para el tráfico saliente como parte de este proceso de implementación de Edge. Actualmente no se admite la edición ni la actualización de esta configuración de proxy después de la implementación de Edge. La configuración del proxy incluye el nombre, el host, el puerto, el tipo, el nombre de usuario y la contraseña, tal como se describe en la ayuda en pantalla.

• Avanzado: abra la sección Avanzado de la página que se proporcionará con las opciones para especificar un CIDR de servicio y un CIDR de pod. Si no especifica estos valores, se utilizarán los valores predeterminados, como se describe en la ayuda en pantalla.

Al hacer clic en Guardar y cerrar, se mostrará el mensaje Se está iniciando la creación de Horizon Edge Gateway. Tardará unos minutos en completarse. informándole de que se ha iniciado la creación de Horizon Edge Gateway. Cuando se complete la iniciación, aparecerá la siguiente página (Dispositivo Edge Gateway). Una página de resumen le indicará cuándo se ha completado la iniciación. Sin embargo, también debe esperar hasta que se complete la implementación de la instancia de la máquina virtual de Platform9, que puede tardar aproximadamente 20 minutos.

Después de crear la instancia de Edge, puede configurar Unified Access Gateway (UAG). Consulte Crear una implementación de UAG para una instancia de OpenStack Edge.