Crea un’immagine preparata per le istanze gestite di Amazon WorkSpaces Core

Crea immagini preparate per creare un catalogo macchine MCS. Puoi creare immagini preparate utilizzando:

• Web Studio
• Comandi PowerShell

Passaggi chiave

1. Crea la definizione dell’immagine e le versioni iniziali dell’immagine.
2. Crea versioni dell’immagine dalla versione iniziale dell’immagine.

Usa Web Studio

Crea una definizione dell’immagine e la versione iniziale dell’immagine

Per creare una definizione dell’immagine e la versione iniziale dell’immagine, procedi come segue:

1. Da Web Studio, vai al nodo Immagini e fai clic su Crea definizione immagine. Fai clic su Avanti nella pagina Introduzione.
2. Nella pagina Definizione immagine, specifica il tipo di sistema operativo e il tipo di sessione per la definizione dell’immagine.

3. Nella pagina Immagine, seleziona Risorse (sono elencate solo le risorse applicabili per la connessione impostata), un’immagine master da utilizzare come modello per la creazione della versione dell’immagine e un profilo macchina da cui acquisire le proprietà hardware. Seleziona un profilo macchina per acquisire le proprietà hardware da un’istanza VM o da una versione del modello di avvio.

   Nota:

   • Prima di selezionare un’immagine, verifica che l’immagine master abbia VDA 2311 o versione successiva installata e che il driver MCSIO sia installato sul VDA.
   • È supportato solo l’Instance Metadata Service (IMDS) V2 e non l’IMDS V1. Per informazioni, vedere How Instance Metadata Service Version 2 works.

4. Nella pagina Specifiche macchina, selezionare una dimensione della macchina. La dimensione della macchina del profilo macchina (selezionata nella pagina Immagine) è selezionata per impostazione predefinita.
5. Nella pagina NIC, selezionare o aggiungere NIC per l’immagine di preparazione. Per ogni NIC, selezionare una subnet VPC associata.
6. Nella pagina Descrizione versione, immettere una descrizione per la versione iniziale dell’immagine creata.
7. Nella pagina Riepilogo, controllare i dettagli della definizione dell’immagine e della versione iniziale dell’immagine creata. Immettere un nome e una descrizione per la definizione dell’immagine. Fare clic su Fine.

Creare versioni dell’immagine

Le versioni dell’immagine consentono la gestione di diverse iterazioni o aggiornamenti di una particolare immagine. Questa funzionalità consente di mantenere più versioni di un’immagine per scopi diversi.

Per creare versioni dell’immagine dalla versione iniziale dell’immagine, procedere come segue:

Nota:

L’unità di hosting di tutte le versioni dell’immagine deve essere la stessa.

1. Andare al nodo Immagini, selezionare una versione dell’immagine o una definizione dell’immagine e fare clic su Crea versione immagine.
2. Nella pagina Definizione immagine, è possibile modificare l’unità di hosting e riselezionare l’immagine master e il profilo macchina per quella versione dell’immagine.
3. Se si desidera che la configurazione della versione dell’immagine sia diversa dalla versione iniziale dell’immagine configurata, configurare le impostazioni nelle pagine Specifiche macchina e NIC della finestra di dialogo Crea versione immagine.
4. Aggiungere una descrizione per la versione dell’immagine. Fare clic su Fine.

Nota:

Se la creazione della versione dell’immagine fallisce per qualsiasi motivo, la scheda Risoluzione dei problemi in basso fornisce un’opzione Riprova.

Usa PowerShell

I comandi PowerShell dettagliati per creare una specifica di versione dell’immagine preparata sono i seguenti:

1. Controlla i nomi delle definizioni di immagine disponibili usando Test-ProvImageDefinitionNameAvailable command. Ad esempio,

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

2. Crea una definizione di immagine usando il comando New-ProvImageDefinition. Ad esempio,

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

3. Crea una nuova configurazione per la definizione dell’immagine nella connessione di hosting specificata usando il comando Add-ProvImageDefinitionConnection.

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

4. Crea una versione dell’immagine usando il comando New-ProvImageVersion. Ad esempio,

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

5. Aggiungi una specifica di versione dell’immagine master alla versione dell’immagine usando il comando Add-ProvImageVersionSpec. Ad esempio,

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

   Nota:

   È possibile aggiungere una sola specifica di versione dell’immagine master a una versione dell’immagine per un’unità di hosting.

6. Crea una specifica di versione dell’immagine preparata dalla specifica di versione dell’immagine master usando il comando New-ProvImageVersionSpec. Il parametro SourceImageVersionSpecUid è derivato dal comando Add-ProvImageVersionSpec. Ad esempio,

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

Esempio del set completo di comandi Powershell per creare la definizione dell’immagine, la versione dell’immagine e la specifica della versione dell’immagine preparata:

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-->

Nota:

• Tutte le specifiche di versione dell’immagine in una definizione di immagine devono appartenere alla stessa unità di hosting.
• Una versione dell’immagine può avere una sola specifica di versione dell’immagine master e una sola specifica di versione dell’immagine preparata.
• Tutte le specifiche della versione dell’immagine devono avere un profilo macchina.

Condividere immagini preparate tra zone di disponibilità e regioni

Ora è possibile condividere una singola immagine preparata tra diverse zone di disponibilità, legate a diverse unità di hosting, all’interno della stessa regione AWS o in regioni diverse, per le istanze gestite di Amazon WorkSpaces Core. Ciò consente di utilizzare un’unica immagine preparata per creare e aggiornare i cataloghi di macchine MCS in varie zone di disponibilità e regioni. Quando si condivide tra diverse zone di disponibilità in regioni diverse, la versione dell’immagine preparata viene copiata dalla regione originale alle regioni di destinazione.

È possibile mantenere una singola immagine preparata e utilizzarla per creare e aggiornare i cataloghi di macchine tra più zone di disponibilità e regioni legate a diverse unità di hosting. Ciò riduce significativamente il sovraccarico di gestione delle immagini, garantisce la coerenza tra le distribuzioni e semplifica il processo di provisioning. È inoltre possibile aggiornare senza problemi i cataloghi di macchine esistenti con immagini preparate da una zona di disponibilità o regione diversa.

Casi d’uso

• Gestione centralizzata delle immagini: Si crea un’immagine preparata in una zona di disponibilità (ad esempio, us-east-1a). È quindi possibile condividere questa immagine con altre zone di disponibilità come us-east-1b all’interno della stessa regione AWS us-east-1 o us-west-1a in una regione us-west-1 diversa. Ciò consente a una singola immagine di servire più unità di hosting e semplifica la manutenzione.
• Creazione e aggiornamento efficienti dei cataloghi: È possibile utilizzare un’immagine preparata creata in AZ 1 (ad esempio, us-east-1a) per creare nuovi cataloghi in AZ 1. Dopo aver condiviso questa immagine con AZ 2 (ad esempio, us-east-1b), è quindi possibile utilizzare l’immagine condivisa in AZ 2 per creare e aggiornare i cataloghi in AZ 2.
• Distribuzioni tra unità di hosting e connessioni di hosting: Se l’ambiente dispone di più unità di hosting nella stessa o in diverse regioni e account AWS, è possibile condividere in modo efficiente le immagini preparate tra queste unità di hosting.

Limitazioni

• Condivisione all’interno dello stesso account AWS: Non è possibile condividere tra diversi account AWS nell’implementazione attuale.

Considerazioni importanti

• Ordine di eliminazione: Per eliminare una specifica della versione dell’immagine preparata originale, è necessario eliminare prima tutte le specifiche della versione dell’immagine condivisa. In alternativa, è necessario eliminare contemporaneamente le specifiche originali e quelle condivise.
• Dipendenza dalla versione dell’immagine: Quando si rimuove una versione dell’immagine, è necessario rimuovere prima tutte le configurazioni di condivisione che dipendono da quella specifica versione dell’immagine. I cataloghi creati dall’immagine originale (non condivisa) possono rimanere intatti.
• Retrocompatibilità del catalogo: È possibile aggiornare i cataloghi di macchine esistenti distribuiti prima dell’introduzione di questa funzionalità. Utilizzare immagini preparate create in una zona di disponibilità o regione diversa da quella in cui è stato originariamente distribuito il catalogo.
• Eliminazione completa: Quando si elimina un’immagine preparata, non è più possibile utilizzarla in nessuna zona di disponibilità in cui è stata condivisa o originariamente creata. Inoltre, una versione dell’immagine preparata non può essere eliminata finché non vengono eliminati prima tutti i cataloghi collegati alla versione dell’immagine preparata.

Prerequisiti

Prima di configurare o utilizzare questa funzionalità, assicurarsi di soddisfare le seguenti condizioni:

• L’ambiente deve essere un ambiente di istanze gestite di Amazon WorkSpaces Core.
• È necessario configurare più unità di hosting (ognuna può essere collegata a diverse zone di disponibilità) e connessioni host (ognuna può essere collegata a una regione diversa) sotto lo stesso account AWS.

Configurare utilizzando l’interfaccia utente di Web Studio

È possibile condividere immagini preparate tra zone di disponibilità collegate a diverse unità di hosting utilizzando l’interfaccia utente di Web Studio.

Per condividere un’immagine preparata

1. Accedere al nodo Immagini di Web Studio e selezionare la versione dell’immagine preparata che si desidera condividere con altre zone di disponibilità.
2. Selezionare Gestisci condivisione immagine nella barra di navigazione superiore per gestire la condivisione dell’immagine per la versione dell’immagine selezionata.
3. Nella pagina Gestisci condivisione immagine, selezionare una o più risorse con cui si desidera condividere la versione dell’immagine. Le risorse possono trovarsi in zone di disponibilità diverse da quelle della versione originale dell’immagine.
4. Fare clic su Salva per condividere la versione dell’immagine nelle risorse tra le altre zone di disponibilità. La versione dell’immagine viene aggiornata in modo da essere condivisa tra le diverse risorse selezionate. Una volta completato, utilizzare la versione dell’immagine per creare cataloghi nelle zone di disponibilità in cui la versione dell’immagine è condivisa.

Per rimuovere la condivisione di un’immagine preparata

1. Nel nodo Immagini di Web Studio, selezionare la versione dell’immagine preparata che si desidera rimuovere dalla condivisione.
2. Selezionare Gestisci condivisione immagine nella barra di navigazione superiore per gestire la condivisione dell’immagine per la versione dell’immagine selezionata.

3. Deselezionare le caselle di controllo da una o più risorse (zone di disponibilità) con cui si desidera interrompere la condivisione della versione dell’immagine.

   Nota:

   Le risorse non devono più avere cataloghi associati e creati dalla versione dell’immagine condivisa. Eventuali cataloghi creati dalla versione dell’immagine condivisa da rimuovere devono essere eliminati per primi.

4. Fare clic su Salva per rimuovere la condivisione delle risorse tra le zone di disponibilità cancellate. La versione dell’immagine viene aggiornata in modo che non sia più condivisa in tali zone di disponibilità.

Configurare tramite PowerShell

In alternativa, è possibile condividere immagini preparate tra zone di disponibilità collegate a diverse unità di hosting utilizzando i comandi PowerShell.

Per condividere un’immagine preparata

1. Assicurarsi di disporre del ImageVersionSpecUid dell’immagine preparata che si desidera condividere. È possibile recuperarlo utilizzando Get-ProvImageVersionSpec o comandi Get- simili in PowerShell.
2. Determinare il HostingUnitName della zona di disponibilità (può essere la stessa regione o una regione diversa) in cui si desidera rendere disponibile l’immagine preparata. Questo è il nome dell’unità di hosting configurata per quella specifica AZ.

3. Eseguire il comando Add-ProvImageVersionSpecHostingUnit: Utilizzare il seguente comando PowerShell. Sostituire <ImageVersionSpecUid> con l’Uid dell’immagine e <targetHostingUnitName> con il nome dell’unità di hosting nella zona di disponibilità di destinazione con cui si desidera condividere la specifica della versione dell’immagine:

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

4. Dopo l’esecuzione riuscita, è possibile visualizzare lo stato dell’immagine nell’interfaccia utente di Web Studio, che indica che è stata condivisa con l’unità di hosting specificata.

Per rimuovere la condivisione di un’immagine preparata

1. Assicurarsi di disporre del ImageVersionSpecUid dell’immagine preparata da cui si desidera rimuovere la condivisione.
2. Determinare il HostingUnitName della zona di disponibilità da cui si desidera rimuovere l’immagine condivisa.

3. Eseguire il comando Remove-ProvImageVersionSpecHostingUnit: Utilizzare il seguente comando PowerShell. Sostituire <ImageVersionSpecUid> con l’Uid dell’immagine e <targetHostingUnitName> con il nome dell’unità di hosting nella zona di disponibilità di destinazione da cui si desidera rimuovere la condivisione della specifica della versione dell’immagine:

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

Dove andare dopo

• Per creare un catalogo di istanze gestite di Amazon WorkSpaces Core, vedere Creare un catalogo di istanze gestite di Amazon WorkSpaces Core

Ulteriori informazioni

• Gestione delle immagini
• Per esempi di PowerShell di GitHub di Amazon WorkSpaces Core, vedere citrix-mcs-sdk-samples-Amazon WorkSpaces Core