Conexão com o Red Hat OpenShift

Criar e gerenciar conexões e recursos descreve os assistentes que criam uma conexão. As informações a seguir cobrem detalhes específicos do Red Hat OpenShift.

Nota:

Antes de criar uma conexão com o Red Hat OpenShift, você precisa primeiro concluir a configuração do seu Red Hat OpenShift. Consulte Ambientes de virtualização do Red Hat OpenShift

Criar uma conexão

Você pode criar uma conexão com o cluster Red Hat OpenShift usando:

• Web Studio
• PowerShell

Criar uma conexão usando o Web Studio

1. No Web Studio, abra Hospedagem > Adicionar Conexão e Recursos.
2. Na página Conexão, siga estas etapas para configurar a conexão:
   1. Selecione Criar uma nova conexão.
   2. Selecione Red Hat OpenShift como o tipo de conexão.
   3. No campo Endereço da conexão, insira o endereço IP, nome do host ou FQDN do Servidor OpenShift.
   4. Insira seu token de conta de serviço e um nome de conexão amigável.
   5. Selecione uma zona no campo Nome da zona. As opções são todos os locais de recursos que você configurou.

   6. Selecione Outras ferramentas para criar máquinas virtuais.

      Nota:

      A seleção de Outras ferramentas cria apenas a conexão de hospedagem sem uma unidade de hospedagem.

3. Clique em Avançar.

4. Se um certificado autoassinado for detectado, uma página de aviso aparecerá com a impressão digital do certificado. Para prosseguir:

   1. Compare a impressão digital com a do servidor para verificar a validade do certificado.

   2. Se for válido, selecione Confiar no certificado e clique em OK para concluir a configuração da conexão.

      O certificado é marcado como confiável e a impressão digital é salva para validação futura.

5. Na página Escopos, selecione um ou mais escopos para este host.
6. Na página Resumo, verifique a configuração e clique em Concluir.

Criar uma conexão usando comandos PowerShell

Ao criar uma conexão usando o comando PowerShell, forneça as seguintes informações:

• Nome da conexão de hospedagem
• Endereço da API do cluster
• Nome de usuário
• Senha (token da conta de serviço)
• SSLThumbprint: Esta é uma impressão digital de certificado CA e não a impressão digital do servidor API. O servidor fornece a impressão digital do certificado CA se você tentar criar uma conexão de hospedagem sem especificar a impressão digital.
• ZoneUid

1. Abra a janela do PowerShell.
2. Execute add-pssnapin citrix®*.

3. Execute o seguinte comando para criar a conexão de hospedagem.

   Se você tentar criar uma conexão de hospedagem sem especificar a impressão digital, o servidor fornecerá a impressão digital do certificado CA. Por exemplo:

   $newItemParameters = @{
   ConnectionType= "Custom"
   PluginId= "OpenShiftPluginFactory"
   HypervisorAddress = "https://api.myopenshiftclusteraddress.mydomain.local:6443"
   Path= "XDHyp:\Connections\OpenShiftConnectionName"
   Persist= $true
   UserName= "__ServiceAccount__"
   Password= "<service account token>"
   ErrorVariable= "connectionError"
    }
   
   & New-Item @newItemParameters
   
   
   $newItemParameters["SSLThumbprint"] = $connectionError[0].ErrorData.Thumbprint
   $connection = & New-Item @newItemParameters
   $brokerConnection = New-BrokerHypervisorConnection -HypHypervisorConnectionUid $connection.HypervisorConnectionUid
   <!--NeedCopy-->
   

Criar uma unidade de hospedagem

Uma unidade de hospedagem representa um ambiente onde as VMs são criadas. Para criar a unidade de hospedagem, você precisa das seguintes entradas do OpenShift:

• Namespace
• StorageClasses
• Definição de Anexo de Rede

Uma unidade de hospedagem é vinculada a um namespace. Isso significa que uma unidade de hospedagem pode acessar apenas um namespace e gerencia as VMs sob esse namespace.

Você pode criar uma unidade de hospedagem usando:

• Web Studio
• PowerShell

Criar unidades de hospedagem usando o Web Studio

1. Navegue até Hospedagem > Adicionar Conexão e Recursos.

2. Na página Conexão:

   • Para criar uma nova conexão de hospedagem juntamente com uma unidade de hospedagem, selecione Criar uma nova conexão e, em seguida, faça o seguinte:
     1. Selecione Red Hat OpenShift como o tipo de Conexão.
     2. No campo Endereço da conexão, insira o endereço IP, nome do host ou FQDN do Servidor OpenShift.
     3. Insira seu token da conta de serviço e um nome de conexão amigável.
     4. Selecione uma zona no campo Nome da zona. As opções são todos os locais de recursos que você configurou.
     5. Selecione ferramentas de provisionamento Citrix (Machine Creation Services™ ou Citrix Provisioning) para criar máquinas virtuais.
     6. Clique em Avançar.
     7. Na página Aviso, verifique a validade do certificado e selecione Confiar no certificado.
   • Para criar unidades de hospedagem a partir de uma conexão de host existente, selecione Usar uma conexão existente e, em seguida, escolha a conexão relevante.
3. Na página Seleção de Namespace, selecione um namespace para esta conexão.
4. Na página Seleção de Armazenamento, selecione pelo menos um dispositivo de armazenamento para cada tipo de dados suportado antes de prosseguir para a próxima página do assistente. Para obter mais informações sobre a seleção de armazenamento, consulte Armazenamento do host.
5. Na página Rede, insira um nome para os recursos. Esse nome aparece no Studio para identificar a combinação de armazenamento e rede associada à conexão. Selecione uma ou mais redes que as VMs usam.
6. Na página Resumo, verifique os detalhes e clique em Concluir.

Criar unidades de hospedagem usando PowerShell

Ao criar uma unidade de hospedagem usando o comando PowerShell, forneça as seguintes informações:

• Um nome de conexão de hospedagem
• Um nome de unidade de hospedagem
• O nome do namespace de destino
• Um nome de StorageClasses
• Um nome de NetworkAttachmentDefinition

1. Abra a janela do PowerShell.
2. Execute add-pssnapin citrix*.

3. Execute comandos PowerShell para criar a unidade de hospedagem. Por exemplo:

   $HostingConnectionName = "OpenShiftConnectionName"
   $HostingUnitName = "HostingUnitName"
   $TargetNamespace = "TargetNamespaceName"
   $StorageClassToUse = "YourStorageClassesName"
   $NetworkAttachmentDefinition = "YourNetworkAttachmentDefinitionName"
   New-HypStorage `
   -StoragePath @("XDHyp:\Connections\$HostingConnectionName\$TargetNamespace.namespace\$StorageClassToUse.storage") `
   -StorageType "TemporaryStorage"
   New-Item `
   -CustomProperties "" `
   -HypervisorConnectionName $HostingConnectionName `
   -NetworkPath @("XDHyp:\Connections\$HostingConnectionName\$TargetNamespace.namespace\$NetworkAttachmentDefinition.network") `
   -Path @("XDHyp:\HostingUnits\$HostingUnitName") -RootPath "XDHyp:\Connections\$HostingConnectionName\$TargetNamespace.namespace" `
   -StoragePath @("XDHyp:\Connections\$HostingConnectionName\$TargetNamespace.namespace\$StorageClassToUse.storage")
   <!--NeedCopy-->
   

Onde ir em seguida

• Se você estiver no processo de implantação inicial, consulte Criar catálogos de máquinas
• Para informações específicas do Red Hat OpenShift, consulte Criar um catálogo do Red Hat OpenShift

Mais informações

• Conexões e recursos
• Criar catálogos de máquinas