Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés. # Configurar RES-Ready AMIs Con Amazon Machine Images (AMI) preparadas para RES, puede preinstalar dependencias de RES para instancias de escritorios virtuales (VDI) en sus AMI personalizadas. El uso de AMI preparadas para RES mejora los tiempos de arranque de las instancias de VDI mediante las imágenes preconfiguradas. Con EC2 Image Builder, puede crear y registrar AMIs sus nuevas pilas de software. Para obtener más información sobre Image Builder, consulte la [Guía del usuario de Image Builder](https://docs.aws.amazon.com/imagebuilder/latest/userguide/what-is-image-builder.html). Antes de empezar, debe [implementar la última versión de RES](update-the-product.md). **importante** Las versiones Ready AMIs creadas antes de la RES 2025.06.01 son incompatibles con la RES 2025.06.01 y todas las versiones posteriores. Al actualizar su entorno RES de una versión anterior a la 2025.06.01 a la más reciente, debe volver a compilar todo lo que esté preparado para RES. AMIs **Topics** + [Prepare un rol de IAM para acceder al entorno RES](#prepare-role) + [Crear el componente Image Builder de EC2](#image-builder-component) + [Prepare su receta de EC2 Image Builder](#prepare-recipe) + [Configuración de la infraestructura de EC2 Image Builder](#configure-ib-infrastructure) + [Configurar la canalización de imágenes de Image Builder](#image-builder-pipeline) + [Ejecute la canalización de imágenes de Image Builder](#run-image-pipeline) + [Registre una nueva pila de software en RES](#register-res-ready-stack) ## Prepare un rol de IAM para acceder al entorno RES Para acceder al servicio de entorno RES desde EC2 Image Builder, debe crear o modificar un rol de IAM denominado RES-. EC2 InstanceProfileForImageBuilder Para obtener información sobre la configuración de un rol de IAM para su uso en Image Builder, consulte [AWS Identity and Access Management (IAM)](https://docs.aws.amazon.com/imagebuilder/latest/userguide/image-builder-setting-up.html#image-builder-IAM-prereq) en la Guía del *usuario de Image Builder*. **Su función requiere:** + Relaciones de confianza que incluyen el servicio Amazon EC2. + Amazon S3ReadOnlyAccess, Amazon SSMManaged InstanceCore y sus EC2 InstanceProfileForImageBuilder políticas. ## Crear el componente Image Builder de EC2 Siga las instrucciones para [crear un componente mediante la consola de Image Builder](https://docs.aws.amazon.com/imagebuilder/latest/userguide/create-component-console.html) de la *Guía del usuario de Image Builder*. **Introduzca los detalles del componente:** 1. En **Tipo**, elija **Construir**. 1. En el caso **del sistema operativo (SO) Image**, elija Linux o Windows. 1. En **Nombre del componente**, introduzca un nombre descriptivo, como**research-and-engineering-studio-vdi-**. 1. Introduzca el número de versión del componente y, si lo desea, añada una descripción. ``` key : value ``` 1. Para el **documento de definición**, introduzca el siguiente archivo de definición. Si encuentra algún error, el archivo YAML es sensible al espacio y es la causa más probable. **importante** En el archivo de definición, sustituya **latest** el URI de descarga (`- source: 's3://research-engineering-studio-us-east-1/releases/latest/res-installation-scripts.tar.gz'`) por el número de versión exacto (por ejemplo,**2025.06**) si la versión del entorno RES no es la más reciente. ------ #### [ 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. Cree cualquier etiqueta opcional y elija **Crear componente**. ## Prepare su receta de EC2 Image Builder Una receta de Generador de Imágenes de EC2 define la imagen base que se utilizará como punto de partida para crear una nueva imagen, junto con el conjunto de componentes que añade para personalizar la imagen y comprobar que todo funciona según lo previsto. Debe crear o modificar una receta para construir la AMI de destino con las dependencias de software RES necesarias. Para obtener más información sobre las recetas, consulte [Administrar recetas.](https://docs.aws.amazon.com/imagebuilder/latest/userguide/manage-recipes.html) RES es compatible con los siguientes sistemas operativos de imagen: + Amazon Linux 2 (x86 y ARM64) + Amazon Linux 2023 (x86 y ARM64) + RHEL 8 (x86) y 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 partir de la versión 2026.03, Amazon Linux 2 y RHEL 8 ya no se incluyen como paquetes de software predeterminados. Si es necesario, se pueden seguir registrando paquetes de software personalizados con estos sistemas operativos. ------ #### [ Create a new recipe ] 1. Abra la consola [https://console.aws.amazon.com/imagebuilder](https://console.aws.amazon.com/imagebuilder) EC2 Image Builder en. 1. En **Recursos guardados**, elija **Recetas de imágenes.** 1. Seleccione **Crear receta de imagen**. 1. Introduce un nombre único y un número de versión. 1. Seleccione una imagen base compatible con RES. 1. En **Configuración de instancias**, instale un agente SSM si no viene preinstalado. Introduzca la información en **Datos de usuario** y cualquier otro dato de usuario necesario. **nota** Para obtener información sobre cómo instalar un agente de SSM, consulte: [Instalación manual del agente SSM en instancias EC2](https://docs.aws.amazon.com/systems-manager/latest/userguide/sysman-manual-agent-install.html) para Linux. [Instalación y desinstalación manual del agente SSM en las instancias EC2](https://docs.aws.amazon.com/systems-manager/latest/userguide/sysman-install-win.html) para Windows Server. 1. Para recetas basadas en Linux, añada el componente de `aws-cli-version-2-linux` compilación gestionado por Amazon a la receta. Para recetas basadas en Windows, añada el componente de `aws-cli-version-2-windows` compilación gestionado por Amazon a la receta. Los scripts de instalación de RES lo utilizan AWS CLI para proporcionar acceso de VDI a los valores de configuración de los ajustes del clúster de DynamoDB. 1. Añada el componente EC2 Image Builder creado para su entorno Linux o Windows. **importante** Debe agregar estos componentes en orden y agregar primero el componente de compilación `aws-cli-version-2-linux` ` aws-cli-version-2-windows` (para Linux) o (para Windows). ![\[Página de componentes que muestra los componentes de compilación agregados\]](http://docs.aws.amazon.com/es_es/res/latest/ug/images/res-ami-build-components.png) 1. (Recomendado) Añada el componente de `simple-boot-test-` prueba gestionado por Amazon para comprobar que se puede lanzar la AMI. Se trata de una recomendación mínima. Puede seleccionar otros componentes de prueba que cumplan con sus requisitos. 1. Complete las secciones opcionales si es necesario, añada cualquier otro componente que desee y elija **Crear receta**. ------ #### [ Modify a recipe ] Si ya tiene una receta de EC2 Image Builder, puede utilizarla añadiendo los siguientes componentes: 1. Para recetas basadas en Linux, añada el componente de `aws-cli-version-2-linux` compilación gestionado por Amazon a la receta. Para recetas basadas en Windows, añada el componente de `aws-cli-version-2-windows` compilación gestionado por Amazon a la receta. Los scripts de instalación de RES lo utilizan AWS CLI para proporcionar acceso de VDI a los valores de configuración de los ajustes del clúster de DynamoDB. 1. Añada el componente EC2 Image Builder creado para su entorno Linux o Windows. **importante** Debe agregar estos componentes en orden y agregar primero el componente de compilación `aws-cli-version-2-linux` ` aws-cli-version-2-windows` (para Linux) o (para Windows). ![\[Página de componentes que muestra los componentes de compilación agregados\]](http://docs.aws.amazon.com/es_es/res/latest/ug/images/res-ami-build-components.png) 1. Complete las secciones opcionales si es necesario, añada cualquier otro componente que desee y elija **Crear receta**. ------ ## Configuración de la infraestructura de EC2 Image Builder Puede utilizar las configuraciones de infraestructura para especificar la infraestructura de Amazon EC2 que Image Builder utiliza para crear y probar su imagen de Image Builder. Para usarla con RES, puede elegir entre crear una nueva configuración de infraestructura o usar una existente. + Para crear una nueva configuración de infraestructura, consulte [Crear una configuración de infraestructura](https://docs.aws.amazon.com/imagebuilder/latest/userguide/create-infra-config.html). + Para usar una configuración de infraestructura existente, [actualice una configuración de infraestructura](https://docs.aws.amazon.com/imagebuilder/latest/userguide/update-infra-config.html). **Para configurar la infraestructura de Image Builder:** 1. Para el **rol de IAM**, introduzca el rol que configuró anteriormente. [Prepare un rol de IAM para acceder al entorno RES](#prepare-role) 1. Para el **tipo de instancia**, elija un tipo con al menos 4 GB de memoria y que sea compatible con la arquitectura AMI base que haya elegido. Consulte los [tipos de instancias de Amazon EC2](https://aws.amazon.com/ec2/instance-types/). 1. En el **caso de los grupos de VPC, subredes y seguridad**, debe permitir el acceso a Internet para descargar paquetes de software. También se debe permitir el acceso a la tabla de `cluster-settings` DynamoDB y al bucket de clústeres de Amazon S3 del entorno RES. ## Configurar la canalización de imágenes de Image Builder La canalización de imágenes de Image Builder ensambla la imagen base, los componentes para la creación y las pruebas, la configuración de la infraestructura y los ajustes de distribución. Para configurar una canalización de imágenes para RES-Ready AMIs, puede optar por crear una canalización nueva o utilizar una existente. Para obtener más información, consulte [Creación y actualización de canalizaciones de imágenes AMI](https://docs.aws.amazon.com/imagebuilder/latest/userguide/ami-image-pipelines.html) en la *Guía del usuario de Image Builder*. ------ #### [ Create a new Image Builder pipeline ] 1. Abra la consola de Image Builder en[https://console.aws.amazon.com/imagebuilder](https://console.aws.amazon.com/imagebuilder). 1. En el panel de navegación, elija **Image Pipelines.** 1. Seleccione **Crear canalización de imágenes**. 1. Especifica los detalles de tu canalización introduciendo un nombre único, una descripción opcional, un cronograma y una frecuencia. 1. En **Elegir receta**, elija **Usar receta existente** y seleccione la receta creada en[Prepare su receta de EC2 Image Builder](#prepare-recipe). Comprueba que los detalles de la receta sean correctos. 1. En **Definir el proceso de creación de imágenes**, elija el flujo de trabajo predeterminado o personalizado según el caso de uso. En la mayoría de los casos, los flujos de trabajo predeterminados son suficientes. Para obtener más información, consulte [Configurar flujos de trabajo de imágenes para la canalización de EC2 Image Builder](https://docs.aws.amazon.com/imagebuilder/latest/userguide/pipeline-workflows.html). 1. En **Definir la configuración de la infraestructura**, **elija Elegir la configuración de infraestructura existente** y seleccione la configuración de infraestructura creada en[Configuración de la infraestructura de EC2 Image Builder](#configure-ib-infrastructure). Compruebe que los detalles de su infraestructura sean correctos. 1. En **Definir la configuración de distribución**, elija **Crear la configuración de distribución mediante los valores predeterminados del servicio**. La imagen de salida debe residir en el mismo lugar Región de AWS que su entorno RES. Si se utilizan los valores predeterminados del servicio, la imagen se creará en la región en la que se utilice Image Builder. 1. Revisa los detalles de la canalización y selecciona **Crear canalización**. ------ #### [ Modify an existing Image Builder pipeline ] 1. Para usar una canalización existente, modifique los detalles para usar la receta creada en[Prepare su receta de EC2 Image Builder](#prepare-recipe). 1. Seleccione **Save changes (Guardar cambios)**. ------ ## Ejecute la canalización de imágenes de Image Builder Para producir la imagen de salida configurada, debe iniciar la canalización de imágenes. El proceso de creación puede tardar hasta una hora en función del número de componentes de la receta de la imagen. **Para ejecutar la canalización de imágenes:** 1. En **las canalizaciones de imágenes**, seleccione la canalización creada en[Configurar la canalización de imágenes de Image Builder](#image-builder-pipeline). 1. En **Acciones**, selecciona **Ejecutar canalización**. ## Registre una nueva pila de software en RES 1. Siga las instrucciones [Pilas de software () AMIs](software-stacks.md) para registrar una pila de software. 1. Para el **ID de AMI**, introduzca el ID de AMI de la imagen de salida integrada[Ejecute la canalización de imágenes de Image Builder](#run-image-pipeline).