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à. # Configura RES-Ready AMIs Con le Amazon Machine Images (AMI) pronte per RESS, puoi preinstallare le dipendenze RES per le istanze di desktop virtuali (VDI) sulle tue AMI personalizzate. L'uso di AMI pronte per RESS migliora i tempi di avvio delle istanze VDI utilizzando le immagini predefinite. Utilizzando EC2 Image Builder, puoi creare e AMIs registrare i tuoi stack software come nuovi. Per ulteriori informazioni su Image Builder, vedere la Guida per l'utente di [Image Builder](https://docs.aws.amazon.com/imagebuilder/latest/userguide/what-is-image-builder.html). Prima di iniziare, è necessario [distribuire la versione più recente di RES](update-the-product.md). **Importante** I sistemi RES-Ready AMIs creati prima di RES 2025.06.01 sono incompatibili con RES 2025.06.01 e tutte le versioni successive. Quando si aggiorna l'ambiente RES da una versione precedente alla 2025.06.01 alla versione più recente, è necessario ricostruire tutto pronto per RES-Ready. AMIs **Topics** + [Prepara un ruolo IAM per accedere all'ambiente RES](#prepare-role) + [Crea il componente EC2 Image Builder](#image-builder-component) + [Prepara la tua ricetta per EC2 Image Builder](#prepare-recipe) + [Configurazione dell'infrastruttura EC2 Image Builder](#configure-ib-infrastructure) + [Configurazione della pipeline di immagini di Image Builder](#image-builder-pipeline) + [Esegui la pipeline di immagini di Image Builder](#run-image-pipeline) + [Registra un nuovo stack software in RES](#register-res-ready-stack) ## Prepara un ruolo IAM per accedere all'ambiente RES Per accedere al servizio di ambiente RES da EC2 Image Builder, è necessario creare o modificare un ruolo IAM chiamato RES-. EC2 InstanceProfileForImageBuilder Per informazioni sulla configurazione di un ruolo IAM da utilizzare in Image Builder, [AWS Identity and Access Management consulta (IAM](https://docs.aws.amazon.com/imagebuilder/latest/userguide/image-builder-setting-up.html#image-builder-IAM-prereq)) nella Guida per l'utente di *Image Builder*. **Il tuo ruolo richiede:** + Relazioni affidabili che includono il servizio Amazon EC2. + AmazonS3, ReadOnlyAccess Amazon SSMManaged InstanceCore e le politiche. EC2 InstanceProfileForImageBuilder ## Crea il componente EC2 Image Builder Segui le istruzioni per [creare un componente utilizzando la console Image Builder](https://docs.aws.amazon.com/imagebuilder/latest/userguide/create-component-console.html) nella Guida per l'utente di *Image Builder*. **Inserisci i dettagli del componente:** 1. Per **Tipo**, scegli **Costruisci**. 1. Per il **sistema operativo (OS) Image**, scegli Linux o Windows. 1. Per **Nome componente**, inserisci un nome significativo, ad esempio**research-and-engineering-studio-vdi-**. 1. Inserisci il numero di versione del componente e, facoltativamente, aggiungi una descrizione. ``` key : value ``` 1. Per il **documento di definizione**, inserisci il seguente file di definizione. Se si verificano errori, il file YAML è sensibile allo spazio ed è la causa più probabile. **Importante** Nel file di definizione, sostituitelo **latest** nell'URI di download (`- source: 's3://research-engineering-studio-us-east-1/releases/latest/res-installation-scripts.tar.gz'`) con il numero esatto della versione (ad esempio,**2025.06**) se la versione dell'ambiente RES non è la più recente. ------ #### [ Linux ] ``` # Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved. # # Licensed under the Apache License, Version 2.0 (the "License"). You may not use this file except in compliance # with the License. A copy of the License is located at # # http://www.apache.org/licenses/LICENSE-2.0 # # or in the 'license' file accompanying this file. This file is distributed on an 'AS IS' BASIS, WITHOUT WARRANTIES # OR CONDITIONS OF ANY KIND, express or implied. See the License for the specific language governing permissions # and limitations under the License. name: research-and-engineering-studio-vdi-linux description: An RES EC2 Image Builder component to install required RES software dependencies for Linux VDI. schemaVersion: 1.0 parameters: - GPUFamily: type: string description: GPU family (NONE, NVIDIA, or AMD) default: NONE phases: - name: build steps: - name: PrepareRESBootstrap action: ExecuteBash onFailure: Abort maxAttempts: 3 inputs: commands: - "mkdir -p /root/bootstrap/logs" - "mkdir -p /root/bootstrap/latest" - name: DownloadRESLinuxInstallPackage action: S3Download onFailure: Abort maxAttempts: 3 inputs: - source: "s3://research-engineering-studio-us-east-1/releases/latest/res-installation-scripts.tar.gz" destination: "/root/bootstrap/res-installation-scripts/res-installation-scripts.tar.gz" - name: RunInstallScript action: ExecuteBash onFailure: Abort maxAttempts: 3 inputs: commands: - "cd /root/bootstrap/res-installation-scripts" - "tar -xf res-installation-scripts.tar.gz" - "cd scripts/virtual-desktop-host/linux" - "/bin/bash install.sh -g {{ GPUFamily }}" - name: RebootAfterInstall action: Reboot onFailure: Abort maxAttempts: 3 inputs: delaySeconds: 0 - name: RunInstallPostRebootScript action: ExecuteBash onFailure: Abort maxAttempts: 3 inputs: commands: - "cd /root/bootstrap/res-installation-scripts/scripts/virtual-desktop-host/linux" - 'sed -i ''/^export AWS_DEFAULT_PROFILE="bootstrap_profile"$/d'' install_post_reboot.sh' - "/bin/bash install_post_reboot.sh -g {{ GPUFamily }}" - name: PreventAL2023FromUninstallingCronie action: ExecuteBash onFailure: Abort maxAttempts: 3 inputs: commands: - "rm -f /tmp/imagebuilder_service/crontab_installed" ``` ------ #### [ Windows ] ``` # Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved. # # Licensed under the Apache License, Version 2.0 (the "License"). You may not use this file except in compliance # with the License. A copy of the License is located at # # http://www.apache.org/licenses/LICENSE-2.0 # # or in the 'license' file accompanying this file. This file is distributed on an 'AS IS' BASIS, WITHOUT WARRANTIES # OR CONDITIONS OF ANY KIND, express or implied. See the License for the specific language governing permissions # and limitations under the License. name: research-and-engineering-studio-vdi-windows description: An RES EC2 Image Builder component to install required RES software dependencies for Windows VDI. schemaVersion: 1.0 phases: - name: build steps: - name: CreateRESBootstrapFolder action: CreateFolder onFailure: Abort maxAttempts: 3 inputs: - path: 'C:\Users\Administrator\RES\Bootstrap' overwrite: true - name: DownloadRESWindowsInstallPackage action: S3Download onFailure: Abort maxAttempts: 3 inputs: - source: 's3://research-engineering-studio-us-east-1/releases/latest/res-installation-scripts.tar.gz' destination: '{{ build.CreateRESBootstrapFolder.inputs[0].path }}\res-installation-scripts.tar.gz' - name: RunInstallScript action: ExecutePowerShell onFailure: Abort maxAttempts: 3 inputs: commands: - 'cd {{ build.CreateRESBootstrapFolder.inputs[0].path }}' - 'tar -xf res-installation-scripts.tar.gz' - 'Import-Module .\scripts\virtual-desktop-host\windows\Install.ps1' - 'Install-WindowsEC2Instance -PrebakeAMI' ``` ------ 1. Create eventuali tag opzionali e scegliete **Crea componente**. ## Prepara la tua ricetta per EC2 Image Builder Una ricetta di EC2 Image Builder definisce l'immagine di base da utilizzare come punto di partenza per creare una nuova immagine, insieme al set di componenti che aggiungi per personalizzare l'immagine e verificare che tutto funzioni come previsto. È necessario creare o modificare una ricetta per costruire l'AMI di destinazione con le dipendenze software RES necessarie. Per ulteriori informazioni sulle ricette, consulta [Gestire](https://docs.aws.amazon.com/imagebuilder/latest/userguide/manage-recipes.html) le ricette. RES supporta i seguenti sistemi operativi di immagini: + Amazon Linux 2 (x86 e ARM64) + Amazon Linux 2023 (x86 e ARM64) + RHEL 8 (x86) e 9 (x86) + Rocky Linux 9 (x86) + Ubuntu 22.04.3 (x86) + Ubuntu 24.04.3 (x86) + Windows Server 2019, 2022 (x86) + Windows 10, 11 (x86) **Nota** A partire dalla versione 2026.03, Amazon Linux 2 e RHEL 8 non sono più inclusi come stack software predefiniti. Se necessario, gli stack software personalizzati con questi sistemi operativi possono ancora essere registrati. ------ #### [ Create a new recipe ] 1. Apri la console EC2 Image Builder [https://console.aws.amazon.com/imagebuilder](https://console.aws.amazon.com/imagebuilder) all'indirizzo. 1. In **Risorse salvate**, scegli Ricette di **immagini**. 1. Scegli **Crea ricetta di immagine**. 1. Inserisci un nome univoco e un numero di versione. 1. Seleziona un'immagine di base supportata da RES. 1. In **Configurazione dell'istanza**, installa un agente SSM se non è preinstallato. Inserisci le informazioni in **Dati utente** e qualsiasi altro dato utente necessario. **Nota** Per informazioni su come installare un agente SSM, consulta: [Installazione manuale dell'agente SSM su istanze EC2](https://docs.aws.amazon.com/systems-manager/latest/userguide/sysman-manual-agent-install.html) per Linux. [Installazione e disinstallazione manuale di SSM Agent su istanze EC2](https://docs.aws.amazon.com/systems-manager/latest/userguide/sysman-install-win.html) per Windows Server. 1. Per le ricette basate su Linux, aggiungi il componente di `aws-cli-version-2-linux` compilazione gestito da Amazon alla ricetta. Per le ricette basate su Windows, aggiungi il componente Amazon managed `aws-cli-version-2-windows` build alla ricetta. Gli script di installazione RES utilizzano il AWS CLI per fornire l'accesso VDI ai valori di configurazione per le impostazioni del cluster DynamoDB. 1. Aggiungi il componente EC2 Image Builder creato per il tuo ambiente Linux o Windows. **Importante** È necessario aggiungere questi componenti in ordine con il componente build `aws-cli-version-2-linux` (per Linux) o ` aws-cli-version-2-windows` (per Windows) aggiunto per primo. ![\[Pagina dei componenti che mostra i componenti di compilazione aggiunti\]](http://docs.aws.amazon.com/it_it/res/latest/ug/images/res-ami-build-components.png) 1. (Consigliato) Aggiungi il componente di `simple-boot-test-` test gestito da Amazon per verificare che l'AMI possa essere avviata. Questa è una raccomandazione minima. È possibile selezionare altri componenti di test che soddisfino le proprie esigenze. 1. Completa le sezioni opzionali, se necessario, aggiungi gli altri componenti desiderati e scegli **Crea ricetta**. ------ #### [ Modify a recipe ] Se disponi di una ricetta EC2 Image Builder esistente, puoi utilizzarla aggiungendo i seguenti componenti: 1. Per le ricette basate su Linux, aggiungi il componente di `aws-cli-version-2-linux` compilazione gestito da Amazon alla ricetta. Per le ricette basate su Windows, aggiungi il componente Amazon managed `aws-cli-version-2-windows` build alla ricetta. Gli script di installazione RES utilizzano il AWS CLI per fornire l'accesso VDI ai valori di configurazione per le impostazioni del cluster DynamoDB. 1. Aggiungi il componente EC2 Image Builder creato per il tuo ambiente Linux o Windows. **Importante** È necessario aggiungere questi componenti in ordine con il componente build `aws-cli-version-2-linux` (per Linux) o ` aws-cli-version-2-windows` (per Windows) aggiunto per primo. ![\[Pagina dei componenti che mostra i componenti di compilazione aggiunti\]](http://docs.aws.amazon.com/it_it/res/latest/ug/images/res-ami-build-components.png) 1. Completa le sezioni opzionali, se necessario, aggiungi gli altri componenti desiderati e scegli **Crea ricetta**. ------ ## Configurazione dell'infrastruttura EC2 Image Builder Puoi utilizzare le configurazioni dell'infrastruttura per specificare l'infrastruttura Amazon EC2 utilizzata da Image Builder per creare e testare la tua immagine Image Builder. Per l'utilizzo con RES, puoi scegliere di creare una nuova configurazione dell'infrastruttura o utilizzarne una esistente. + Per creare una nuova configurazione dell'infrastruttura, consulta [Creare una configurazione dell'infrastruttura](https://docs.aws.amazon.com/imagebuilder/latest/userguide/create-infra-config.html). + Per utilizzare una configurazione dell'infrastruttura esistente, [aggiorna una configurazione dell'infrastruttura](https://docs.aws.amazon.com/imagebuilder/latest/userguide/update-infra-config.html). **Per configurare l'infrastruttura Image Builder:** 1. Per il **ruolo IAM**, inserisci il ruolo in cui hai configurato in [Prepara un ruolo IAM per accedere all'ambiente RES](#prepare-role) precedenza. 1. Per **Tipo di istanza**, scegli un tipo con almeno 4 GB di memoria e che supporti l'architettura AMI di base scelta. Vedi i [tipi di istanze di Amazon EC2](https://aws.amazon.com/ec2/instance-types/). 1. Per **VPC, sottorete e gruppi di sicurezza,** è necessario consentire l'accesso a Internet per scaricare i pacchetti software. È inoltre necessario consentire l'accesso alla tabella `cluster-settings` DynamoDB e al bucket cluster Amazon S3 dell'ambiente RES. ## Configurazione della pipeline di immagini di Image Builder La pipeline di immagini di Image Builder assembla l'immagine di base, i componenti per la creazione e il test, la configurazione dell'infrastruttura e le impostazioni di distribuzione. Per configurare una pipeline di immagini per RES-Ready AMIs, è possibile scegliere di creare una nuova pipeline o utilizzarne una esistente. Per ulteriori informazioni, consulta [Creare e aggiornare pipeline di immagini AMI](https://docs.aws.amazon.com/imagebuilder/latest/userguide/ami-image-pipelines.html) nella Guida per l'utente di *Image Builder*. ------ #### [ Create a new Image Builder pipeline ] 1. Aprire la console Image Builder all'indirizzo. [https://console.aws.amazon.com/imagebuilder](https://console.aws.amazon.com/imagebuilder) 1. Dal pannello di navigazione, scegli **Image pipelines**. 1. Scegli **Crea pipeline di immagini**. 1. Specificate i dettagli della pipeline inserendo un nome univoco, una descrizione opzionale, una pianificazione e una frequenza. 1. Per **Scegli la ricetta**, scegli **Usa ricetta esistente** e seleziona la ricetta creata in[Prepara la tua ricetta per EC2 Image Builder](#prepare-recipe). Verifica che i dettagli della ricetta siano corretti. 1. Per **Definisci il processo di creazione dell'immagine**, scegli il flusso di lavoro predefinito o personalizzato a seconda del caso d'uso. Nella maggior parte dei casi, i flussi di lavoro predefiniti sono sufficienti. Per ulteriori informazioni, consulta [Configurare i flussi di lavoro di immagini per la pipeline EC2](https://docs.aws.amazon.com/imagebuilder/latest/userguide/pipeline-workflows.html) Image Builder. 1. Per **Definisci la configurazione dell'infrastruttura**, scegli **Scegli la configurazione dell'infrastruttura esistente e seleziona la configurazione** dell'infrastruttura creata in. [Configurazione dell'infrastruttura EC2 Image Builder](#configure-ib-infrastructure) Verifica che i dettagli dell'infrastruttura siano corretti. 1. Per **Definisci le impostazioni di distribuzione**, scegli **Crea impostazioni di distribuzione utilizzando i valori predefiniti del servizio**. L'immagine di output deve risiedere nello stesso ambiente Regione AWS RES. Utilizzando le impostazioni predefinite del servizio, l'immagine verrà creata nella regione in cui viene utilizzato Image Builder. 1. **Esamina i dettagli della pipeline e scegli Crea pipeline.** ------ #### [ Modify an existing Image Builder pipeline ] 1. Per utilizzare una pipeline esistente, modifica i dettagli in modo da utilizzare la ricetta creata in. [Prepara la tua ricetta per EC2 Image Builder](#prepare-recipe) 1. Scegli **Save changes** (Salva modifiche). ------ ## Esegui la pipeline di immagini di Image Builder Per produrre l'immagine di output configurata, è necessario avviare la pipeline di immagini. Il processo di creazione può richiedere potenzialmente fino a un'ora a seconda del numero di componenti nella ricetta dell'immagine. **Per eseguire la pipeline di immagini:** 1. Da **Image pipelines**, selezionate la pipeline creata in. [Configurazione della pipeline di immagini di Image Builder](#image-builder-pipeline) 1. Da **Azioni**, scegliete **Esegui pipeline**. ## Registra un nuovo stack software in RES 1. Segui le istruzioni [Stack software () AMIs](software-stacks.md) per registrare uno stack di software. 1. Per **AMI ID**, inserisci l'ID AMI dell'immagine di output incorporata[Esegui la pipeline di immagini di Image Builder](#run-image-pipeline).