Skip to main content

26 de agosto de 2026

Arquitetura federada para Google Cloud Platform: baixar e implantar o Horizon Edge Gateway

Você pode baixar e implantar o Horizon Edge Gateway em sua implantação federada do Horizon 8 no Google Cloud Platform (GCP) para emparelhar com o Horizon Cloud.

Baixe e implante o dispositivo do Horizon Edge Gateway para uma implantação de borda que usa arquitetura federada para a solução Google Cloud GCVE. Na arquitetura federada, você deve implantar o Horizon Edge Gateway na infraestrutura nativa do Google Cloud Platform (GCP) dentro do ambiente da sua borda.

A seguir, está uma visão geral das etapas necessárias para implantar o Horizon Edge Gateway na infraestrutura nativa do GCP no ambiente do seu pod:

  • Baixe o arquivo TAR do Horizon Edge Gateway.
  • Crie um bucket do Google Cloud Storage e carregue o TAR do dispositivo para esse bucket.
  • Crie uma imagem personalizada do arquivo TAR carregado.
  • Crie a instância da máquina virtual (VM) do Horizon Edge Gateway a partir da imagem personalizada.

Pré-requisitos

Você deve atender aos seguintes pré-requisitos antes de continuar.

  • Verifique se você atende aos pré-requisitos relacionados ao Horizon Edge Gateway descritos em Conceitos básicos de uma implantação do Horizon 8 Edge.

  • Verifique se você atende aos requisitos de Tornar URLs de destino apropriadas acessíveis para implantar um Horizon Edge Gateway em um ambiente do Microsoft Azure para usar o Horizon Edge Gateway para emparelhar um pod Horizon 8 com o Horizon Cloud.

  • Verifique se você está usando a versão apropriada do Horizon Edge Gateway. Consulte a Matriz de Interoperabilidade de Produtos Omnissa.

  • O dispositivo virtual do Horizon Edge Gateway deve acessar a Internet para se comunicar com o Horizon Control Plane. Se o ambiente exigir o uso de um servidor proxy e uma configuração de proxy para os dispositivos implantados acessarem a Internet, verifique se você analisou as informações relacionadas ao proxy, as limitações e os problemas conhecidos ao usar as configurações de proxy com o dispositivo do Horizon Edge Gateway.

    Nota: atualize a configuração do proxy no 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 mais opções, execute o script com a opção -h, conforme mostrado abaixo:

    /opt/horizon/bin/configure-edge-gateway.sh -h
    
  • Para usar um proxy ao emparelhar o edge usando o script configure-edge-gateway.sh, você deve primeiro executar o seguinte comando, especificando como verdadeiro quando o ProxySSL estiver ativado e, caso contrário, especificando como falso:

    /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'
    
  • Você pode realizar algumas das etapas de implantação usando a interface gráfica do usuário (GUI) do Google Cloud ou a interface de linha de comando (CLI) do Google Cloud. Para usar a CLI, você deve primeiro instalar os componentes necessários no seu sistema local:

    • A ferramenta gsutil. Para obter instruções, consulte a documentação do Google Cloud Storage.
    • O Google Cloud SDK. Para obter instruções, consulte a documentação do Google Cloud SDK.

Procedimento

  1. Baixe a imagem de disco do Horizon Edge Gateway usando a etapa para obter o binário do dispositivo do Horizon Edge Gateway no meio do procedimento na página Adicionar e implantar um Horizon 8 Edge. Responda aos prompts na tela.

    A imagem de disco/dispositivo Horizon Edge Gateway está disponível como um arquivo TAR. Baixe o arquivo TAR para o seu sistema local conforme especificado.

    Salve o binário baixado em um local do qual você o implantará na plataforma de virtualização desejada e, em seguida, retornará a essa sequência de etapas para continuar o processo de emparelhamento necessário.

    Nota: para implantar o dispositivo em um ambiente GCVE, baixe a imagem de disco mais recente do Horizon Edge Gateway. Recomendamos que você use a versão mais recente do dispositivo do Edge Gateway. Para obter informações sobre a versão, consulte a Matriz de Interoperabilidade de Produtos Omnissa.

    Antes de carregar o arquivo de imagem de disco para seu ambiente do GCVE, primeiro você deve criar um bucket do Google Cloud Storage.

  2. Crie um bucket do Google Cloud Storage no seu ambiente do GCVE. Para obter instruções detalhadas, consulte a documentação do Google Cloud.

  3. Carregue o arquivo TAR baixado para seu bucket do Google Cloud Storage. Você pode realizar essa etapa usando a interface gráfica do usuário (GUI) do Google Cloud ou a interface de linha de comando (CLI) do Google Cloud.

    • (GUI) Faça login na Google Cloud Platform para seu ambiente do GCVE. Acesse a página Cloud Storage, selecione o bucket que você criou anteriormente e carregue o arquivo TAR para esse bucket.

    • (CLI) Abra o console gsutil e execute o comando a seguir.

      gsutil cp <file-path-to-TAR-file> gs://<bucket-name>
      
  4. Crie uma imagem personalizada do arquivo TAR carregado.

    • (GUI) Na Google Cloud Platform, acesse a página Mecanismo de Processamento > Imagens. Selecione a opção para criar uma imagem. Na página de criação de imagem, especifique Cloud Storage como a origem e navegue até o arquivo TAR carregado no seu bucket. Especifique outras propriedades da imagem conforme apropriado e prossiga para criar a imagem.

      Verifique se a nova imagem é exibida na lista Images.

    • (CLI) No console gsutil, execute o comando de criação de imagem, semelhante ao exemplo a seguir.

      gcloud compute --project <project-name> images create <image-name> --description <image-description> --source-uri <TAR-file-uri>
      

      Nota: você pode personalizar o comando com os parâmetros apropriados, conforme necessário. Para obter informações detalhadas, consulte a documentação de referência do Google Cloud SDK.

  5. Para oferecer suporte à criação e à configuração da instância da VM do Horizon Edge Gateway, prepare um script de inicialização semelhante ao exemplo a seguir.

    #! /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
    

    No exemplo, o script oferece suporte às seguintes configurações:

    • Ativação do acesso SSH ao dispositivo do Horizon Edge Gateway.
    • Criação de uma conta de usuário administrador no dispositivo com a senha definida (\n). Defina uma senha forte.
    • Criação de uma conta de usuário do ccadmin no dispositivo com a senha definida (\n). Defina uma senha forte.
    • Resolução do nome do host do Servidor de Conexão (cs_fqdn) para o endereço IP do Servidor de Conexão (cs_ip).
  6. Crie a instância da VM do Horizon Edge Gateway a partir da imagem personalizada. Configure um mínimo de n2-standard-8 para o tipo de máquina ou dimensionamento de VM.

    • (GUI) Na Google Cloud Platform, vá até a página Images, selecione a imagem personalizada que você criou anteriormente e selecione a opção para criar uma instância de VM. Especifique um mínimo de n2-standard-8 para o tipo de máquina ou dimensionamento de VM, designe a imagem personalizada como o disco de inicialização e adicione o script de inicialização que você preparou anteriormente. Especifique outras propriedades da VM conforme apropriado e prossiga para criar a instância da VM.

      Verifique se a VM do Horizon Edge Gateway aparece na lista de instâncias de VM.

    • (CLI) No console gsutil, execute o comando de criação de instância, semelhante ao exemplo a seguir.

      gcloud compute --project <project-name> instances create <instance-name> 
      --zone <zone> --machine-type <n2-standard-8-minimum> --network <network> 
      --subnet <subnet> --maintenance-policy <maintenance-policy> --scopes <scope> 
      --image <custom-TAR-image> --metadata startup-script=<startup-script>
      

      Nota: você pode personalizar o comando com os parâmetros apropriados, conforme necessário. Para obter informações detalhadas, consulte a documentação de referência do Google Cloud SDK.

  7. Depois que a VM do Horizon Edge Gateway for iniciada, edite a configuração da instância da VM e remova o script de inicialização.

    Importante: você deve remover o script de inicialização da instância para impedir que o script seja executado toda vez que o Horizon Edge Gateway é reinicializado.

  8. SSH para a instância do GCP da VM do Horizon Edge Gateway.

    Para obter informações relacionadas, consulte Ativar acesso SSH para Horizon Edge.

    Consulte a documentação do Google Cloud para obter detalhes sobre como se conectar à sua instância do. Recomendamos o SSH para permitir copiar e colar a chave de emparelhamento.

  9. Execute um script de borda de par usando o seguinte formato de comando, em que pairing_code é o código de emparelhamento que você copiou da etapa Implantar e emparelhar o Horizon Edge Gateway no meio do procedimento descrito em Adicionar e implantar um Horizon 8 Edge.

```
sudo su -
/opt/horizon/bin/configure-edge-gateway.sh -p <pairing_code>
```

11. Para melhorar a segurança, considere desativar o SSH quando você tiver concluído estas etapas.

  1. Volte para o Horizon Universal Console para concluir a configuração dos detalhes do Horizon Connection Server. Consulte Adicionar e implantar um Horizon 8 Edge.

Esta página foi útil?

Enviar feedback sobre este tópico

Este tópico foi útil?

Não inclua informações pessoais ou confidenciais.

Gerando o link…