Documentação de produtos
Citrix Virtual Apps and Desktops
Service Current Release 2402 LTSR 2311 2308 2305 2303 2212 2209 2206 2203 LTSR 1912 LTSR
Ver PDF

Crie um catálogo da AWS

November 8, 2024
Contribuição de: 
C C

Criar catálogos de máquinas descreve os assistentes que criam um catálogo de máquinas. As informações a seguir abrangem detalhes específicos dos ambientes de virtualização da AWS.

Observação:

Antes de criar um catálogo da AWS, você precisa concluir a criação de uma conexão com a AWS. Consulte Conexão com a AWS.

Limitação

Do Citrix Virtual Apps and Desktops 2203 LTSR e versões posteriores, o plug-in MCS AWS faz uma chamada de API da AWS DescribeInstanceTypes e, se isso for bem-sucedido, o MCS usará o nome do inventário criado a partir da resposta da API.

Portanto, ao atualizar do CVAD 1912 para 2203 ou posterior, desative a permissão DefineInstanceType na AWS e atualize o catálogo existente usando o comando Set-ProvScheme para corresponder ao esquema de nomenclatura da AWS. Em seguida, adicione as permissões DescribeInstanceType depois que a atualização do catálogo for concluída e a oferta de serviço corresponder ao esquema de nomenclatura da AWS.

Configuração de rede durante a preparação da imagem

Durante a preparação da imagem, uma máquina virtual (VM) de preparação é criada com base na VM original. Essa VM de preparação está desconectada da rede. Para desconectar a rede da VM de preparação, um grupo de segurança de rede é criado para negar todo o tráfego de entrada e saída. Esse grupo de segurança de rede persiste e é reutilizado. O nome do grupo de segurança de rede é citrix.xendesktop.IsolationGroup-GUID, onde o GUID é gerado aleatoriamente.

Configurar a locação da AWS

A AWS oferece as seguintes opções de locação:

  • Locação compartilhada (o tipo padrão): várias instâncias do Amazon EC2 de clientes diferentes podem residir no mesmo equipamento de hardware físico.
  • Locação dedicada: suas instâncias do EC2 são executadas somente no hardware com as outras instâncias que você implantou. Outros clientes não usam o mesmo equipamento de hardware.

Você pode usar o MCS para provisionar hosts dedicados da AWS usando o PowerShell.

Configurar a locação de host dedicada da AWS usando o PowerShell

Você pode criar um catálogo de máquinas com a locação de host definida por meio do PowerShell.

Um host dedicado [EC2] da Amazon é um servidor físico com capacidade de instância [EC2] totalmente dedicada, permitindo que você use licenças de software existentes por soquete ou por VM.

Os hosts dedicados têm utilização predefinida com base no tipo de instância. Por exemplo, um único host dedicado alocado dos tipos de instância C4 Large é limitado à execução de 16 instâncias. Consulte o site da AWS para obter mais informações.

Os requisitos de provisionamento para os hosts da AWS incluem:

  • Uma imagem (AMI) importada da BYOL (traga sua própria licença). Com hosts dedicados, use e gerencie suas licenças existentes.
  • Uma alocação de hosts dedicados com utilização suficiente para atender às solicitações de provisionamento.
  • Ativar o posicionamento automático.

Para provisionar um host dedicado na AWS usando o PowerShell, use o cmdlet New-ProvScheme com o parâmetro TenancyType definido como Host.

Consulte a Documentação do Citrix Developer para obter mais informações.

Capture propriedades da máquina a partir de AMIs

Ao criar um catálogo para provisionar máquinas usando o Machine Creation Services (MCS) na AWS, você seleciona uma AMI para representar a imagem mestre/de ouro do catálogo. A partir dessa AMI, o MCS usa um instantâneo do disco. Em versões anteriores, se você quisesse funções ou marcações em suas máquinas, usaria o console da AWS para defini-las individualmente. Essa funcionalidade é ativada por padrão.

Dica:

Para usar a captura de propriedade da instância da AWS, você deve ter uma VM associada à AMI.

Para melhorar esse processo, o MCS lê as propriedades da instância a partir da qual a AMI foi obtida e aplica a função de Identity Access Management (IAM) e as marcas da máquina às máquinas provisionadas de um determinado catálogo. Ao usar esse recurso opcional, o processo de criação do catálogo localiza a instância de origem da AMI selecionada, lendo um conjunto limitado de propriedades. Essas propriedades são armazenadas em um Launch Template da AWS, que é usado para provisionar máquinas para esse catálogo. Qualquer máquina no catálogo herda as propriedades da instância capturada.

As propriedades capturadas incluem:

  • Funções de IAM – aplicadas a instâncias provisionadas.
  • Marcações – aplicadas a instâncias provisionadas, seus discos e NICs. Essas marcações são aplicadas a recursos temporários da Citrix, incluindo: objetos e bucket S3, e AMIs, instantâneos e modelos de execução.

Dica:

A marcação de recursos temporários da Citrix é opcional e configurável usando a propriedade personalizada AWSOperationalResourceTagging.

Capturar a propriedade da instância da AWS

Você pode usar esse recurso especificando uma propriedade personalizada, AWSCaptureInstanceProperties, ao criar um esquema de provisionamento para uma conexão de hospedagem da AWS:

New-ProvScheme -CustomProperties "AwsCaptureInstanceProperties,true" …<parâmetros provscheme padrão

Consulte a Documentação do Citrix Developer para obter mais informações.

Observação:

O AWSCaptureInstanceProperties está obsoleto. Em vez disso, recomendamos usar perfis de máquina para especificar as propriedades da máquina para VMs.

Capture as propriedades da máquina a partir dos perfis da máquina

Ao criar um catálogo para provisionar máquinas da AWS usando o MCS, você pode usar um perfil de máquina para predefinir determinadas configurações de propriedades da máquina.

Para isso, siga estes passos:

  1. Armazene os perfis da máquina na mesma zona de disponibilidade dos recursos em que você está criando esse catálogo.
  2. Na página Machine Template do assistente de criação de catálogo, selecione Use a machine profile. Perfis de máquina localizados na mesma zona disponível dos recursos que você selecionou são mostrados.
  3. Selecione um perfil de máquina conforme necessário.

Observação:

Você pode usar um perfil de máquina ou uma AMI para capturar as propriedades da máquina. No Web Studio, quando você seleciona Usar um perfil de máquina, a opção Aplicar propriedades do modelo de máquina às máquinas virtuais fica automaticamente oculta.

Marcar um recurso operacional AWS

Ao criar um catálogo para provisionar máquinas na AWS usando o MCS, você pode controlar se as propriedades de função e marcação com tag do IAM devem ser aplicadas a essas máquinas. Você também pode controlar se as marcas de máquina devem ser aplicadas aos recursos operacionais.

Uma Amazon Machine Image (AMI) representa um tipo de dispositivo virtual usado para criar uma máquina virtual dentro do ambiente de nuvem Amazon Cloud, comumente chamado de EC2. Você usa uma AMI para implantar serviços que usam o ambiente EC2. Quando cria um catálogo para provisionar máquinas usando o MCS para AWS, você seleciona a AMI para atuar como a imagem de ouro do catálogo.

Importante:

A criação de catálogos por meio da captura de uma propriedade de instância e um modelo de execução é necessária para usar a marcação de recursos operacionais.

Para criar um catálogo da AWS, você deve primeiro criar uma AMI para a instância que você quer que seja a imagem de ouro. O MCS lê as marcas dessa instância e as incorpora ao modelo de execução. As marcas do modelo de execução são então aplicadas a todos os recursos da Citrix criados no seu ambiente da AWS, incluindo:

  • Máquinas virtuais
  • Discos VM
  • Interfaces de rede VM
  • Buckets do S3
  • Objetos do S3
  • Modelos de execução
  • AMIs

Marcar um recurso operacional

Para usar o PowerShell para marcar recursos:

  1. Abra uma janela do PowerShell no host DDC.
  2. Execute o comando asnp citrix para carregar módulos PowerShell específicos da Citrix.

Para marcar um recurso para uma VM provisionada, use a nova propriedade personalizada AWSOperationalResourceTagging. A sintaxe dessa propriedade é:

Novo-ProvScheme - CustomProperties "AwsCaptureInstanceProperties, verdadeiro; AwsOperationalResourcesTagging, verdadeiro" …<standard provscheme parameters>

O que fazer a seguir

Copiar tags em VMs

Você pode copiar tags em NICs e discos (disco de identidade, disco de cache de gravação e disco do sistema operacional) especificados no perfil da máquina para VMs recém-criadas em um catálogo de máquinas MCS. Você pode especificar essas tags em qualquer fonte de perfil de máquina (instância de VM da AWS ou versão do modelo de lançamento da AWS). Esse recurso é aplicável a catálogos de máquinas e VMs persistentes e não persistentes.

Observação:

  • No console do AWS EC2, você não pode ver os valores Tag Network Interfaces em Launch Template Version Resource Tags. No entanto, você pode executar o comando do PowerShell aws ec2 describe-launch-template-versions --launch-template-id lt-0bb652503d45dcbcd --versions 12 para ver as especificações da tag.

  • Se uma fonte de perfil de máquina (VM ou versão do modelo de lançamento) tiver duas interfaces de rede (eni-1 e eni-2) e eni-1 tiver a tag t1 e eni-2 tiver a tag t2, a VM obterá as tags das duas interfaces de rede.

Criar um catálogo usando um perfil de máquina

Ao criar um catálogo para provisionar máquinas usando o Machine Creation Services (MCS) na AWS, agora você pode usar um perfil de máquina para capturar as propriedades de hardware de uma instância EC2 (VM) ou iniciar a versão do modelo e aplicá-las às máquinas provisionadas. As propriedades capturadas podem incluir, por exemplo, propriedades de volume do EBS, tipo de instância, otimização do EBS e outras configurações compatíveis da AWS. Ao editar o catálogo, o perfil de máquina das máquinas provisionadas pode ser alterado fornecendo uma VM ou um modelo de inicialização diferente.

Observação:

As propriedades de volume do EBS são derivadas somente de um perfil de máquina.

Considerações importantes

Considerações importantes ao criar um catálogo de máquinas MCS:

  • Se você adicionar parâmetros de propriedade de hardware da máquina nos comandos New-ProvScheme e Set-ProvScheme , os valores fornecidos nos parâmetros substituirão os valores no perfil da máquina.
  • Se você definir AWSCaptureInstanceProperties como true e não definir a propriedade machineProfile , somente as funções e tags do IAM serão capturadas.

  • Você não pode definir AWSCaptureInstanceProperties e MachineProfile ao mesmo tempo.

    Observação:

    O AWSCaptureInstanceProperties está obsoleto.

  • Você deve fornecer explicitamente os valores das seguintes propriedades:

    • TenancyType
    • Grupo de Segurança
    • NIC ou rede virtual
  • Você pode ativar AWSOperationalResourceTagging somente se ativar AWSCaptureInstanceProperties ou especificar um perfil de máquina.

Considerações importantes após criar um catálogo de máquinas MCS:

  • Somente as novas VMs adicionadas ao catálogo são afetadas pela alteração.
  • Você não pode alterar de um catálogo baseado em perfil de máquina para um catálogo não baseado em perfil de máquina.

Crie um catálogo de máquinas usando um perfil de máquina

Para criar um catálogo de máquinas usando um perfil de máquina:

  1. Abra uma janela do PowerShell.
  2. Execute asnp citrix* para carregar os módulos do PowerShell específicos à Citrix.

  3. Crie um pool de identidades se ainda não tiver sido criado. Por exemplo,

    New-AcctIdentityPool -IdentityPoolName idPool -NamingScheme ms## -Domain abcdf -NamingSchemeType Numérico
<!--NeedCopy-->

  4. Execute o comando New-ProvScheme. Por exemplo:

    Novo-ProvScheme -Nome do esquema de provisionamento demet-test-1
-HostingUnitUid aa633238-9xxd-4cf6-80e8-232a758a1xx1
-IdentityPoolUid 34d5b088-e312-416f-907d-16573xxxxxc4
-CleanOnBoot
-MasterImageVM 'XDHyp:\HostingUnits\cvad-test-scalestress\citrix-demet-ami.0 (ami-0ca813xxxxxx061ef).template'
-Perfil da máquina 'XdHyp:\HostingUnits\cvad-test-scalestress\us-east-1a.availabilityzone\machine-profile-instance i (i-0xxxxxxxx).vm'
<!--NeedCopy-->
  5. Conclua a criação do catálogo. Para obter mais informações, consulte Citrix PowerShell SDK.

Para atualizar o perfil da máquina em um catálogo que foi inicialmente provisionado com um perfil de máquina:

  1. Execute o comando Set-provScheme . Por exemplo,

    Definir-ProvScheme `
-ProvisioningSchemeUid "<ID" `
-MachineProfile "XDHyp:\HostingUnits\abc\us-east-1a.availabilityzone\citrix-cvad-machineprofile-instance (i-0xxxxxxxx).vm"
<!--NeedCopy-->

Criar um catálogo com a versão do modelo de execução

Você pode criar um catálogo de máquinas MCS com uma versão do modelo de execução como entrada do perfil da máquina. Você também pode atualizar a entrada de um catálogo de perfis de máquina de uma VM para uma versão de modelo de execução e de uma versão de modelo de execução para uma VM.

No console da AWS EC2, você pode fornecer as informações de configuração da instância de um modelo de execução juntamente com o número da versão. Quando você especifica a versão do modelo de execução como uma entrada de perfil de máquina ao criar ou atualizar um catálogo de máquinas, as propriedades dessa versão do modelo de execução são copiadas para as VMs VDA provisionadas.

As propriedades a seguir podem ser fornecidas usando a entrada do perfil da máquina ou explicitamente como parâmetros nos comandos New-ProvScheme ou Set-ProvScheme. Se forem fornecidos nos comandos New-ProvScheme ou Set-ProvScheme , eles terão precedência sobre os valores de perfil de máquina dessas propriedades.

  • Oferta de serviço
  • Redes
  • Grupos de segurança
  • Tipo de locação

Observação:

Se a oferta de serviço não for fornecida no modelo de inicialização do perfil da máquina ou como um parâmetro no comando New-ProvScheme , você receberá um erro apropriado.

Para criar um catálogo usando a versão do modelo de execução como uma entrada de perfil da máquina:

  1. Abra uma janela do PowerShell.
  2. Execute asnp citrix* para carregar os módulos do PowerShell específicos à Citrix.

  3. Obtenha a lista de versões de modelo de execução de um modelo de execução. Por exemplo:

    XDHyp:\HostingUnits\test\test-mp-sard (lt-01xxxxx).launchtemplate> ls | Selecione Caminho Completo
<!--NeedCopy-->

  4. Crie um pool de identidades se não tiver sido criado. Por exemplo:

    Novo-AcctIdentityPool `
-IdentityPoolName "abc11" `
-NamingScheme "abc1-##" `
-NamingSchemeType Numérico `
-Domínio "citrix-xxxxxx.local" `
-ZoneUid "xxxxxxxx" `
<!--NeedCopy-->

  5. Crie um esquema de provisionamento com uma versão do modelo de execução como entrada do perfil da máquina. Por exemplo:

    Novo-ProvScheme `
-ProvisioningSchemeName "MPLT1" `
-HostingUnitUid "c7f71f6a-3f45-4xxx-xxxx-xxxxxxxxxxxx" `
-IdentityPoolUid "bf3a6ba2-1f80-4xxx-xxxx-xxxxxxxxx" `
-MasterImageVM "XDHyp:\HostingUnits\xxxd-ue1a\apollo-non-persistent-vda-win2022 (ami-0axxxxxxxxxxxx).template" `
-CleanOnBoot `
-MachineProfile "XDHyp:\HostingUnits\xxxx-ue1a\machineprofiletest (lt-01xxxxx).launchtemplate\lt-01xxxxx (1).launchtemplateversion"
<!--NeedCopy-->

    Você também pode substituir parâmetros como oferta de serviço, grupos de segurança, locação e redes. Por exemplo:

    Novo-ProvScheme `
-ProvisioningSchemeName "MPLT1" `
-HostingUnitUid " c7f71f6a-3f45-4xxx-xxxx-xxxxxxxxxxxx" `
-IdentityPoolUid " bf3a6ba2-1f80-4xxx-xxxx-xxxxxxxxx" `
-MasterImageVM "XDHyp:\HostingUnits\xxxd-ue1a\apollo-non-persistent-vda-win2022 (ami-0axxxxxxxxxxxx).template" `
-CleanOnBoot `
-MachineProfile "XDHyp:\HostingUnits\xxxx-ue1a\machineprofiletest (lt-01xxxx).launchtemplate\lt-01xxxx (1).launchtemplateversion" `
-ServiceOffering "XDHyp:\HostingUnits\xxxd-ue1a\T3 Instância grande.serviceoffering"
<!--NeedCopy-->

  6. Registre o esquema de provisionamento como um catálogo de agente. Por exemplo:

    New-BrokerCatalog -Nome "MPLT1" `
-AllocationType Random `
-Description "Catálogo de perfil de máquina" `
-ProvisioningSchemeId fe7df345-244e-4xxxx-xxxxxxxxx `
-ProvisioningType Mcs `
-SessionSupport MultiSession `
-PersistUserChanges Descartar
<!--NeedCopy-->
  7. Conclua a criação do catálogo. Para obter mais informações, consulte Citrix PowerShell SDK

Você também pode atualizar a entrada de um catálogo de perfis de máquina de uma VM para uma versão de modelo de execução e de uma versão de modelo de execução para uma VM. Por exemplo:

  • Para atualizar a entrada de um catálogo de perfis de máquina de uma VM para uma versão de modelo de execução:

     Set-ProvScheme -ProvisioningSchemeName "CloudServiceOfferingTest" `
 -MachineProfile "XDHyp:\HostingUnits\xxxx-ue1a\machineprofiletest (lt-0bxxxxxxxxxxxx).launchtemplate\lt-0bxxxxxxxxxxxx (1).launchtemplateversion"
 <!--NeedCopy-->

  • Para atualizar a entrada de um catálogo de perfis de máquina de uma versão do modelo de execução para uma VM:

     Set-ProvScheme -ProvisioningSchemeName "CloudServiceOfferingTest" `
 -MachineProfile "XDHyp:\HostingUnits\sard-ue1a\us-east-1a.availabilityzone\apollo-non-persistent-vda-win2022-2 (i-08xxxxxxxxx).vm"
 <!--NeedCopy-->

Filtrar instâncias de VM

Uma instância do AWS EC2 que você usa como uma VM de perfil de máquina deve ser compatível para que o catálogo de máquinas seja criada e funcione corretamente. Para listar as instâncias do AWS EC2 que podem ser usadas como VMs de entrada de perfil de máquina, você pode usar o comando Get-HypInventoryItem . O comando pode paginar e filtrar o inventário de VMs disponíveis em uma unidade de hospedagem.

Paginação:

Get-HypInventoryItem suporta dois modos de paginação:

  • O modo de paginação usa os parâmetros -MaxRecords e -Skip para retornar conjuntos de itens:

    • -MaxRecords: O padrão é 1. Isso controla quantos itens retornar.
    • -Skip: O padrão é 0. Isso controla quantos itens devem ser ignorados do início absoluto (ou final absoluto) da lista no hipervisor.

  • O modo de rolagem usa os parâmetros -MaxRecords, -ForwardDirectione -ContinuationToken para permitir a rolagem dos registros:

    • -ForwardDirection: O padrão é True. Isso é usado junto com -MaxRecords para retornar o próximo conjunto de registros correspondentes ou o conjunto anterior de registros correspondentes.
    • -ContinuationToken: devolve os itens imediatamente após (ou antes, se forwardDirection for false), mas sem incluir o item fornecido no ContinuationToken.

Exemplos de paginação:

  • Para retornar um único registro do modelo de máquina com o nome mais baixo. O campo AdditionalData tem TotalItemsCount e TotalFilteredItemsCount:

     Get-HypInventoryItem -LiteralPath "XDHyp:\HostingUnits\ctx-test" -Modelo ResourceType
 <!--NeedCopy-->

  • Para retornar 10 registros do modelo de máquina com o nome mais baixo:

     Get-HypInventoryItem -LiteralPath "XDHyp:\HostingUnits\ctx-test" -ResourceType modelo -MaxRecords 10 | selecione Nome
 <!--NeedCopy-->

  • Para retornar uma matriz de registros que terminam com o nome mais alto:

     Get-HypInventoryItem -LiteralPath "XDHyp:\HostingUnits\ctx-test" -ResourceType template -ForwardDirection $False -MaxRecords 10 | selecione Nome
 <!--NeedCopy-->

  • Para retornar uma matriz de registros começando no modelo de máquina associado ao ContinuationTokenfornecido:

     Get-HypInventoryItem -LiteralPath "XDHyp:\HostingUnits\ctx-test" -Modelo ResourceType -ContinuationToken "ami-07xxxxxxxxxx" -MaxRecords 10
 <!--NeedCopy-->

Filtragem:

Os seguintes parâmetros opcionais adicionais são suportados para filtragem. Você pode combinar esses parâmetros com as opções de paginação.

  • -ContainsName "my_name": Se a string fornecida corresponder a parte de um nome de AMI, a AMI será incluída no resultado Obter . Por exemplo:

     Get-HypInventoryItem -LiteralPath "XDHyp:\HostingUnits\ctx-test" -ResourceType modelo -MaxRecords 100 -ContainName 'apollo' | selecione Nome
 <!--NeedCopy-->

  • -Tags '{ "Key0": "Value0", "Key1": "Value1", "Key2": "Value2" }': Se uma AMI tiver pelo menos uma dessas tags, ela será incluída no resultado Obter . Por exemplo:

     Get-HypInventoryItem -LiteralPath "XDHyp:\HostingUnits\ctx-test" -ResourceType template -MaxRecords 100 -Tags '{"opex owner": "Não marcado"}' | selecione Nome
 <!--NeedCopy-->

    Observação:

    Dois valores de tag são suportados. O valor da tag Not Tagged corresponde a itens que não têm a tag especificada em sua lista de tags. Todos os valores tag value correspondem aos itens que têm a tag, independentemente do valor da tag. Caso contrário, a correspondência só acontece se o item tiver a tag e o valor for igual ao fornecido no filtro.

  • -Id "ami-0a2d913927e0352f3": Se a AMI corresponder ao ID fornecido, ela será incluída no resultado Obter . Por exemplo:

     Get-HypInventoryItem -LiteralPath "XDHyp:\HostingUnits\ctx-test" -ResourceType modelo -Id ami-xxxxxxxxxxxxxxx
 <!--NeedCopy-->

Filtragem pelo parâmetro AdditionalData:

O parâmetro de filtro AdditionalData lista modelos ou VMs com base em sua capacidade, oferta de serviço ou qualquer propriedade que esteja em AdditionalData. Por exemplo:

(Get-HypInventoryItem -ResourceType "launchtemplateversion" -LiteralPath "XDHyp:\HostingUnits\aws" -MaxRecords 200).Dados Adicionais
<!--NeedCopy-->

Você também pode adicionar um parâmetro -Warn para indicar as VMs incompatíveis. As VMs estão incluídas em um campo additionalData chamado Warning. Por exemplo:

(Get-HypInventoryItem -ResourceType "launchtemplateversion" -LiteralPath "XDHyp:\HostingUnits\aws" -MaxRecords 200 -Template "ami-015xxxxxxxxx" -Warn $true).Dados Adicionais
<!--NeedCopy-->

Mais informações

Crie um catálogo da AWS
November 8, 2024
Contribuição de: 
C C
November 8, 2024
Contribuição de: 
C C

Neste artigo

Feedback do site | Your privacy choices footer linkSuas escolhas de privacidade | Privacidade e termos legais | Preferências de cookies | Configurações de consentimento | docs.cloud.com
© 1999- Cloud Software Group, Inc. All rights reserved.