Criar uma imagem preparada para instâncias gerenciadas do Amazon WorkSpaces Core

Crie imagens preparadas para criar um catálogo de máquinas MCS. Você pode criar imagens preparadas usando:

• Web Studio
• Comandos PowerShell

Principais etapas

1. Crie a definição da imagem e as versões iniciais da imagem.
2. Crie versões de imagem a partir da versão inicial da imagem.

Usar o Web Studio

Criar uma definição de imagem e a versão inicial da imagem

Para criar uma definição de imagem e a versão inicial da imagem, faça o seguinte:

1. No Web Studio, vá para o nó Imagens e clique em Criar Definição de Imagem. Clique em Avançar na página Introdução.
2. Na página Definição de Imagem, especifique o tipo de SO e o tipo de sessão para a definição de imagem.

3. Na página Imagem, selecione Recursos (somente os recursos aplicáveis para a conexão definida são listados), uma imagem mestre para usar como modelo para criar a versão da imagem e um perfil de máquina para capturar propriedades de hardware. Selecione um perfil de máquina para capturar propriedades de hardware de uma instância de VM ou versão de modelo de inicialização.

   Nota:

   • Antes de selecionar uma imagem, verifique se a imagem mestre tem o VDA 2311 ou posterior instalado e se o driver MCSIO está instalado no VDA.
   • O Serviço de Metadados de Instância (IMDS) V2 é o único suportado, e não o IMDS V1. Para obter informações, consulte Como funciona o Serviço de Metadados de Instância Versão 2.

4. Na página Especificação da Máquina, selecione um tamanho de máquina. O tamanho da máquina do perfil da máquina (selecionado na página Imagem) é selecionado por padrão.
5. Na página NICs, selecione ou adicione NICs para a imagem de preparação. Para cada NIC, selecione uma sub-rede VPC associada.
6. Na página Descrição da Versão, insira uma descrição para a versão inicial da imagem criada.
7. Na página Resumo, verifique os detalhes da definição da imagem e da versão inicial da imagem criada. Insira um nome e uma descrição para a definição da imagem. Clique em Concluir.

Criar versões de imagem

As versões de imagem permitem o gerenciamento de diferentes iterações ou atualizações de uma imagem específica. Essa funcionalidade permite que você mantenha várias versões de uma imagem para diferentes propósitos.

Para criar versões de imagem a partir da versão inicial da imagem, faça o seguinte:

Nota:

A unidade de hospedagem de todas as versões da imagem deve ser a mesma.

1. Vá para o nó Imagens, selecione uma versão de imagem ou uma definição de imagem e clique em Criar Versão da Imagem.
2. Na página Definição da imagem, você pode alterar a unidade de hospedagem e selecionar novamente a imagem mestre e o perfil da máquina para essa versão da imagem.
3. Se você quiser que a configuração da versão da imagem seja diferente da versão inicial da imagem configurada, configure as definições nas páginas Especificação da Máquina e NICs da caixa de diálogo Criar Versão da Imagem.
4. Adicione uma descrição para a versão da imagem. Clique em Concluir.

Nota:

Se a criação da versão da imagem falhar por qualquer motivo, a guia Solução de problemas na parte inferior fornece uma opção de Repetir.

Usar PowerShell

Os comandos detalhados do PowerShell para criar uma especificação de versão de imagem preparada são os seguintes:

1. Verifique os nomes de definição de imagem disponíveis usando o Test-ProvImageDefinitionNameAvailable command. Por exemplo,

   Test-ProvImageDefinitionNameAvailable -ImageDefinitionName <string[]>
   <!--NeedCopy-->
   

2. Crie uma definição de imagem usando o comando New-ProvImageDefinition. Por exemplo,

   New-ProvImageDefinition -ImageDefinitionName image1 -OsType Windows -VdaSessionSupport MultiSession
   <!--NeedCopy-->
   

3. Crie uma nova configuração para a definição de imagem na conexão de hospedagem especificada usando o comando Add-ProvImageDefinitionConnection.

   Add-ProvImageDefinitionConnection -ImageDefinitionName image1 -HypervisorConnectionName test-conn
   <!--NeedCopy-->
   

4. Crie uma versão de imagem usando o comando New-ProvImageVersion. Por exemplo,

   New-ProvImageVersion -ImageDefinitionName image1 -Description "version 1"
   <!--NeedCopy-->
   

5. Adicione uma especificação de versão de imagem mestre à versão da imagem usando o comando Add-ProvImageVersionSpec. Por exemplo,

   Add-ProvImageVersionSpec -ImageDefinitionName  image1  -ImageVersionNumber  1 -HostingUnitName wsc -MasterImagePath "XDHyp:\HostingUnits\wsc\win10-2411-ami (ami-00123456789abcdef).template”"
   <!--NeedCopy-->
   

   Observação:

   Você pode adicionar apenas uma especificação de versão de imagem mestre a uma versão de imagem para uma unidade de hospedagem.

6. Crie uma especificação de versão de imagem preparada a partir da especificação de versão de imagem mestre usando o comando New-ProvImageVersionSpec. O parâmetro SourceImageVersionSpecUid é derivado do comando Add-ProvImageVersionSpec. Por exemplo,

   New-ProvImageVersionSpec
   -SourceImageVersionSpecUid  00000000-0000-0000-0000-00000000000
   -MachineProfile 'XDHyp:\HostingUnits\wsc\w2022-2411 (lt-00123456789abcdef).launchtemplate\lt-00123456789abcdef (1).launchtemplateversion' -RunAsynchronously
   <!--NeedCopy-->
   

Exemplo do conjunto completo de comandos do Powershell para criar definição de imagem, versão de imagem e especificação de versão de imagem preparada:

New-ProvImageDefinition -ImageDefinitionName image1 -OsType Windows -VdaSessionSupport MultiSession


Add-ProvImageDefinitionConnection -ImageDefinitionName image1 -HypervisorConnectionName wsc -CustomProperties $CustomProperties

$imageVersion = New-ProvImageVersion -ImageDefinitionName image1 -Description "version 1"

$SourceImageVersionSpec = Add-ProvImageVersionSpec -ImageVersionUid $imageVersion.ImageVersionUid `
    -HostingUnitUid $hostingunit.HostingUnitUid `
    -MasterImagePath "XDHyp:\HostingUnits\wsc\win10-2411-ami (ami-00123456789abcdef).template”

New-ProvImageVersionSpec -MachineProfile 'XDHyp:\HostingUnits\wsc\w2022-2411 (lt-00123456789abcdef).launchtemplate\lt-00123456789abcdef (1).launchtemplateversion' -SourceImageVersionSpecUid $SourceImageVersionSpec.ImageVersionSpecUid
Add-ProvImageVersionSpecHostingUnit -ImageVersionSpecUid 00000000-0000-0000-0000-00000000000-HostingUnitName wsc
$PreparedImageVersionSpec = Get-ProvImageVersionSpec -ImageVersionUid $imageVersion.ImageVersionUid | Where SourceImageVersionSpecUid-eq $SourceImageVersionSpec.ImageVersionSpecUid
<!--NeedCopy-->

Observação:

• Todas as especificações de versão de imagem em uma definição de imagem devem pertencer à mesma unidade de hospedagem.
• Uma versão de imagem pode ter apenas uma especificação de versão de imagem mestre e uma especificação de versão de imagem preparada.
• Todas as especificações de versão de imagem devem ter um perfil de máquina.

Compartilhar imagens preparadas entre zonas de disponibilidade e regiões

Agora você pode compartilhar uma única imagem preparada entre diferentes zonas de disponibilidade, vinculadas a diferentes unidades de hospedagem, dentro da mesma região AWS ou em regiões diferentes, para suas instâncias gerenciadas do Amazon WorkSpaces Core. Isso permite que você use uma imagem preparada para criar e atualizar catálogos de máquinas MCS em várias zonas de disponibilidade e regiões. Ao compartilhar entre diferentes AZs em regiões diferentes, a versão da imagem preparada é copiada da região original para as regiões de destino.

Você pode manter uma única imagem preparada e usá-la para criar e atualizar catálogos de máquinas em várias zonas de disponibilidade e regiões vinculadas a diferentes unidades de hospedagem. Isso reduz significativamente sua sobrecarga de gerenciamento de imagens, garante consistência entre as implantações e simplifica o processo de provisionamento. Você também pode atualizar facilmente catálogos de máquinas existentes com imagens preparadas de uma zona de disponibilidade ou região diferente.

Casos de uso

• Gerenciamento Centralizado de Imagens: Você cria uma imagem preparada em uma zona de disponibilidade (por exemplo, us-east-1a). Você pode então compartilhar esta imagem com outras zonas de disponibilidade como us-east-1b dentro da mesma região AWS us-east-1 ou us-west-1a em uma região us-west-1 diferente. Isso permite que uma única imagem atenda a várias unidades de hospedagem e simplifica a manutenção para você.
• Criação e Atualização Eficientes de Catálogos: Você pode usar uma imagem preparada criada em AZ 1 (por exemplo, us-east-1a) para criar novos catálogos em AZ 1. Depois de compartilhar esta imagem para AZ 2 (por exemplo, us-east-1b), você pode então usar a imagem compartilhada em AZ 2 para criar e atualizar catálogos em AZ 2.
• Implantações entre unidades de hospedagem e conexões de hospedagem: Se seu ambiente tiver várias unidades de hospedagem na mesma ou em diferentes regiões e contas AWS, você poderá compartilhar imagens preparadas de forma eficiente entre essas unidades de hospedagem.

Limitações

• Compartilhamento dentro da mesma conta AWS: Você não pode compartilhar entre diferentes contas AWS na implementação atual.

Considerações importantes

• Ordem de exclusão: Para excluir uma especificação de versão de imagem preparada original, você deve primeiro excluir todas as suas especificações de versão de imagem compartilhadas. Alternativamente, você deve excluir as especificações original e compartilhada simultaneamente.
• Dependência da Versão da Imagem: Ao remover uma versão da imagem, você deve primeiro remover quaisquer configurações de compartilhamento que dependam dessa versão específica da imagem. Os catálogos que você criou a partir da imagem original (não compartilhada) podem permanecer intactos.
• Retrocompatibilidade do Catálogo: Você pode atualizar catálogos de máquinas existentes que você implantou antes da introdução deste recurso. Use imagens preparadas que você criou em uma zona de disponibilidade ou região diferente daquela onde você implantou originalmente o catálogo.
• Exclusão completa: Ao excluir uma imagem preparada, você não poderá mais usá-la em nenhuma zona de disponibilidade onde a compartilhou ou a criou originalmente. Além disso, uma versão de imagem preparada não pode ser excluída até que todos os catálogos vinculados a essa versão de imagem preparada sejam excluídos primeiro.

Pré-requisitos

Antes de configurar ou usar este recurso, certifique-se de que você atende às seguintes condições:

• Seu ambiente deve ser um ambiente de instâncias gerenciadas do Amazon WorkSpaces Core.
• Você deve configurar várias unidades de hospedagem (cada uma pode ser vinculada a diferentes zonas de disponibilidade) e conexões de host (cada uma pode ser vinculada a uma região diferente) na mesma conta AWS.

Configurar usando a interface do usuário do Web Studio

Você pode compartilhar imagens preparadas entre zonas de disponibilidade vinculadas a diferentes unidades de hospedagem usando a interface do usuário do Web Studio.

Para compartilhar uma imagem preparada

1. Navegue até o nó Imagens do Web Studio e selecione a versão da imagem preparada que você gostaria de compartilhar com outras zonas de disponibilidade.
2. Selecione Gerenciar Compartilhamento de Imagem na barra de navegação superior para gerenciar o compartilhamento da imagem para a versão da imagem selecionada.
3. Na página Gerenciar Compartilhamento de Imagem, selecione um ou mais recursos com os quais você gostaria de compartilhar a versão da imagem. Os recursos podem estar em zonas de disponibilidade diferentes da versão da imagem original.
4. Clique em Salvar para compartilhar a versão da imagem nos recursos em outras zonas de disponibilidade. A versão da imagem é atualizada de forma que seja compartilhada entre os diferentes recursos que você selecionou. Uma vez concluído, use a versão da imagem para criar catálogos nas zonas de disponibilidade onde a versão da imagem é compartilhada.

Para remover o compartilhamento de uma imagem preparada

1. No nó Imagens do Web Studio, selecione a versão da imagem preparada que você gostaria de remover do compartilhamento.
2. Selecione Gerenciar Compartilhamento de Imagem na barra de navegação superior para gerenciar o compartilhamento da imagem para a versão da imagem selecionada.

3. Desmarque as caixas de seleção de um ou mais recursos (zonas de disponibilidade) com os quais você gostaria de parar de compartilhar a versão da imagem.

   Nota:

   Os recursos não devem mais ter nenhum catálogo associado e criado a partir da versão da imagem compartilhada. Quaisquer catálogos criados a partir da versão da imagem compartilhada a ser removida devem ser excluídos primeiro.

4. Clique em Salvar para remover o compartilhamento dos recursos nas zonas de disponibilidade limpas. A versão da imagem é atualizada de forma que não seja mais compartilhada nessas zonas de disponibilidade.

Configurar usando PowerShell

Alternativamente, você pode compartilhar imagens preparadas entre zonas de disponibilidade vinculadas a diferentes unidades de hospedagem usando comandos PowerShell.

Para compartilhar uma imagem preparada

1. Certifique-se de ter o ImageVersionSpecUid da imagem preparada que deseja compartilhar. Você pode recuperá-lo usando Get-ProvImageVersionSpec ou comandos Get- semelhantes no PowerShell.
2. Determine o HostingUnitName da zona de disponibilidade (pode ser a mesma ou uma região diferente) onde você deseja disponibilizar a imagem preparada. Este é o nome da unidade de hospedagem que você configurou para essa AZ específica.

3. Execute o comando Add-ProvImageVersionSpecHostingUnit: Use o seguinte comando PowerShell. Substitua <ImageVersionSpecUid> pelo Uid da sua imagem e <targetHostingUnitName> pelo nome da unidade de hospedagem na zona de disponibilidade de destino para a qual você deseja compartilhar a especificação da versão da imagem:

   Add-ProvImageVersionSpecHostingUnit -ImageVersionSpecUid <ImageVersionSpecUid> -HostingUnitName <targetHostingUnitName>
   <!--NeedCopy-->
   

4. Após a execução bem-sucedida, você pode ver o status da imagem na interface do usuário do Web Studio, indicando que você a compartilhou com a unidade de hospedagem especificada.

Para remover o compartilhamento de uma imagem preparada

1. Certifique-se de ter o ImageVersionSpecUid da imagem preparada da qual deseja remover o compartilhamento.
2. Determine o HostingUnitName da zona de disponibilidade da qual você deseja remover a imagem compartilhada.

3. Execute o comando Remove-ProvImageVersionSpecHostingUnit: Use o seguinte comando PowerShell. Substitua <ImageVersionSpecUid> pelo Uid da sua imagem e <targetHostingUnitName> pelo nome da unidade de hospedagem na Zona de Disponibilidade de destino da qual você deseja remover o compartilhamento da especificação da versão da imagem:

   Remove-ProvImageVersionSpecHostingUnit -ImageVersionSpecUid <ImageVersionSpecUid> -HostingUnitName <targetHostingUnitName>
   <!--NeedCopy-->
   

Onde ir em seguida

• Para criar um catálogo de instâncias gerenciadas do Amazon WorkSpaces Core, consulte Criar um catálogo de instâncias gerenciadas do Amazon WorkSpaces Core

Mais informações

• Gerenciamento de imagens
• Para exemplos de PowerShell do GitHub do Amazon WorkSpaces Core, consulte citrix-mcs-sdk-samples-Amazon WorkSpaces Core