Criar um catálogo Red Hat OpenShift

Last published : Nov 13, 2026
(/pt-br/citrix-virtual-apps-desktops/2503/install-configure/machine-catalogs-create.html) descreve os assistentes que criam um catálogo de máquinas. As informações a seguir cobrem detalhes específicos para ambientes de virtualização Red Hat OpenShift.
Nota:
Antes de criar um catálogo Red Hat OpenShift, conclua a criação de uma conexão e unidade de hospedagem para o Red Hat OpenShift. Consulte Conexão com Red Hat OpenShift.
Related information
Criar catálogos de máquinas

Criar uma VM de imagem mestre

É necessária uma VM de imagem mestre para criar um catálogo de máquinas.
  1. Acesse o Console do OpenShift usando seu ID de login.
  2. navegar até Virtualization > VirtualMachines para ver a lista de VMs, incluindo VMs de imagem mestre.
  3. Crie uma imagem mestre. Ao criar uma imagem mestre, certifique-se de que a VM da imagem mestre tenha apenas um dispositivo de armazenamento.
Nota:
  • Remova a Definição de Anexo de Rede (NAD) padrão com tipo Masquerade e rede de pod, que é anexada automaticamente ao criar a VM da imagem mestre. Além disso, certifique-se de que um NAD roteável seja adicionado à VM da imagem mestre de acordo com os requisitos do cliente para o ambiente de cluster.
  • Quando a imagem mestre é unida a um domínio, ela pode perder a confiança do domínio após ser usada para a criação do catálogo. Esse problema afeta o Citrix Virtual Apps and Desktops™ 2503 devido a uma limitação no ambiente OpenShift. A solução alternativa é não unir o domínio em imagens mestre. A Citrix está trabalhando com a Red Hat para aprimorar os recursos de isolamento de rede.
  • Ao criar um catálogo de máquinas MCS em um ambiente de virtualização Red Hat OpenShift, você não pode usar uma imagem mestre e um perfil de máquina que tenham tipos de sistema operacional diferentes. Isso se deve à forma como o Red Hat OpenShift gerencia cada tipo de SO. Portanto, usar uma VM Windows como imagem mestre com uma VM não Windows (exemplo, Linux) como perfil de máquina, ou vice-versa, não é suportado.
  • Atualmente, as VMs criadas usando InstanceType não são suportadas como uma imagem mestre.
Você pode criar catálogos OpenShift para criar, entregar e gerenciar o consumo de energia de máquinas em seus ambientes OpenShift.

Criar um catálogo usando o Web Studio

Atualmente, você pode usar o Studio para criar catálogos do OpenShift para entregar e gerenciar a energia de máquinas existentes em seus ambientes OpenShift
No assistente de Configuração do Catálogo de Máquinas:
  1. Na página Sistema operacional, selecione SO multissessão ou SO de sessão única.
  2. Na página Gerenciamento de Máquinas, selecione Máquinas com gerenciamento de energia e Outro serviço ou tecnologia.
  3. Na página Máquinas Virtuais, adicione máquinas e suas contas de máquina do Active Directory. Você pode:
    • Adicionar máquinas manualmente: Clique em Adicionar Máquinas para adicionar máquinas manualmente. A janela Selecionar VMs é exibida. Expanda a conexão OpenShift que você criou anteriormente e selecione os nós (VMs) que deseja adicionar. Em seguida, adicione os nomes das contas de máquina associadas.
    • Adicionar máquinas usando um arquivo CSV: Clique em Adicionar Arquivo CSV para adicionar máquinas em massa. Para obter informações sobre como usar arquivos CSV para adicionar máquinas, consulte Usar arquivos CSV para adicionar máquinas em massa a um catálogo.
  4. Siga as instruções na tela para concluir as etapas restantes, que não incluem informações específicas do OpenShift.

Criar um catálogo usando comandos PowerShell

Atualmente, você pode criar um catálogo de máquinas MCS no ambiente Red Hat OpenShift usando apenas comandos PowerShell. Você pode criar o catálogo de máquinas com ou sem o uso de um perfil de máquina. Uma VM é usada como entrada de perfil de máquina.
  1. Abra uma janela do PowerShell.
  2. Execute asnp citrix*.
  3. Execute comandos PowerShell para
    1. Criar um pool de identidades
    2. Criar contas AD
    3. Crie um catálogo de máquinas MCS com VMs persistentes com ou sem um perfil de máquina.
    4. Adicionar VMs ao catálogo
    5. Criar um catálogo de broker
    6. Adicionar máquinas broker às novas VMs
A seguir, um script de exemplo:

Criar um pool de identidades

New-AcctIdentityPool `
    -IdentityPoolName "IdentityPoolName" `
    -ZoneUid "00000000-0000-0000-0000-000000000000" `
    -NamingScheme "vm###" `
    -NamingSchemeType "Numeric" `
    -AllowUnicode `
    -Domain "MyDomain.local" `
    -AdminAddress "MyDDC.MyDomain.Local"

Criar contas AD

New-AcctADAccount `
    -IdentityPoolUid "11111111-1111-1111-1111-111111111111" `
    -ADUserName "MyDomain\MyUserName" `
    -ADPassword SecurePassword `
    -Count 1 `
    -AdminAddress "MyDDC.MyDomain.Local"

Criar um esquema de provisionamento com máquinas persistentes (sem perfil de máquina)

New-ProvScheme `
    -ProvisioningSchemeName "ProvisioningSchemeName" `
    -HostingUnitName "HostingUnitName" `
    -IdentityPoolName "IdentityPoolName" `
    -ProvisioningSchemeType "MCS" `
    -MasterImageVM "XDHyp:\HostingUnits\HostingUnitName\TargetNamespace.namespace\MasterImageVM.vm" `
    -NetworkMapping @{"0" = "XDHyp:\HostingUnits\HostingUnitName\TargetNamespace.namespace\MyNetwork.network" } `
    -VMCpuCount 1 `
    -VMMemoryMB 4096 `
    -InitialBatchSizeHint 1 `
    -AdminAddress "MyDDC.MyDomain.Local"

Criar um esquema de provisionamento com máquinas persistentes (com perfil de máquina)

New-ProvScheme `
    -ProvisioningSchemeName "ProvisioningSchemeName" `
    -HostingUnitName "HostingUnitName" `
    -IdentityPoolName "IdentityPoolName" `
    -ProvisioningSchemeType "MCS" `
    -MasterImageVM "XDHyp:\HostingUnits\HostingUnitName\TargetNamespace.namespace\MasterImageVM.vm" `
    -NetworkMapping @{"0" = "XDHyp:\HostingUnits\HostingUnitName\TargetNamespace.namespace\MyNetwork.network" } `
    -VMCpuCount 1 `
    -VMMemoryMB 4096 `
    -InitialBatchSizeHint 1 `
    -AdminAddress "MyDDC.MyDomain.Local" `
    -MachineProfile "XDHyp:\HostingUnits\HostingUnitName\TargetNamespace.namespace\MachineProfileVM.vm"

Criar novas ProvVMs

New-ProvVM `
    ProvisioningSchemeName "ProvisioningSchemeName" `
    ADAccountName "MyDomain\vm001" `
    AdminAddress "MyDDC.MyDomain.Local"

Lock-ProvVM `
    -ProvisioningSchemeName "ProvisioningSchemeName" `
    -Tag "Brokered" `
    -VMID "TargetNamespace:vm001"

Criar novo catálogo de broker

New-BrokerCatalog `
    -Name "ProvisioningSchemeName" `
    -ProvisioningType "MCS" `
    -SessionSupport "MultiSession" `
    -AllocationType "Random" `
    -PersistUserChanges "OnLocal" `
    -ZoneUid "00000000-0000-0000-0000-000000000000" `
    -AdminAddress "MyDDC.MyDomain.Local"

Definir metadados do catálogo de broker

Set-BrokerCatalogMetadata `
    -CatalogId "1" `
    -Name "Citrix_DesktopStudio_IdentityPoolUid" `
    -Value "11111111-1111-1111-1111-111111111111"

Set-BrokerCatalog `
    -Name "ProvisioningSchemeName " `
    -ProvisioningSchemeId "22222222-2222-2222-2222-222222222222"

Criar máquinas de broker para as novas ProvVMs

New-BrokerMachine `
    -CatalogUid "33333333-3333-3333-3333-333333333333" `
    -AdminAddress "MyDDC.MyDomain.Local" `
    -MachineName "S-0-0-00-0000000000-0000000000-000000000-000000"

Próximos passos

Mais informações