Adicionar e implantar um Horizon Edge para OpenStack

Você pode adicionar e implantar um Horizon Edge para um tipos de capacidade do Horizon Cloud on OpenStack (implantação do cliente ou Platform9 Private Cloud Director). Em seguida, você pode configurar o Unified Access Gateway (UAG) para o Edge.

Nota: o Horizon Cloud on OpenStack está atualmente disponível apenas no modo de Disponibilidade Limitada (LA).

Pré-requisitos gerais

Configure os pré-requisitos para o Horizon Cloud Service, o Unified Access Gateway (UAG) e o Private Cloud Director.

• Analise e conclua o processo de acesso ao Horizon Cloud descrito em Implantações do Horizon Cloud on OpenStack Edge, incluindo o processo de integração.

• Analise e cumpra os requisitos descritos nos tópicos Lista de verificação de requisitos para implantação do Horizon Cloud on OpenStack Edge e Requisitos de porta e protocolo para Horizon Cloud on OpenStack Edge do documento Introdução ao Horizon Cloud.

• Determine o nome de domínio totalmente qualificado (FQDN) que você usará para o dispositivo Horizon Edge Gateway implantado. O assistente da UI solicita que você insira esse FQDN. Para referência, consulte o artigo do fórum da Comunidade Omnissa intitulado Compreender o Omnissa Horizon Edge Gateway: propósito, arquitetura e práticas recomendadas.

• Conheça os pré-requisitos do Private Cloud Director (PCD) na seção a seguir.

Pré-requisitos do Private Cloud Director

Se você estiver criando um Horizon Edge para OpenStack usando o tipo de capacidade Platform9, certifique-se de ter acesso a uma instância local instalada do Private Cloud Director (PCD) ou a uma instância SaaS do PCD. As versões atualmente suportadas são:

• Nó Múltiplo Local: PCD 2025.6-151
  
• Nó Múltiplo SaaS: PCD 2025.8-112

Acesso à identidade: credenciais de usuário e aplicativo

Certifique-se de que suas credenciais de usuário forneçam o acesso de identidade apropriado. Você precisará de uma conta de usuário válida para o locatário/projeto de destino com, no mínimo, a função de administrador para permitir a criação de recursos e outras tarefas operacionais no PCD.

Certifique-se também de que a conta pertença ao domínio apropriado. O escopo do domínio é essencial para o sucesso da autenticação Keystone.

1. Defina variáveis de ambiente para definir o escopo.

2. Crie uma credencial de aplicativo usando a CLI do OpenStack Platform9. A sintaxe de exemplo é mostrada abaixo. Para obter informações relacionadas, consulte Credenciais de Aplicativo na documentação da Red Hat.

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

3. Use --role admin para atribuir a função de administrador para todas as operações em nível de projeto.

4. Certifique-se de que a credencial seja criada no domínio e escopo do projeto corretos.

5. Guarde a ID e a chave secreta das credenciais do aplicativo geradas em local seguro. Você usará esses dados para criar o provedor Edge posteriormente.

6. Verifique se o método de download da Web para criação de imagens está ativado.

Preparar o host KVM

Prepare seu host KVM seguindo as recomendações do OpenStack Platform9. O Ubuntu LTS 22.04 é atualmente o sistema operacional compatível com o host KVM. Para obter mais informações, consulte a seção Pré-requisitos do host do hipervisor na documentação do produto Private Cloud Director do Platform9.

1. Certifique-se de ter acesso a pelo menos um cluster com um mínimo de 3 hosts KVM.

2. Certifique-se de que a opção de armazenamento na implantação seja compatível com a plataforma OpenStack 9. Consulte Drivers de armazenamento compatíveis na documentação do produto Private Cloud Director do Platform9.

3. Configure o driver do Cinder para armazenamento conforme apropriado. Consulte Tudo sobre drivers Cinder na documentação do produto OpenStack.

4. Para clonagem rápida, certifique-se de que o descarregamento de matriz para XCOPY esteja configurado no Cinder, caso o driver de matriz ofereça o recurso XCOPY.

Obter parâmetros do OpenRC

Obtenha os parâmetros necessários do arquivo OpenRC conforme descrito abaixo. O arquivo openrc do OpenStack geralmente é nomeado como PROJECT-openrc.sh e é um script Bash usado para definir as variáveis de ambiente necessárias para que as ferramentas de linha de comando interajam com seu projeto na nuvem.

1. Faça login no Private Cloud Director (PCD) com suas credenciais de usuário.

2. Certifique-se de ter selecionado a Região e o Projeto corretos. Se necessário, clique no ícone de Configurações para selecionar Acesso à API.

3. Navegue até a seção pcdctl RC e digite os valores para seu arquivo OpenRC. As variáveis de ambiente necessárias para o pcdctl RC são mostradas abaixo, com valores de exemplo.

   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
   

Pré-requisitos de identidade da máquina e do usuário

Consulte a Lista de requisitos para implantação do Horizon Cloud on OpenStack Edgee o Guia de gerenciamento de identidade e acesso no Horizon Cloud em Introdução ao Horizon Cloud.

Pré-requisitos de rede, balanceador de carga e VMs

Consulte a seção Definir as configurações de rede e a configuração da VM principal para o implantações do Horizon Cloud on OpenStack Edge neste guia Usar e gerenciar o Horizon Cloud.

Procedimento: criar a implantação de borda usando acesso local auto-hospedado ao plano de controle

O Horizon Universal Console no Horizon Cloud disponibiliza a página Adicionar UI do Horizon Edge de vários pontos de entrada. O ponto de partida no console para esta etapa geralmente depende se seu ambiente é novo ou se já tem implantações do Horizon Edge.

• Ainda não há Horizon Edges implantados: se ainda não há Horizon Edges implantados no ambiente, você geralmente inicia o processo clicando em Iniciar Implantação. Em seguida, o console exibirá a página de passo da UI do Adicionar Horizon Edge.

  Como alternativa, você pode começar clicando em Capacidade > Adicionar > Platform9. Em seguida, o console exibirá a página de passo da UI do Adicionar Horizon Edge.

• Pelo menos um Horizon Edge: se houver pelo menos um Horizon Edge já criado e implantado em seu ambiente Horizon Cloud, clique em Capacidade > Horizon Edges > Adicionar > Horizon Cloud > Platform9 no Horizon Universal Console para abrir a página do passo a passo de Adicionar Horizon Edge.

1. Faça login no Horizon Cloud. Especificamente, acesse https://connect.omnissa.com e abra o bloco do Horizon Cloud.

2. Na UI do Horizon Universal Console, clique em Capacidade > Horizon Edges no painel de navegação à esquerda. Este procedimento de exemplo usará a seleção do tipo de capacidade da Plataforma 9.

3. Na guia Horizon Edges, clique em Adicionar e, no menu suspenso, selecione Horizon Cloud > Platform9.

   Nota: você pode selecionar Platform9 ou OpenStack. Se você estiver usando o Platform9 Private Cloud Director para fornecer a infraestrutura OpenStack, selecione Platform9. Se você tiver algum outro software genérico ou de código aberto para implantar ou gerenciar a infraestrutura OpenStack por conta própria, selecione OpenStack. Neste exemplo, estamos presumindo o uso do Platform9 Private Cloud Director para fornecer a infraestrutura OpenStack e, portanto, selecionaremos o Platform9.

4. Responda a todas as páginas subsequentes do passo a passo da UI, conforme descrito abaixo.

Requisitos

Analise os requisitos conforme mostrado, confirme que você os atendeu e clique em Avançar.

Nota: certifique-se de baixar a imagem da VM do Horizon Edge do link fornecido nesta seção Requisitos e adicionar a imagem baixada ao seu repositório de imagens OpenStack antes de prosseguir.

Informações gerais

Na página Informações Gerais, digite um nome e uma descrição para o Horizon Edge (opcional) e clique em Avançar.

Provedor de Capacidade

Na página Provedor de Capacidade, insira as seguintes informações e clique em Avançar.

1. Em Tipo de plataforma, especifique o tipo de capacidade em que seu Edge Gateway será implantado. Neste exemplo, trata-se do SDDC (Centro de Dados de Domínio) da Plataforma OpenStack 9 ao qual este Edge se conectará.

2. Em Local do Console de Gerenciamento, selecione Hospedado internamente para implantações locais ou Hospedado em SaaS para implantações na nuvem. Neste exemplo, selecionaremos Auto-hospedado.

3. No campo URL do Keystone, digite a URL de autorização conforme definida na configuração OS_AUTH_URL= de seu arquivo openrc.sh.

4. Em Localização, escolha o local físico mais próximo de você na lista de opções disponíveis. Comece digitando a cidade onde o SDDC do OpenStack Platform9 está localizado e selecione-a na lista exibida.

5. No campo Nome de domínio do projeto, digite o nome de domínio do projeto conforme especificado na configuração OS_PROJECT_DOMAIN_NAME= de seu arquivo openrc.sh.

6. No campo Nome do projeto, digite o nome do projeto conforme especificado na configuração OS_PROJECT_NAME= de seu arquivo openrc.sh.

7. Em Região, digite o nome da região conforme especificado na configuração OS_REGION_NAME= de seu arquivo openrc.sh. Esta especificação é opcional.

8. Em Tipo de credencial, selecione Credenciais de usuário e especifique o Nome de domínio do usuário, o Nome de usuário e a Senha, conforme definido em seu arquivo openrc.sh OU Credenciais de aplicativo e especifique a ID do aplicativo, o valor da chave Segredo do aplicativo e a Impressão digital. Em Impressão digital, digite a impressão digital do certificado SHA-256 do console de gerenciamento. A ajuda na tela está disponível.

Site

Na página Site, clique em Adicionar novo e responda às solicitações ou selecione um site existente no menu suspenso e clique em Avançar.

Horizon Edge Gateway: autohospedado

1. Na página do Horizon Edge Gateway, digite as seguintes informações e clique em Avançar.

   • FQDN – digite o nome de domínio completo (FQDN) para o Edge Gateway. O FQDN deve ser resolvível por meio de desktops VDI.

   • Usar SSO – mantenha esta opção desativada se ainda não existirem configurações de SSO. Caso contrário, ative esta opção se uma configuração de SSO já estiver criada e você quiser associá-la a este Edge.

   • Configurações de SSO – esta opção ficará disponível se a opção Usar SSO estiver ativada. Comece digitando o nome da configuração SSO desejada, selecione-a na lista e clique em Avançar.

2. Depois de clicar em Avançar, a mensagem Iniciação da criação do Horizon Edge Gateway em andamento. A conclusão levará alguns minutos. Uma mensagem será exibida informando que a criação do Horizon Edge Gateway está em andamento. Quando a inicialização estiver concluída, a próxima página do stepper (Edge Gateway Dispositivo) será exibida. Uma página de resumo informa quando a inicialização é concluída. No entanto, você também precisa aguardar até que a implantação da instância de VM do Platform9 seja concluída, o que pode levar cerca de 20 minutos.

3. Clique em Download na página do Dispositivo do Edge Gateway para baixar o dispositivo.

4. Copie o código de emparelhamento e clique em Concluir na página Implantar e Emparelhar o Horizon Edge Gateway.

5. Faça login no console do Platform9 Private Cloud Director.

6. No painel de navegação à esquerda, selecione Imagens na seção Máquinas Virtuais.

7. Clique em Carregar, navegue até a imagem QCOW2 que você baixou anteriormente e selecione-a.

8. Especifique um Nome para a imagem e, para o Formato do disco, selecione QCOW2.

9. Certifique-se de que todas as caixas de seleção estejam desmarcadas.

10. Clique em Adicionar imagem para concluir o processo de upload.

11. Ainda na console do Platform9 Private Cloud Director, navegue até Máquinas virtuais > VMs > Implementar nova VM e especifique as seguintes informações conforme solicitado:

    • Forneça um Nome para a VM do Edge.
    • Selecione o Cluster no qual você deseja implantar a VM do Edge.
    • Para Inicializar a VM de, selecione Novo Volume.
    • Defina Tamanho do Volume como 40 GiB.
    • Selecione o Tipo de Volume apropriado para sua implantação.
    • Verifique a opção Excluir Volume na Terminação da VM.
    • Escolha a imagem do Edge VMDK que você importou na etapa anterior.
    • Clique em Avançar para prosseguir.

12. Na seção Seleção de Tipo, especifique as informações a seguir e clique em Avançar para continuar.

    • Para Hot-plug Compatível, especifique a configuração Desativado.
    • Para GPU Compatível, especifique a configuração Desativado.
    • Para Tipo, selecione a especificação recomendada de 8 vCPU e 16 GB de RAM.

13. Na seção Rede , selecione uma rede para sua VM que atenda aos requisitos descritos no documento Portas e Protocolos e clique em Avançar para continuar.

14. Na seção Personalizar VM, especifique as informações a seguir e clique em Implantar Máquina Virtual para continuar.

    • Para Número de VMs, especifique 1.
    • Para Chave SSH, selecione uma opção aplicável no menu suspenso.
    • Para Grupo de servidores, selecione uma opção aplicável no menu suspenso.
    • Ative a opção Usar Cloud-init .
    • Copie e cole o seguinte código de amostra na caixa de código YAML Cloud-init.
    • Nota: no código YAML Cloud-init na tela, substitua FILL_IN_PAIRING_CODE_FROM_ABOVE_STEP para inserir o código de emparelhamento obtido do Horizon Cloud Console.
    • Nota: no código YAML Cloud-init na tela, substitua FILL_IN_ROOT_PASSWORD para inserir uma senha de sua escolha para acesso raiz.

     #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, ative a opção Atribuir Grupos de Segurança e especifique os grupos de segurança de sua escolha.

16. Desative a opção Definir Prioridade de Migração .

17. No Horizon Cloud Console, navegue até Capacidade > Horizon Edges e clique no Edge implantado. Se a implantação for bem-sucedida, você deverá ver as marcas de seleção verdes para Monitoramento do Agente, Status da Implantação e Status de Conectividade.

18. Depois de criar seu Edge, você pode configurar seu Unified Access Gateway (UAG). Consulte Criar uma implantação do UAG para um vSphere, Nutanix ou OpenStack Edge.

Procedimento: criaf a implantação de borda usando acesso à nuvem hospedado em SaaS para a camada de controle

O Horizon Universal Console no Horizon Cloud disponibiliza a página Adicionar UI do Horizon Edge de vários pontos de entrada. O ponto de partida no console para esta etapa geralmente depende se seu ambiente é novo ou se já tem implantações do Horizon Edge.

• Ainda não há Horizon Edges implantados: se ainda não há Horizon Edges implantados no ambiente, você geralmente inicia o processo clicando em Iniciar Implantação. Em seguida, o console exibirá a página de passo da UI do Adicionar Horizon Edge.

  Como alternativa, você pode começar clicando em Capacidade > Adicionar > Platform9. Em seguida, o console exibirá a página de passo da UI do Adicionar Horizon Edge.

• Pelo menos um Horizon Edge: se houver pelo menos um Horizon Edge já criado e implantado em seu ambiente Horizon Cloud, clique em Capacidade > Horizon Edges > Adicionar > Horizon Cloud > Platform9 no Horizon Universal Console para abrir a página do passo a passo de Adicionar Horizon Edge.

1. Faça login no Horizon Cloud. Especificamente, acesse https://connect.omnissa.com e abra o bloco do Horizon Cloud.

2. Na UI do Horizon Universal Console, clique em Capacidade > Horizon Edges no painel de navegação à esquerda.

3. Na guia Horizon Edges, clique em Adicionar e, no menu suspenso, selecione Horizon Cloud > Platform9.

   Nota: você pode selecionar Platform9 ou OpenStack. Se você estiver usando o Platform9 Private Cloud Director para fornecer a infraestrutura OpenStack, selecione Platform9. Se você tiver algum outro software genérico ou de código aberto para implantar ou gerenciar a infraestrutura OpenStack por conta própria, selecione OpenStack. Neste exemplo, estamos presumindo o uso do Platform9 Private Cloud Director para fornecer a infraestrutura OpenStack e, portanto, selecionaremos o Platform9.

4. Responda a todas as páginas subsequentes do passo a passo da UI, conforme descrito abaixo.

Requisitos

Analise os requisitos conforme mostrado, confirme que você os atendeu e clique em Avançar.

Informações gerais

Na página Informações Gerais, digite um nome e uma descrição para o Horizon Edge (opcional) e clique em Avançar.

Provedor de Capacidade

Na página Provedor de Capacidade, insira as seguintes informações e clique em Avançar.

1. Em Tipo de plataforma, especifique o tipo de capacidade em que seu Edge Gateway será implantado. Neste exemplo, trata-se do SDDC (Centro de Dados de Domínio) da Plataforma OpenStack 9 ao qual este Edge se conectará.

2. Em Local do Console de Gerenciamento, selecione Hospedado internamente para implantações locais ou Hospedado em SaaS para implantações na nuvem. Neste exemplo, selecionaremos a opção Hospedado em SaaS.

3. No campo URL do Keystone, digite a URL de autorização conforme definida na configuração OS_AUTH_URL= de seu arquivo openrc.sh.

4. Em Localização, escolha o local físico mais próximo de você na lista de opções disponíveis. Comece digitando a cidade onde o SDDC do OpenStack Platform9 está localizado e selecione-a na lista exibida.

5. No campo Nome de domínio do projeto, digite o nome de domínio do projeto conforme especificado na configuração OS_PROJECT_DOMAIN_NAME= de seu arquivo openrc.sh.

6. No campo Nome do projeto, digite o nome do projeto conforme especificado na configuração OS_PROJECT_NAME= de seu arquivo openrc.sh.

7. Em Região, digite o nome da região conforme especificado na configuração OS_REGION_NAME= de seu arquivo openrc.sh. Esta especificação é opcional.

8. Em Tipo de credencial, selecione Credenciais de usuário e especifique o Nome de domínio do usuário, o Nome de usuário e a Senha, conforme definido em seu arquivo openrc.sh OU Credenciais de aplicativo e especifique a ID do aplicativo, o valor da chave Segredo do aplicativo e a Impressão digital. Em Impressão digital, digite a impressão digital do certificado SHA-256 do console de gerenciamento. A ajuda na tela está disponível.

Site

Na página Site, clique em Adicionar novo e responda às solicitações ou selecione um site existente no menu suspenso e clique em Avançar.

Horizon Edge Gateway: hospedado em SaaS

Na página do Horizon Edge Gateway, digite as seguintes informações e clique em Salvar e Fechar.

• FQDN – digite o nome de domínio completo (FQDN) para o Edge Gateway. O FQDN deve ser resolvível por meio de desktops VDI.

• Tipo – selecione um tamanho de tipo no menu suspenso.

• Tipo de volume – selecione um tipo de volume no menu suspenso.

• Monitoramento de agentes – mantenha esta opção ativada.

• Usar SSO – mantenha esta opção desativada se ainda não existirem configurações de SSO. Caso contrário, ative esta opção se uma configuração de SSO já estiver criada e você quiser associá-la a este Edge.

• Configurações de SSO – esta opção ficará disponível se a opção Usar SSO estiver ativada. Comece digitando o nome da configuração SSO desejada e selecione-a na lista.

• Rede de gerenciamento: selecione a sub-rede de gerenciamento especificada pela Platform9 no menu suspenso de opções. Você pode abrir o aplicativo Platform9 Private Cloud Director (PCD) para explorar detalhes sobre essas diversas opções de rede.

• Endereço IP (opcional): digite um endereço IP ou deixe o sistema atribuir um endereço IP para você com base em sua seleção de rede.

• Grupos de segurança de rede: selecione o grupo de segurança de rede especificado pela Platform9 no menu suspenso de opções. Você pode abrir o aplicativo Platform9 Private Cloud Director (PCD) para explorar detalhes sobre essas várias opções de grupo de segurança.

• Proxy: opcionalmente, especifique as configurações de proxy para o tráfego de saída como parte deste processo de implantação do Edge. No momento, não há suporte para a edição ou atualização dessas configurações de proxy após a implantação do Edge. As configurações de proxy incluem nome, host, porta, tipo, nome de usuário e senha, conforme descrito na ajuda na tela.

• Avançado: abra a seção Avançado da página para visualizar as opções para especificar um CIDR de serviço e um CIDR de pod. Caso você não especifique esses valores, os valores padrão serão usados, conforme descrito na ajuda exibida na tela.

Após clicar em Salvar e Fechar, a criação do Horizon Edge Gateway estará em andamento. A conclusão levará alguns minutos. Uma mensagem será exibida informando que a criação do Horizon Edge Gateway está em andamento. Quando a inicialização estiver concluída, a próxima página do stepper (Edge Gateway Dispositivo) será exibida. Uma página de resumo informa quando a inicialização é concluída. No entanto, você também precisa aguardar até que a implantação da instância de VM do Platform9 seja concluída, o que pode levar cerca de 20 minutos.

Depois de criar seu Edge, você pode configurar seu Unified Access Gateway (UAG). Consulte Criar uma implantação do UAG para um vSphere, Nutanix ou OpenStack Edge.