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. # Bloques de aplicaciones personalizados Las instancias de streaming de la flota elástica utilizan aplicaciones que se instalan en archivos de disco duro virtual (VHD) almacenados en un bucket de Amazon S3 de su cuenta. Los bloques de aplicaciones con empaquetado personalizado te ofrecen la flexibilidad de crear su propio archivo VHD y cargarlo a un bucket de Amazon S3 de su cuenta. **Topics** + [ # Creación de un VHD ](create-vhd.md) + [ # Cree el script de configuración para el VHD en Amazon Applications WorkSpaces ](create-setup-script.md) + [ # Creación de un bloque de aplicaciones personalizado ](create-app-block.md) + [ # Actualización del bloque de aplicaciones, el VHD y el script de configuración ](update-app-block.md) # Creación de un VHD Un VHD es un archivo único que, cuando se monta en el sistema operativo, se trata como un disco duro. El VHD se puede montar como una letra de unidad, en una ruta de carpeta o de ambas formas. Una vez montado el VHD, puede tratarlo como lo haría con cualquier otro disco duro, lo que incluye instalar la aplicación o copiar en él los archivos que necesite el usuario. Para crear el bloque de aplicaciones, tendrá que crear el VHD, instalar las aplicaciones en él y, a continuación, desconectarlo. Una vez desconectado, puede probar el VHD en otro PC, en una instancia EC2 o en un generador de imágenes de WorkSpaces aplicaciones para comprobar que las aplicaciones funcionan según lo previsto. Una vez completado, cárguelo en un bucket de Amazon S3 de su cuenta y cree el bloque de aplicaciones. **nota** En esta página se describe el uso de un VHD para entregar la aplicación; sin embargo, la instancia de streaming de WorkSpaces Aplicaciones descargará cualquier objeto de Amazon S3. El objeto que almacene en Amazon S3 también puede ser un archivo zip, un instalador de aplicaciones o el propio ejecutable de la aplicación. Puede usar el script de configuración para configurarlo correctamente en la instancia de streaming antes de que el usuario lance su aplicación. La instancia de streaming de WorkSpaces aplicaciones espera hasta 120 segundos a que se complete la descarga del VHD antes de ejecutar el script de configuración. Si el VHD no finaliza la descarga dentro de este período, la descarga se detiene y el script de configuración no se ejecuta. Recomendamos un tamaño máximo de 1,5 gigabytes para el VHD. Es posible que pueda reducir el tamaño del VHD si lo comprime. Debe usar el script de configuración para descomprimirlo antes de montarlo, ya que el archivo debe descargarse por completo de Amazon S3 antes de poder montarlo y lanzar la aplicación. Cuanto VHDs mayor sea el tiempo que tarda la aplicación en iniciarse y en comenzar la sesión de streaming. **Para crear un VHD para Microsoft Windows** 1. Desde un PC Windows o una instancia de Windows Amazon Elastic Compute Cloud (Amazon EC2), abra una línea de comandos con privilegios administrativos. 1. Inicie la utilidad **diskpart** de Microsoft mediante el siguiente comando: **diskpart** 1. Cree el archivo VHD sin formato ni inicializado introduciendo el siguiente comando, donde ** se indica el tamaño del archivo VHD, en MB: **create vdisk file=C:\$1path\$1to\$1new\$1file.vhdx maximum=** type=expandable ** 1. Seleccione el VHD recién creado mediante el siguiente comando: **select vdisk file=C:\$1path\$1to\$1new\$1file.vhdx** 1. Asocie el VHD recién creado mediante el siguiente comando: **attach vdisk** 1. Inicialice el VHD recién creado mediante el siguiente comando: **convert mbr** 1. Cree la partición principal que abarque todo el VHD mediante el siguiente comando: **create partition primary** 1. Formatee la partición recién creada mediante el siguiente comando: **format fs=ntfs quick** 1. Puede montar el VHD recién creado en una letra de unidad no utilizada, en una ruta de carpeta del volumen raíz o en ambas. Para montar en una letra de unidad, ingrese: **assign letter=**** Para montar en una carpeta, ingrese: **assign mount=*C:\$1path\$1to\$1empty\$1folder\$1to\$1mount\$1*** **nota** Para montar en una ruta de carpeta, la carpeta ya debe existir y debe estar vacía. 1. Ahora puede instalar la aplicación en el VHD mediante la letra de unidad o la ruta de montaje de la carpeta elegida en el paso 9. Cuando termine de instalar las aplicaciones en el VHD, tendrá que desconectarlas para poder cargarlas de forma segura en un bucket de Amazon S3. **Para desconectar un VHD para Microsoft Windows** 1. Inicie la utilidad diskpart de Microsoft mediante el siguiente comando: **diskpart** 1. Seleccione el VHD mediante el siguiente comando: **select vdisk file=*C:\$1path\$1to\$1new\$1file.vhdx*** 1. Desconecte el VHD mediante el siguiente comando: **detach vdisk** 1. El VHD ya se ha separado y se puede probar en otro PC con Windows, en una instancia de Amazon EC2 o en WorkSpaces un generador de imágenes de aplicaciones. **Para crear un VHD para Linux** 1. Abra una terminal: + Para Amazon Linux 2: utilice una instancia EC2, un generador de imágenes de WorkSpaces aplicaciones o la WorkSpaces tecnología de Amazon Linux 2 + Para Ubuntu Pro 24.04 LTS: utilice una instancia EC2 o WorkSpaces con la tecnología de Ubuntu Pro 1. Cree el archivo VHD sin formato ni inicializado: **dd if=/dev/zero of=** bs=** count=1** 1. Añada un sistema de archivos al VHD creado mediante el siguiente comando: **sudo mkfs -t ext4 **** **nota** Es posible que aparezca un mensaje en el que se indica que el archivo no es un dispositivo especial de bloques. Puede elegir continuar de todos modos. 1. Cree una carpeta vacía para usarla como punto de montaje mediante el siguiente comando: **sudo mkdir */path/to/mount/point*** 1. Monte el VHD recién creado en una ruta de sistema de archivos ejecutando el siguiente comando: **sudo mount -t auto -o loop ** */path/to/mount/point*** 1. Ahora puede instalar la aplicación en el VHD mediante la ruta de montaje de carpetas elegida en el paso 4. **nota** Los permisos predeterminados para los archivos y carpetas creados en el VHD pueden impedir que los usuarios no administradores ejecuten aplicaciones o lean archivos. Valide los permisos y cámbielos si es necesario. Cuando termine de instalar las aplicaciones en el VHD, tendrá que desconectarlas para poder cargarlas de forma segura en un bucket de Amazon S3. **Para desconectar un VHD para Linux** 1. Abra una sesión de terminal e ingrese el siguiente comando: **sudo umount */path/to/mount/point*** 1. El VHD ya se ha separado y se puede probar en otra instancia Amazon EC2 de Amazon Linux 2/Ubuntu Pro 24.04 LTS, en el generador de imágenes de Amazon Linux 2 Applications o en Amazon Linux WorkSpaces 2/Ubuntu Personal. WorkSpaces # Cree el script de configuración para el VHD en Amazon Applications WorkSpaces WorkSpaces Las aplicaciones utilizan un script de configuración que usted proporciona para montar el VHD antes de que se inicie la aplicación. También puede usar el script de configuración para completar otras tareas necesarias para que la aplicación funcione. Por ejemplo, puede configurar las claves de registro, registrar DLLs, gestionar los requisitos previos o modificar el perfil de usuario desde el script de configuración. WorkSpaces Applications proporciona ejemplos de scripts que puede utilizar para montar su VHD. Deberá modificar estos scripts para adaptarlos a las necesidades de sus aplicaciones y su VHD. **nota** Los scripts de configuración no son necesarios para los bloques de WorkSpaces aplicaciones con el paquete Applications. Sin embargo, puede proporcionar scripts opcionales posteriores a la configuración para personalizar la instalación de la aplicación. Utilice los siguientes enlaces para descargar los scripts de ejemplo: + [Ubuntu Pro 24.04 LTS y script bash de Amazon Linux 2](samples/Linux-mount-vhd-script2.zip) + [Script de Microsoft Windows Powershell](samples/Windows-mount-vhd-script3.zip) **nota** WorkSpaces Las aplicaciones y el sistema operativo Microsoft Windows reservan las letras de unidad A a E. No monte VHDs ni utilice recursos compartidos de red en estas letras de unidad. WorkSpaces Las aplicaciones descargan el script de configuración y el VHD a un directorio de la instancia de streaming de fleet y, a continuación, ejecutan el script de configuración. El script de configuración se ejecuta en el sistema operativo con todos los derechos de administrador. El script de configuración se ejecuta en el `SYSTEM` contexto de Microsoft Windows y como `root` usuario en Amazon Linux 2 o Ubuntu Pro 24.04 LTS. Ubicación del sistema de archivos para el VHD y el script de configuración: + Ubuntu Pro 24.04 LTS: `/opt/appstream/AppBlocks/appblock-name/` **`appblock-name` ** El nombre del bloque de aplicaciones al que corresponden el VHD y el script de configuración. + Amazon Linux 2: `/opt/appstream/AppBlocks/appblock-name/` **`appblock-name` ** El nombre del bloque de aplicaciones al que corresponden el VHD y el script de configuración. + Microsoft Windows: `C:\AppStream\AppBlocks\appblock-name\` **`appblock-name` ** El nombre del bloque de aplicaciones al que corresponden el VHD y el script de configuración. WorkSpaces Las aplicaciones mantienen el nombre del archivo tal como están en el objeto. Por ejemplo, si el bloque de aplicaciones se llama `MyApps`, con un VHD denominado `apps.vhd` y un script de configuración denominado `mount-apps.ps1`, la ruta completa de una instancia de streaming de Windows es: + VHD `C:\AppStream\AppBlocks\MyApps\apps.vhd` + Script de configuración `C:\AppStream\AppBlocks\MyApps\mount-apps.ps1` WorkSpaces Applications captura el error estándar y el resultado estándar del script de configuración cuando se ejecuta en una instancia de streaming de flota y carga el resultado en un bucket de Amazon S3 de su cuenta. Puede usar estos registros para identificar y resolver los problemas que pueda tener con su script de configuración. Los nombres de los buckets siguen el formato específico que se indica a continuación: ``` appstream-logs-region-code-account-id-without-hyphens-random-identifier ``` **`region-code` ** Este es el código de AWS región en el que se crea la flota elástica. **`account-id-without-hyphens` ** El identificador AWS de su cuenta. El ID aleatorio garantiza que no haya ningún conflicto con otros buckets en esa región. La primera parte del nombre del bucket, appstream-logs, no cambia entre cuentas o regiones. Por ejemplo, si crea una flota elástica en la región EE.UU. Oeste (Oregón) (us-west-2) con el número de cuenta 123456789012, WorkSpaces Applications crea un bucket de Amazon S3 en su cuenta en esa región con el nombre que se muestra. Este bucket solo lo puede eliminar un administrador con permisos suficientes. ``` appstream-logs-us-west-2-1234567890123-abcdefg ``` La ruta de la carpeta donde se almacenan los archivos de registro en el bucket de S3 en la cuenta utiliza la siguiente estructura: ``` bucket-name/fleet-name/instance-id/appblock-name/ ``` **`bucket-name` ** El nombre del bucket de Amazon S3 en el que se almacenan los registros del script de sesión. El formato del nombre se describe anteriormente en esta sección. **`Instance-id` ** El identificador único de la instancia de streaming en la que se ejecutó el script de configuración. **`appblock-name` ** El nombre del appblock al que corresponde el script de configuración. La siguiente estructura de carpetas de ejemplo se aplica a una sesión de streaming que se inicia desde `test-fleet`. La sesión tiene un Cuenta de AWS identificador 123456789012 y el nombre de appblock es testappblock en la región EE.UU. Oeste (Oregón) (us-west-2): `appstream-logs-us-west-2-1234567890123-abcdefg/test-fleet/i-084427ab4a1cff7f5/testappblock/` La estructura de carpetas de este ejemplo contiene un archivo de registro para el resultado estándar y un archivo de registro para el error estándar. **Topics** + [ # Ejecución del script de configuración de bloques de aplicaciones en Amazon WorkSpaces Applications ](script-execution.md) # Ejecución del script de configuración de bloques de aplicaciones en Amazon WorkSpaces Applications Los siguientes diagramas indican en qué parte del proceso se ejecuta el script de configuración. El orden de ejecución depende de si está habilitada la persistencia de configuración de la aplicación en la pila asociada a la flota elástica. **nota** WorkSpaces Applications utiliza los detalles de su VPC para descargar el VHD y el script de configuración del bucket de Amazon S3. Su VPC debe proporcionar acceso al bucket de Amazon S3. Para obtener más información, consulte [Uso de puntos de enlace de VPC de Amazon S3 para las características de las aplicaciones WorkSpaces](managing-network-vpce-iam-policy.md). Persistencia de configuración de la aplicación habilitada: ![\[La persistencia de configuración de la aplicación está habilitada.\]](http://docs.aws.amazon.com/es_es/appstream2/latest/developerguide/images/app-settings-enabled.png) Persistencia de configuración de la aplicación deshabilitada: ![\[La persistencia de configuración de la aplicación está deshabilitada.\]](http://docs.aws.amazon.com/es_es/appstream2/latest/developerguide/images/app-settings-disabled.png) # Creación de un bloque de aplicaciones personalizado Puede usar la consola de WorkSpaces aplicaciones para crear el recurso de bloque de aplicaciones una vez que haya creado el VHD y el script de configuración y los haya cargado en un bucket de S3 de su cuenta. Cuenta de AWS Para obtener más información sobre cómo almacenar el VHD y el script de configuración en un bucket de Amazon S3, consulte [Guardar el icono de la aplicación, el script de configuración, el script de sesión y el VHD en un bucket de S3](store-s3-bucket.md). **nota** Debe tener permisos de IAM para realizar la acción `S3:GetObject` en el VHD y configurar los objetos del script en el bucket de Amazon S3 para crear el recurso de bloque de aplicaciones. **Para crear el recurso de bloque de aplicaciones** 1. Abra la consola de WorkSpaces aplicaciones en [https://console.aws.amazon.com/appstream2.](https://console.aws.amazon.com/appstream2) 1. En el menú de navegación de la izquierda, seleccione **Aplicaciones**, **Bloque de aplicaciones** y **Crear bloque de aplicaciones**. 1. Para empaquetar el bloque de aplicaciones, seleccione **Personalizado**. 1. En **Detalles del bloque de aplicaciones**, escriba un identificador de nombre único para el bloque de aplicaciones. Si lo desea, también puede especificar lo siguiente: + **Nombre para mostrar**: un nombre descriptivo para el bloque de aplicaciones. + **Descripción**: una descripción del bloque de aplicaciones. 1. Para **Objeto de disco duro virtual de S3** en **Configuración del script**, ingrese el URI de S3 que representa el objeto de VHD o elija **Explorar S3** para ir a los buckets de S3 y buscar el objeto de VHD. 1. Para **Objeto de script de configuración en S3** en **Configuración del script**, ingrese el URI de S3 que representa el objeto del script de configuración o elija **Explorar S3** para ir a los buckets de S3 y buscar el objeto de script de configuración. 1. Para **Configurar script ejecutable** en **Configuración del script**, introduzca el ejecutable necesario para el script de configuración. **nota** Si el script de configuración se puede ejecutar directamente, ingrese el nombre del archivo del script de configuración. Si el script de configuración depende de otro ejecutable (por ejemplo, Microsoft PowerShell) para ejecutarse, introduzca la ruta a ese ejecutable. Ruta a Microsoft PowerShell en Microsoft Windows: `C:\Windows\System32\WindowsPowerShell\v1.0\powershell.exe` 1. Si lo desea, para **Argumentos ejecutables del script de configuración** en **Configuración del script**, ingrese los argumentos que se deben proporcionar al archivo ejecutable del script de configuración para ejecutar el script de configuración. **nota** Si utiliza un PowerShell script de Microsoft, debe especificar el parámetro «-File» con el nombre del script de configuración como argumento ejecutable. Además, asegúrese de que la política de ejecución permita ejecutar el script. [Para obtener más información, consulte [about\$1Execution\$1Policies](https://docs.microsoft.com/en-us/powershell/module/microsoft.powershell.core/about/about_execution_policies?view=powershell-7.2) y ¿Qué es? PowerShell](https://docs.microsoft.com/en-us/powershell/scripting/overview?view=powershell-7.2) . 1. Para **Duración de la ejecución en segundos** en **Configuración del script**, ingrese la duración del tiempo de espera del script de configuración. **nota** La duración de la ejecución en segundos indica el tiempo que espera WorkSpaces Applications a que se ejecute el script de configuración antes de continuar. Si el script de configuración no se completa dentro de este período, el usuario verá un error y la aplicación intentará iniciarse. El script de configuración finaliza una vez transcurrido el tiempo de ejecución. 1. De forma opcional, para **Etiquetas**, cree etiquetas para el recurso de bloque de aplicaciones. 1. Revise la información que ha ingresado y elija **Crear**. 1. Si el bloque de aplicaciones se creó correctamente, verá un mensaje de éxito en la parte superior de la consola. Si se ha producido un error, verá un mensaje de error descriptivo y tendrá que intentar volver a crear el bloque de aplicaciones. # Actualización del bloque de aplicaciones, el VHD y el script de configuración Los recursos del bloque de aplicaciones son inmutables y no le permiten cambiarlos una vez creados. Si necesita realizar actualizaciones compatibles con versiones anteriores del VHD o del script de configuración, se recomienda que cargue una nueva versión del archivo en el bucket de Amazon S3 y sobrescriba la versión actual. Las nuevas sesiones de streaming de la flota elástica descargarán la versión más reciente de los objetos, y los usarán. Si necesita realizar actualizaciones incompatibles con versiones anteriores del VHD o del script de configuración, se recomienda cargarlas como objetos nuevos en el bucket de Amazon S3 y crear un nuevo bloque de aplicaciones y un nuevo recurso de aplicación. A continuación, podrá administrar la implementación para sus usuarios como parte de una ventana de cambios u otra interrupción.