Cree su imagen AppStream 2.0 mediante programación mediante las operaciones de CLI de Image Assistant

Puede crear imágenes de Amazon AppStream 2.0 conectándose a un generador de imágenes y utilizando las operaciones de la interfaz gráfica de usuario (GUI) o la interfaz de línea de comandos (CLI) de Image Assistant. Las operaciones de la CLI de Image Assistant proporcionan funcionalidad similar a la de la GUI de Image Assistant. Con estas operaciones, puede hacer lo siguiente mediante programación:

• Administrar las aplicaciones incluidas en una imagen.

• Guardar, actualizar y restablecer la configuración predeterminada de las aplicaciones.

• Habilite o deshabilite el marco de aplicaciones dinámicas AppStream 2.0.

• Especificar etiquetas.

• Crear una imagen.

Puede utilizar estas operaciones para integrar la creación de imágenes AppStream 2.0 con su proceso continuo de desarrollo de software de integración o despliegue.

Para trabajar con las operaciones de la CLI de Image Assistant, utilice el shell de línea de comandos de su elección en un constructor de imágenes. Por ejemplo, puede usar la línea de comandos de Windows para PowerShell.

nota

El creador de imágenes debe usar una versión del agente AppStream 2.0 que se publique el 26 de julio de 2019 o después. Si no dispone de un constructor de imágenes, debe crear uno. Para obtener más información, consulte Lanzar un constructor de imágenes para instalar y configurar aplicaciones de streaming.

Creación de la configuración predeterminada de las aplicaciones y de Windows con las operaciones de la CLI de Image Assistant

Puede crear la configuración predeterminada de las aplicaciones y de Windows para que los usuarios puedan comenzar a utilizar sus aplicaciones rápidamente. Al crear estos parámetros, AppStream 2.0 sustituye el perfil de usuario predeterminado de Windows por el perfil que usted configure. El perfil de usuario predeterminado de Windows se utiliza a continuación para crear la configuración inicial para los usuarios en la instancia de la flota. Si crea esta configuración mediante operaciones de la CLI de Image Assistant, el instalador de la aplicación o la automatización deben modificar el perfil de usuario predeterminado de Windows directamente.

Para sobrescribir el perfil de usuario predeterminado de Windows por el de otro usuario de Windows, también puede utilizar la operación update-default-profile de la CLI de Image Assistant.

Para obtener más información sobre cómo configurar la aplicación predeterminada y los ajustes de Windows, consulte Creación de configuraciones predeterminadas de aplicaciones y Windows para sus usuarios de AppStream 2.0 enConfiguración predeterminadas de las aplicaciones y de Windows y rendimiento del lanzamiento de aplicaciones.

Optimización del rendimiento de lanzamiento de las aplicaciones mediante operaciones de la CLI de Image Assistant

AppStream La versión 2.0 le permite optimizar el rendimiento de lanzamiento de sus aplicaciones para las sesiones de streaming de sus usuarios. Si lo hace mediante las operaciones de la CLI de Image Assistant, puede especificar los archivos que se deben optimizar para el lanzamiento de la aplicaciones. Si se agregan los archivos al manifiesto de optimización de la aplicación, se reduce el tiempo que se tarda en lanzar la aplicación por primera vez en una nueva instancia de la flota. Sin embargo, esto también aumenta el tiempo que se tarda en que las instancias de la flota estén disponibles para los usuarios. El manifiesto de optimización es un archivo de texto delimitado por líneas que se crea para cada aplicación.

nota

Si añade manifiestos de optimización de aplicaciones mediante operaciones de la CLI de Image Assistant y la GUI de Image Assistant, ambos manifiestos se combinan.

A continuación, se muestra un ejemplo de un archivo de optimización de aplicaciones:

C:\Program Files (x86)\Notepad++\autoCompletion
C:\Program Files (x86)\Notepad++\localization
C:\Program Files (x86)\Notepad++\plugins
C:\Program Files (x86)\Notepad++\themes
C:\Program Files (x86)\Notepad++\updater
C:\Program Files (x86)\Notepad++\userDefineLangs
C:\Program Files (x86)\Notepad++\change.log
C:\Program Files (x86)\Notepad++\config.xml
C:\Program Files (x86)\Notepad++\contextMenu.xml
C:\Program Files (x86)\Notepad++\doLocalConf.xml
C:\Program Files (x86)\Notepad++\functionList.xml
C:\Program Files (x86)\Notepad++\langs.model.xml
C:\Program Files (x86)\Notepad++\license.txt
C:\Program Files (x86)\Notepad++\notepad++.exe
C:\Program Files (x86)\Notepad++\readme.txt
C:\Program Files (x86)\Notepad++\SciLexer.dll
C:\Program Files (x86)\Notepad++\shortcuts.xml
C:\Program Files (x86)\Notepad++\stylers.model.xml

Para obtener más información sobre cómo optimizar el rendimiento de lanzamiento de las aplicaciones, consulte Optimización del rendimiento de lanzamiento de las aplicaciones en Configuración predeterminadas de las aplicaciones y de Windows y rendimiento del lanzamiento de aplicaciones.

Descripción general del proceso para crear una imagen AppStream 2.0 mediante programación

Puede utilizar las operaciones de la CLI de Image Assistant con la automatización de la instalación de la aplicación para crear un flujo de trabajo de creación de imágenes AppStream 2.0 totalmente programático. Cuando finalice la automatización de la instalación de aplicaciones, pero antes de crear la imagen, utilice las operaciones de la CLI de Image Assistant para especificar lo siguiente:

• Los archivos ejecutables que pueden lanzar los usuarios

• Los manifiestos de optimización de las aplicaciones

• Otros metadatos de imagen AppStream 2.0

La siguiente descripción general describe el proceso de creación de una imagen AppStream 2.0 mediante programación.

1. Utilice la automatización de la instalación de aplicaciones para instalar las aplicaciones necesarias en el constructor de imágenes. Esta instalación puede incluir las aplicaciones que lanzarán los usuarios, las dependencias y las aplicaciones en segundo plano.

2. Determine los archivos y las carpetas que se deben optimizar.

3. Si corresponde, utilice la operaciónadd-application CLI de Image Assistant para especificar los metadatos de la aplicación y el manifiesto de optimización para la imagen AppStream 2.0.

4. Para especificar aplicaciones adicionales para la imagen AppStream 2.0, repita los pasos 1 a 3 para cada aplicación según sea necesario.

5. Si procede, utilice la operación update-default-profile de la CLI de Image Assistant para sobrescribir el perfil predeterminado de Windows y crear la configuración predeterminada de las aplicaciones y de Windows para los usuarios.

6. Utilice la operación create-image de la CLI de Image Assistant para crear la imagen.

Operaciones de CLI de Image Assistant para crear y administrar su imagen AppStream 2.0

En esta sección se describen las operaciones de la CLI de Image Assistant que puede utilizar para crear y administrar su imagen AppStream 2.0.

En los generadores de imágenes de Windows, el archivo ejecutable que incluye la interfaz de línea de comandos se encuentra en: C:\Program Files\ Amazon\ Photon\ConsoleImageBuilder\ Image-Assistant.exe. Para su comodidad, este archivo ejecutable se incluye en la variable PATH de Windows. Esto le permite llamar a las operaciones de la CLI de Image Assistant sin especificar la ruta completa del archivo ejecutable. Para llamar a estas operaciones, escriba el comando image-assistant.exe.

En los generadores de imágenes de Linux, la herramienta de asistente de imágenes se encuentra en /usr/local/appstream/image-assistant/AppStreamImageAssistant, con un enlace simbólico en /bin/AppStreamImageAssistant.

Operación de help

Recupera una lista de todas las operaciones de la CLI de Image Assistant. Para cada operación de la lista, se muestra una descripción y la sintaxis de uso. Para mostrar ayuda para una operación específica, escriba el nombre de la operación y especifique el parámetro -help. Por ejemplo:

add-application --help

Sinopsis

help

Salida

Imprime en la salida estándar la lista de las operaciones disponibles con una descripción de su función.

Operación de add-application

Agrega la aplicación a la lista de aplicaciones para usuarios de AppStream 2.0. Las aplicaciones de esta lista se incluyen en el catálogo de aplicaciones. El catálogo de aplicaciones se muestra a los usuarios cuando inician sesión en una sesión de streaming AppStream 2.0.

nota

Si necesita realizar cambios en la configuración de una aplicación, quítela y agréguela con la configuración actualizada.

Sinopsis

add-application
--name <value>
--absolute-app-path <value>
[--display-name <value>]
[--absolute-icon-path <value>]
[--working-directory <value>]
[--launch-parameters <""-escaped value>]
[--absolute-manifest-path <value>]

Opciones

--name (cadena)

Un nombre único para la aplicación. La longitud máxima es de 256 caracteres. Puede añadir hasta 50 aplicaciones. No puede utilizar caracteres de espacio en blanco.

--absolute-app-path (cadena)

La ruta completa del archivo ejecutable, el archivo de procesamiento por lotes o el script de la aplicación. La ruta debe apuntar a un archivo válido.

--display-name (cadena)

El nombre que se usará para la aplicación en el catálogo de aplicaciones. Si no especifica un nombre para mostrar, AppStream 2.0 crea un nombre que se deriva del nombre del archivo ejecutable. El nombre se crea sin la extensión de archivo y con guiones bajos en lugar de espacios. La longitud máxima es de 256 caracteres.

--absolute-icon-path (cadena)

La ruta completa para el icono de la aplicación. La ruta debe apuntar a un archivo de icono válido de uno de los siguientes tipos: .jpg, .png o .bmp. Las dimensiones máximas son: 256 px x 256 px. Si no especifica una ruta, se utiliza el icono predeterminado del archivo ejecutable, si está disponible. Si el icono predeterminado no está disponible para el archivo ejecutable, se utiliza un icono de aplicación AppStream 2.0 predeterminado.

--working-directory (cadena)

El directorio de trabajo inicial de la aplicación cuando se lanza.

--absolute-manifest-path (cadena)

La ruta de un archivo de texto nuevo delimitado por líneas. El archivo especifica las rutas absolutas de los archivos que se deben optimizar antes de que la instancia de la flota esté disponible para un usuario mediante streaming. La ruta debe apuntar a un archivo de texto válido.

Mensajes de salida

Código de salida	Mensaje que se muestra en la salida estándar	Descripción
0	{"status": 0, "message": "Success"}	La aplicación se añadió correctamente.
1	{"status": 1, "message": "Administrator privileges are required to perform this operation"}	Se necesitan privilegios de administrador para llevar a cabo la operación.
1	{"status": 1, "message": "Unable to add more than 50 apps to the catalog."}	No se pudo agregar la aplicación porque el número máximo de aplicaciones que se pueden agregar al catálogo de aplicaciones AppStream 2.0 es 50.
1	{"status": 1, "message": "Name is not unique"}	Ya existe una aplicación con ese nombre en el catálogo de aplicaciones AppStream 2.0.
1	{"status»: 1, «mensaje»: «No se encontró el archivo (absolute-app-path)"}	No es posible encontrar el archivo especificado para absolute-app-path.
1	{"status": 1, "message": "Unsupported file extension"}	El parámetro Absolute-app-path solo es compatible con los siguientes tipos de archivos: .exe y .bat.
1	{"status": 1, "message": "Directory not found (working-directory)"	No es posible encontrar el directorio especificado para working-directory.
1	{"status": 1, "message": "Optimization-manifest not found: <filename>"}	No es posible encontrar el archivo especificado para optimization-manifest.
1	{"status": 1, "message": "File not found: <filename>"}	No es posible encontrar un archivo especificado en el manifiesto de optimización.
255	{"status": 255, "message": <mensaje de error>}	Se ha producido un error inesperado. Intente volver a realizar la solicitud. Si el error persiste, ponte en contacto con nosotrosAWS Support para obtener ayuda. Para obtener más información, consulte AWS Supportel Centro.

Operación de remove-application

Elimina una aplicación de la lista de aplicaciones de la imagen AppStream 2.0. La aplicación no se desinstala ni modifica, pero los usuarios no podrán iniciarla desde el catálogo de aplicaciones AppStream 2.0.

Sinopsis

remove-application
--name <value>

Opciones

--name (cadena)

El identificador único de la aplicación que se va a eliminar.

Mensajes de salida

Código de salida	Mensaje que se muestra en la salida estándar	Descripción
0	{"status": 0, "message": "Success"}	La aplicación se ha eliminado correctamente.
1	{"status": 1, "message": "Administrator privileges are required to perform this operation"}	Se necesitan privilegios de administrador para llevar a cabo la operación.
1	{"status": 1, "message": "App not found"}	La aplicación que se especificó no se encuentra en el catálogo de aplicaciones AppStream 2.0.
255	{"status": 255, "message": <mensaje de error>}	Se ha producido un error inesperado. Intente volver a realizar la solicitud. Si el error persiste, ponte en contacto con nosotrosAWS Support para obtener ayuda. Para obtener más información, consulte AWS Supportel Centro.

Operación de list-applications

Muestra una lista de todas las aplicaciones especificadas en el catálogo de aplicaciones.

Sinopsis

list-applications

Mensajes de salida

Código de salida	Mensaje que se muestra en la salida estándar	Descripción
0	{"status": 0, "message": "Success", "applications": [ {..app1.. }, { ..app2.. }]}	Lista de aplicaciones del catálogo de aplicaciones AppStream 2.0.
255	{"status": 255, "message": <mensaje de error>}	Se ha producido un error inesperado. Intente volver a realizar la solicitud. Si el error persiste, ponte en contacto con nosotrosAWS Support para obtener ayuda. Para obtener más información, consulte AWS Supportel Centro.

Operación de update-default-profile

Copia el perfil de usuario de Windows especificado en el perfil de usuario predeterminado de Windows. Los usuarios nuevos que utilicen el streaming heredan la configuración almacenada en el perfil especificado.

nota

La herramienta CLI del asistente de imágenes de Linux no admite esta operación.

Sinopsis

update-default-profile
[--profile <value>]

Opciones

--profile (cadena)

El nombre del usuario cuyo perfil de Windows se copiará en el perfil de usuario predeterminado de Windows. Utilice el formato siguiente para el nombre:

"<dominio>\<nombre-de-usuario>"

Si el constructor de imágenes no se ha unido a un dominio de Microsoft Active Directory, escriba un punto "." para el dominio. Si no especifica ningún usuario, se usa la cuenta de usuario de la AppStream 2.0 Image der der der der der der der der der der der der der der der der der

Mensajes de salida

Código de salida	Mensaje que se muestra en la salida estándar	Descripción
0	{"status": 0, "message": "Success"}	La configuración de usuario se ha copiado correctamente al perfil predeterminado de Windows.
1	{"status": 1, "message": "Administrator privileges are required to perform this operation"}	Se necesitan privilegios de administrador para llevar a cabo la operación.
1	{"status": 1, "message": "Unable to copy file or folder: <path>. <reason>"}	La configuración de usuario no se pudo copiar porque un archivo o carpeta no estaba disponible.
1	{"status": 1, "message": "Cannot copy a domain user when not joined to a domain""}	Se ha especificado un usuario de un dominio de Microsoft Active Directory, pero el constructor de imágenes no se ha unido a un dominio de Active Directory.
255	{"status": 255, "message": <mensaje de error>}	Se ha producido un error inesperado. Intente volver a realizar la solicitud. Si el error persiste, ponte en contacto con nosotrosAWS Support para obtener ayuda. Para obtener más información, consulte AWS Supportel Centro.

Operación de reset-user-profile

Elimina el perfil de usuario de Windows para el usuario especificado.

nota

La herramienta CLI del asistente de imágenes de Linux no admite esta operación.

Sinopsis

reset-user-profile
[--profile <value>]

Opciones

--profile (cadena)

El nombre del usuario de Windows cuyo perfil de Windows se eliminará. Utilice el formato siguiente para el nombre:

"<dominio>\<nombre-de-usuario>"

Si el constructor de imágenes no se ha unido a un dominio de Microsoft Active Directory, escriba un punto "." para el dominio.

Mensajes de salida

Código de salida	Mensaje que se muestra en la salida estándar	Descripción
0	{"status": 0, "message": "Success"}	Se ha eliminado correctamente la configuración del usuario especificado.
1	{"status": 1, "message": "Administrator privileges are required to perform this operation"}	Se necesitan privilegios de administrador para llevar a cabo la operación.
1	{"status": 1, "message": "Unable to copy file or folder: <path>. <reason>"}	La configuración del usuario no se pudo restablecer porque un archivo o carpeta no estaba disponible.
1	{"status": 1, "message": "Cannot copy a domain user when not joined to a domain""}	Se ha especificado un usuario de un dominio de Microsoft Active Directory, pero el constructor de imágenes no se ha unido a un dominio de Active Directory.
255	{"status": 255, "message": <mensaje de error>}	Se ha producido un error inesperado. Intente volver a realizar la solicitud. Si el error persiste, ponte en contacto con nosotrosAWS Support para obtener ayuda. Para obtener más información, consulte AWS Supportel Centro.

Operación de create-image

Inicia el flujo de trabajo de creación de imágenes, lo que da como resultado una imagen AppStream 2.0 que se puede usar para flotas AppStream 2.0.

Sinopsis

create-image
--name <value>
[--description <value>]
[--display-name <value>]
[--enable-dynamic-app-catalog] | [--no-enable-dynamic-app-catalog]
[--use-latest-agent-version] | [--no-use-latest-agent-version]            
[--tags <value>]
[--dry-run]

Opciones

--name (cadena)

El nombre de la imagen AppStream 2.0. El nombre debe ser único dentro de la cuenta y laAWS región de Amazon. La longitud máxima es de 100 caracteres. Los caracteres permitidos son:

a-Z, 0-9, guiones bajos (_), guiones (-) y puntos (.).

El nombre de la imagen no puede comenzar por ninguno de los siguientes prefijos: "aws', "appstream" y "amazon". Estos prefijos están reservados para suAWS uso.

--description (cadena)

La descripción que se va a mostrar para la imagen. La longitud máxima es de 256 caracteres.

--display-name (cadena)

El nombre que se va a mostrar para la imagen. La longitud máxima es de 256 caracteres.

--enable-dynamic-app-catalog | --no-enable-dynamic-app-catalog

Habilita o deshabilita la compatibilidad con el marco de aplicaciones dinámicas AppStream 2.0. Si no especifica uno de los parámetros, la compatibilidad con el marco de aplicaciones dinámicas no está habilitada.

El marco de aplicaciones dinámicas proporciona operaciones dentro de una instancia de transmisión AppStream 2.0 que puede utilizar para crear un proveedor de aplicaciones dinámico. Los proveedores de aplicaciones dinámicas pueden utilizar estas operaciones para modificar el catálogo de aplicaciones al que los usuarios pueden tener acceso en tiempo real. Para obtener más información, consulte Utilice el marco de aplicaciones dinámicas AppStream 2.0 para crear un proveedor de aplicaciones dinámico.

--use-latest-agent-version | --no-use-latest-agent-version

Especifica si se debe fijar la imagen a la versión del agente AppStream 2.0 que está instalado actualmente o si se debe utilizar siempre la versión más reciente del agente. Si no especificas ninguno de los parámetros, la imagen se fija a la versión del agente AppStream 2.0 que esté instalada actualmente. Para obtener más información, consulte Gestione las versiones del agente AppStream 2.0.

--tags (cadena)

Las etiquetas que se deben asociar a la imagen. Una etiqueta es un par clave-valor. Use el siguiente formato:

--tags "miclave" "mivalor" "miclave2" "mivalor2"

Para obtener más información acerca de las etiquetas, consulte Etiquetar sus recursos de Amazon AppStream 2.0.

--dry-run (cadena)

Realiza la validación sin crear la imagen. Utilice este comando para identificar si la imagen tiene algún problema antes de crearla.

Mensajes de salida

Código de salida	Mensaje que se muestra en la salida estándar	Descripción
0	{"status": 0, "message": "Success"}	El flujo de trabajo para crear la imagen se inició correctamente.
1	{"status": 1, "message": "Administrator privileges are required to perform this operation"}	Se necesitan privilegios de administrador para llevar a cabo la operación.
1	{"status": 1, "message": "An image with the given name already exists"}	Ya existe una imagen con el nombre especificado en la cuenta de Amazon Web Services.
1	{"status": 1, "message": "Invalid value (tags)"}	Las etiquetas especificadas no son válidas.
255	{"status": 255, "message": <mensaje de error>}	Se ha producido un error inesperado. Intente volver a realizar la solicitud. Si el error persiste, ponte en contacto con nosotrosAWS Support para obtener ayuda. Para obtener más información, consulte AWS Supportel Centro.