Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà. # Blocchi app personalizzati Le istanze di streaming del parco istanze elastico utilizzano applicazioni installate su file del disco rigido virtuale (VHD) archiviati all'interno di un bucket Amazon S3 nel tuo account. I blocchi app con creazioni di pacchetti personalizzata offrono la flessibilità di creare il file VHD e caricarlo in un bucket Amazon S3 all'interno dell'account. **Topics** + [Creazione del VHD](create-vhd.md) + [Crea lo script di configurazione per il VHD nelle applicazioni Amazon WorkSpaces](create-setup-script.md) + [Creazione di un blocco app personalizzato](create-app-block.md) + [Aggiornamento del blocco app, del VHD e dello script di configurazione](update-app-block.md) # Creazione del VHD Un VHD è un singolo file che, una volta montato sul sistema operativo, viene trattato come un disco rigido. Il VHD può essere montato come lettera di unità, nel percorso di una cartella o in entrambi i modi. Quando il VHD è montato, è possibile gestirlo come qualsiasi altro disco rigido, ad esempio installando l'applicazione o copiando su di esso i file necessari all'utente. Per creare il blocco app devi creare il file VHD, installarvi le applicazioni e quindi scollegarlo. Una volta scollegato, puoi testare il tuo VHD su un altro PC, un'istanza EC2 o un generatore di immagini WorkSpaces Applications per verificare che le applicazioni funzionino come previsto. Una volta completato, caricalo in un bucket Amazon S3 nel tuo account e crea il blocco app. **Nota** Questa pagina descrive l'utilizzo di un VHD per distribuire l'applicazione; tuttavia, l'istanza di streaming WorkSpaces Applications scaricherà qualsiasi oggetto da Amazon S3. L'oggetto archiviato in Amazon S3 può anche essere un file zip, un programma di installazione dell'applicazione o l'eseguibile dell'applicazione stessa. Puoi utilizzare lo script di configurazione per configurarla correttamente sull'istanza di streaming prima che un utente avvii la propria applicazione. L'istanza di streaming WorkSpaces Applications attende fino a 120 secondi per il completamento del download del file VHD prima dell'esecuzione dello script di configurazione. Se il download del VHD non viene completato entro questo periodo, il download si interrompe e lo script di configurazione non viene eseguito. Consigliamo una dimensione massima di 1,5 GB per il file VHD. Potresti ridurre le dimensioni del file VHD effettuando la compressione. Devi utilizzare lo script di configurazione per decomprimerlo prima del montaggio, poiché il file deve essere scaricato completamente da Amazon S3 prima di poter essere montato e avviare l'applicazione. VHDsMaggiore è il tempo necessario all'avvio dell'applicazione e all'inizio della sessione di streaming. **Per creare un VHD per Microsoft Windows** 1. Da un PC Windows o un'istanza Amazon Elastic Compute Cloud (Amazon EC2) Windows, apri un prompt dei comandi con privilegi amministrativi. 1. Avvia l'utility **diskpart** di Microsoft immettendo il seguente comando: **diskpart** 1. Create il file VHD non formattato e non inizializzato immettendo il seguente comando, dove ** è la dimensione del file VHD, in MB: **create vdisk file=C:\$1path\$1to\$1new\$1file.vhdx maximum=** type=expandable ** 1. Seleziona il VHD appena creato immettendo il seguente comando: **select vdisk file=C:\$1path\$1to\$1new\$1file.vhdx** 1. Collega il VHD appena creato immettendo il seguente comando: **attach vdisk** 1. Inizializza il VHD appena creato immettendo il seguente comando: **convert mbr** 1. Crea la partizione primaria distribuita sull'intero VHD immettendo il seguente comando: **create partition primary** 1. Formatta la partizione appena creata immettendo il seguente comando: **format fs=ntfs quick** 1. Puoi montare il VHD appena creato su una lettera di unità non utilizzata, su un percorso di cartella nel volume root o su entrambi. Per eseguire il montaggio su una lettera di unità, immetti: **assign letter=**** Per eseguire il montaggio su una cartella, immetti: **assign mount=*C:\$1path\$1to\$1empty\$1folder\$1to\$1mount\$1*** **Nota** Per eseguire il montaggio su un percorso di cartella, la cartella deve esistere già e deve essere vuota. 1. È ora possibile installare l'applicazione sul VHD, utilizzando la lettera dell'unità o il percorso di montaggio della cartella scelto nella fase 9. Dopo aver completato l'installazione delle applicazioni sul disco rigido virtuale (VHD), è necessario scollegarle prima di caricarle in sicurezza su un bucket Amazon S3. **Per scollegare un VHD per Microsoft Windows** 1. Avvia l'utility diskpart di Microsoft immettendo il seguente comando: **diskpart** 1. Seleziona il VHD immettendo il seguente comando: **select vdisk file=*C:\$1path\$1to\$1new\$1file.vhdx*** 1. Scollega il VHD immettendo il seguente comando: **detach vdisk** 1. Il VHD è stato ora scollegato e può essere testato su un altro PC Windows, un'istanza Amazon EC2 o WorkSpaces un generatore di immagini Applications. **Creazione di un VHD per Linux** 1. Aprire un terminale: + Per Amazon Linux 2: utilizza l'istanza EC2, WorkSpaces Applications Image Builder o WorkSpaces utilizza Amazon Linux 2 + Per Ubuntu Pro 24.04 LTS: usa l'istanza EC2 o utilizza Ubuntu Pro WorkSpaces 1. Crea il file VHD non formattato e non inizializzato: **dd if=/dev/zero of=** bs=** count=1** 1. Aggiungi un file system al VHD creato immettendo il seguente comando: **sudo mkfs -t ext4 **** **Nota** È possibile che venga visualizzato un messaggio che indica che il file non è un dispositivo speciale a blocchi. Puoi scegliere di procedere comunque. 1. Crea una cartella vuota da utilizzare per il punto di montaggio immettendo il seguente comando: **sudo mkdir */path/to/mount/point*** 1. Monta il VHD appena creato su un percorso del file system eseguendo il comando seguente: **sudo mount -t auto -o loop ** */path/to/mount/point*** 1. È ora possibile installare l'applicazione sul VHD, utilizzando la lettera dell'unità o il percorso di montaggio della cartella scelti nella fase 4. **Nota** Le autorizzazioni predefinite per file e cartelle creati nel VHD possono impedire agli utenti non amministratori di avviare applicazioni o leggere file. Convalida le autorizzazioni e, se necessario, modificale. Dopo aver completato l'installazione delle applicazioni sul disco rigido virtuale (VHD), è necessario scollegarle prima di caricarle in sicurezza su un bucket Amazon S3. **Per scollegare un VHD per Linux** 1. Nella sessione, apri una finestra di terminale e immetti il comando seguente: **sudo umount */path/to/mount/point*** 1. Il VHD è stato ora scollegato e può essere testato su un'altra istanza Amazon Linux 2/Ubuntu Pro 24.04 LTS Amazon EC2, Amazon Linux 2 WorkSpaces Applications image builder o Amazon Linux 2/Ubuntu Personal. WorkSpaces # Crea lo script di configurazione per il VHD nelle applicazioni Amazon WorkSpaces WorkSpaces Applications utilizza uno script di configurazione fornito dall'utente per montare il VHD prima dell'avvio dell'applicazione. Puoi inoltre utilizzare lo script di configurazione per completare altre attività necessarie per il funzionamento dell'applicazione. Ad esempio, è possibile configurare le chiavi di registro, registrarsi DLLs, gestire i prerequisiti o modificare il profilo utente dallo script di installazione. WorkSpaces Applications fornisce esempi di script che è possibile utilizzare per montare il VHD. Per soddisfare le esigenze del VHD e delle applicazioni dovrai modificare questi script. **Nota** Gli script di configurazione non sono necessari per i blocchi di app con pacchetti WorkSpaces Applications. Tuttavia, per personalizzare l'installazione dell'applicazione puoi fornire script post-configurazione facoltativi. Usa i seguenti collegamenti per scaricare gli script di esempio: + [Script bash per Ubuntu Pro 24.04 LTS e Amazon Linux 2](samples/Linux-mount-vhd-script2.zip) + [Script di Microsoft Windows PowerShell](samples/Windows-mount-vhd-script3.zip) **Nota** WorkSpaces Le applicazioni e il sistema operativo Microsoft Windows riservano le lettere di unità da A a E. Non montare VHDs o condividere condivisioni di rete su queste lettere di unità. WorkSpaces Applications scarica lo script di configurazione e il file VHD in una directory sull'istanza di streaming della flotta, quindi esegue lo script di configurazione. Lo script di configurazione viene eseguito sul sistema operativo con diritti di amministratore completi. Lo script di configurazione viene eseguito nel `SYSTEM` contesto su Microsoft Windows e come `root` utente su Amazon Linux 2 o Ubuntu Pro 24.04 LTS. Posizione del file system per il VHD e lo script di configurazione: + Ubuntu Pro 24.04 LTS: `/opt/appstream/AppBlocks/appblock-name/` **`appblock-name` ** Il nome del blocco app a cui corrispondono il VHD e lo script di configurazione. + Amazon Linux 2: `/opt/appstream/AppBlocks/appblock-name/` **`appblock-name` ** Il nome del blocco app a cui corrispondono il VHD e lo script di configurazione. + Microsoft Windows: `C:\AppStream\AppBlocks\appblock-name\` **`appblock-name` ** Il nome del blocco app a cui corrispondono il VHD e lo script di configurazione. WorkSpaces Le applicazioni mantengono il nome del file così come si trovano sull'oggetto. Ad esempio, se il blocco app ha il nome `MyApps`, con un file VHD denominato `apps.vhd` e uno script di configurazione denominato `mount-apps.ps1`, il percorso completo di un'istanza di streaming di Windows è: + VHD `C:\AppStream\AppBlocks\MyApps\apps.vhd` + Script di configurazione `C:\AppStream\AppBlocks\MyApps\mount-apps.ps1` WorkSpaces Applications acquisisce l'errore standard e l'output standard dallo script di configurazione quando viene eseguito su un'istanza di streaming della flotta e carica l'output in un bucket Amazon S3 all'interno del tuo account. Puoi utilizzare questi log per identificare e risolvere eventuali problemi relativi allo script di configurazione. I bucket vengono denominati in un formato specifico come segue: ``` appstream-logs-region-code-account-id-without-hyphens-random-identifier ``` **`region-code` ** Questo è il codice AWS regionale in cui viene creata la flotta elastica. **`account-id-without-hyphens` ** L'identificativo AWS del tuo account. L'ID casuale garantisce che non vi sia alcun conflitto con altri bucket in quella regione. La prima parte del nome del bucket, appstream-logs, resta uguale in tutti gli account o le regioni. Ad esempio, se crei una flotta elastica nella regione Stati Uniti occidentali (Oregon) (us-west-2) con il numero di account 123456789012 WorkSpaces , Applications crea un bucket Amazon S3 all'interno del tuo account in quella regione con il nome mostrato. Solo un amministratore con autorizzazioni sufficienti può eliminare il bucket. ``` appstream-logs-us-west-2-1234567890123-abcdefg ``` Il percorso per la cartella in cui i file di log vengono memorizzati nel bucket S3 nel tuo account utilizza la seguente struttura: ``` bucket-name/fleet-name/instance-id/appblock-name/ ``` **`bucket-name` ** Il nome del bucket AmazonS3 in cui sono archiviati i log degli script configurazione. Il formato del nome è descritto precedentemente in questa sezione. **`Instance-id` ** Identificatore univoco per l'istanza di streaming su cui è stato eseguito lo script di configurazione **`appblock-name` ** Il nome del blocco app a cui corrisponde lo script di configurazione. L'esempio seguente di struttura della cartella si applica a una sessione di streaming avviata da `test-fleet`. La sessione proviene da un Account AWS ID 123456789012 e il nome dell'appblock è testappblock nella regione degli Stati Uniti occidentali (Oregon) (us-west-2): `appstream-logs-us-west-2-1234567890123-abcdefg/test-fleet/i-084427ab4a1cff7f5/testappblock/` Questa struttura di cartelle di esempio contiene un file di log per l'output standard e un file di log per l'errore standard. **Topics** + [Esecuzione dello script di configurazione dei blocchi di app in Amazon WorkSpaces Applications](script-execution.md) # Esecuzione dello script di configurazione dei blocchi di app in Amazon WorkSpaces Applications I seguenti diagrammi indicano in quale fase del processo viene eseguito lo script di configurazione. L'ordine di esecuzione dipende dal fatto se la persistenza delle impostazioni dell'applicazione è abilitata nello stack associato al parco istanze elastico. **Nota** WorkSpaces Applications utilizza i dettagli del tuo VPC per scaricare il disco rigido virtuale e lo script di configurazione dal bucket Amazon S3. Il VPC deve fornire l'accesso al bucket Amazon S3. Per ulteriori informazioni, consulta [Utilizzo degli endpoint VPC di Amazon S3 per le caratteristiche delle applicazioni WorkSpaces](managing-network-vpce-iam-policy.md). Persistenza delle impostazioni dell'applicazione abilitata: ![\[Persistenza delle impostazioni dell'applicazione abilitata.\]](http://docs.aws.amazon.com/it_it/appstream2/latest/developerguide/images/app-settings-enabled.png) Persistenza delle impostazioni dell'applicazione disabilitata: ![\[Persistenza delle impostazioni dell'applicazione disabilitata.\]](http://docs.aws.amazon.com/it_it/appstream2/latest/developerguide/images/app-settings-disabled.png) # Creazione di un blocco app personalizzato Puoi utilizzare la console WorkSpaces Applicazioni per creare la risorsa di blocco dell'app dopo aver creato e caricato il file VHD e lo script di configurazione in un bucket S3 del tuo. Account AWS Per ulteriori informazioni sull'archiviazione del VHD e dello script di configurazione in un bucket Amazon S3, consulta [Archivia l'icona dell'applicazione, lo script di configurazione, lo script di sessione e il file VHD in un bucket S3](store-s3-bucket.md). **Nota** Per creare la risorsa di blocco app, devi disporre delle autorizzazioni IAM per eseguire l'operazione `S3:GetObject` sul VHD e configurare gli oggetti script nel bucket Amazon S3. **Per creare una risorsa di blocco app** 1. [Apri la console delle WorkSpaces applicazioni in /appstream2. https://console.aws.amazon.com](https://console.aws.amazon.com/appstream2) 1. Dal menu di navigazione a sinistra, scegli **Applicazioni**, **Blocco app ** e **Crea blocco app**. 1. Per la creazione di pacchetti di blocchi app, seleziona **Personalizzato**. 1. Per i **Dettagli blocco app**, digita un identificatore di nome univoco per il blocco app. È anche possibile specificare: + **Nome visualizzato**: un nome descrittivo per il blocco app. + **Descrizione**: una descrizione per il blocco app. 1. Per **Oggetto VHD in S3**, in **Impostazioni script**, inserisci l'URI S3 che rappresenta l'oggetto VHD o scegli **Sfoglia S3** per accedere ai bucket S3 e trovare l'oggetto VHD. 1. Per **Oggetto script di configurazione in S3**, in **Impostazioni script**, inserisci l'URI di Amazon S3 che rappresenta l'oggetto script di configurazione oppure scegli **Sfoglia S3** per accedere ai bucket Amazon S3 e trovare l'oggetto script di configurazione. 1. Per **Eseguibile dello lo script di configurazione** in **Impostazioni script**, inserisci l'eseguibile necessario per lo script di configurazione. **Nota** Se lo script di configurazione può essere eseguito direttamente, inserisci il nome del file dello script di configurazione. Se lo script di installazione si basa sull'esecuzione di un altro file eseguibile (ad esempio Microsoft PowerShell), immettete il percorso di tale eseguibile. Percorso verso Microsoft PowerShell su Microsoft Windows: `C:\Windows\System32\WindowsPowerShell\v1.0\powershell.exe` 1. Facoltativamente, per **Argomenti eseguibile script di configurazione** in **Impostazioni script**, immetti gli argomenti che devono essere forniti all'eseguibile dello script di configurazione per l'esecuzione. **Nota** Se si utilizza uno PowerShell script Microsoft, è necessario specificare il parametro «-File» con il nome dello script di installazione come argomento eseguibile. Inoltre, assicurati che la policy di esecuzione consenta l'esecuzione dello script. [Per ulteriori informazioni, vedere [about\$1Execution\$1Policies](https://docs.microsoft.com/en-us/powershell/module/microsoft.powershell.core/about/about_execution_policies?view=powershell-7.2) e What is? PowerShell](https://docs.microsoft.com/en-us/powershell/scripting/overview?view=powershell-7.2) . 1. Per **Durata dell'esecuzione in secondi** in **Impostazioni dello script**, inserisci la durata del timeout per lo script di configurazione. **Nota** La durata dell'esecuzione in secondi indica il tempo di attesa da parte WorkSpaces delle applicazioni per l'esecuzione dello script di installazione prima di continuare. Se lo script di configurazione non viene completato entro questo periodo, l'utente visualizza un errore e l'applicazione tenterà di avviarsi. Lo script di configurazione viene terminato una volta trascorsa la durata dell'esecuzione. 1. (Facoltativo) Per **Tag**, crea i tag per la risorsa di blocco app 1. Esamina le informazioni, quindi scegli **Crea**. 1. Se il blocco app è stato creato correttamente, nella parte superiore della console viene visualizzato un messaggio di operazione riuscita. Se si è verificato un errore, viene visualizzato un messaggio di errore descrittivo e dovrai provare a creare nuovamente il blocco app. # Aggiornamento del blocco app, del VHD e dello script di configurazione Le risorse blocco app sono immutabili e, una volta create, non possono essere modificate. Se è necessario effettuare aggiornamenti compatibili con le versioni precedenti al VHD o allo script di configurazione, consigliamo di caricare una nuova versione del file nel bucket Amazon S3, sovrascrivendo la versione corrente. Le nuove sessioni di streaming del parco istanze elastico scaricheranno la versione più recente degli oggetti e li utilizzeranno. Se devi effettuare aggiornamenti compatibili con le versioni precedenti al VHD o allo script di configurazione, consigliamo di caricarli come nuovi oggetti nel bucket Amazon S3 e creare un nuovo blocco app e una nuova risorsa dell'applicazione. Puoi quindi gestire l'implementazione agli utenti come parte di una finestra di modifica o di altre interruzioni.