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.
# Instalación de una aplicación de componentes administrada por un paquete distribuidor para imágenes de Windows de Generador de imágenes
AWS Systems Manager El distribuidor le ayuda a empaquetar y publicar software en los nodos AWS Systems Manager gestionados. Puede empaquetar y publicar su propio software o utilizar Distributor para buscar y publicar paquetes de software de agente proporcionados por AWS. Para obtener más información acerca de Systems Manager Distributor, consulte [AWS Systems Manager Distributor](https://docs.aws.amazon.com/systems-manager/latest/userguide/distributor.html) en la *Guía del usuario de AWS Systems Manager *.
**Componentes administrados por Distributor**
Los siguientes componentes gestionados por Image Builder utilizan AWS Systems Manager Distributor para instalar paquetes de aplicaciones en instancias de Windows.
+ El componente administrado `distributor-package-windows` utiliza el Distribuidor de AWS Systems Manager para instalar los paquetes de aplicaciones que especifique en la instancia de creación de imágenes de Windows. Para configurar los parámetros al incluir este componente en la receta, consulte [Configuración de `distributor-package-windows` como componente independiente](#mgdcomponent-distributor-config-standalone).
+ El `aws-vss-components-windows` componente usa AWS Systems Manager Distributor para instalar el `AwsVssComponents` paquete en la instancia de compilación de imágenes de Windows. Para configurar los parámetros al incluir este componente en la receta, consulte [Configuración de `aws-vss-components-windows` como componente independiente](#mgdcomponent-vss-config-standalone).
Para obtener más información sobre cómo utilizar los componentes administrados en su receta de Generador de Imágenes, consulte [Creación de una nueva versión de una receta de imagen](create-image-recipes.md) para recetas de imagen o [Creación de una nueva versión de una receta de contenedor](create-container-recipes.md) para recetas de contenedor. Para obtener más información sobre el paquete de `AwsVssComponents`, consulte [Crear una instantánea coherente con la aplicación de VSS](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/application-consistent-snapshots.html) en la *Guía del usuario de Amazon EC2*.
## Requisitos previos
Antes de utilizar los componentes de Generador de imágenes que dependen de Systems Manager Distributor para instalar paquetes de aplicaciones, debe asegurarse de que se cumplen los siguientes requisitos previos.
+ Los componentes de Generador de Imágenes que utilizan Systems Manager Distributor para instalar paquetes de aplicaciones en su instancia necesitan permiso para llamar a la API de Systems Manager. Antes de utilizar los componentes de una receta de Generador de Imágenes, debe crear el rol y la política de IAM que otorgan el permiso. Para configurar los permisos, consulte [Configuración de permisos para Systems Manager Distributor](#mgdcomponent-distributor-permissions).
**nota**
Por el momento, Generador de Imágenes no admite los paquetes de Systems Manager Distributor que reinician la instancia. Por ejemplo, los paquetes `AWSNVMe`, `AWSPVDrivers` y `AwsEnaNetworkDriver` de Distributor reinician la instancia y, por lo tanto, no están permitidos.
## Configuración de permisos para Systems Manager Distributor
El componente `distributor-package-windows` y otros componentes que lo utilizan, por ejemplo `aws-vss-components-windows`, requieren un permiso adicional en la instancia de compilación para ejecutarse. La instancia de compilación debe poder llamar a la API de Systems Manager para iniciar la instalación de Distributor y sondear el resultado.
Siga estos procedimientos Consola de administración de AWS para crear una política y un rol de IAM personalizados que concedan permiso a los componentes de Image Builder para instalar paquetes de Systems Manager Distributor desde la instancia de compilación.
**Paso 1: cree una política**
Cree una política de IAM para los permisos de Distributor.
1. Abra la consola de IAM en [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/).
1. En el panel de navegación, seleccione **Políticas** y, a continuación, **Crear política**.
1. En la página **Crear política**, elija la pestaña **JSON** y, a continuación, sustituya el contenido predeterminado por la siguiente política de JSON, sustituyendo la partición, la región y el identificador de cuenta según sea necesario, o bien utilizando caracteres comodín.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Sid": "AllowDistributorSendCommand",
"Effect": "Allow",
"Action": "ssm:SendCommand",
"Resource": [
"arn:aws:ssm:*::document/AWS-ConfigureAWSPackage",
"arn:aws:ec2:*:111122223333:instance/*"
]
},
{
"Sid": "AllowGetCommandInvocation",
"Effect": "Allow",
"Action": "ssm:GetCommandInvocation",
"Resource": "*"
}
]
}
```
------
1. Elija **Review policy**.
1. En **Name (Nombre)**, escriba un nombre para identificar la política, por ejemplo, `InvokeDistributor` u otro nombre que prefiera.
1. (Opcional) En **Description (Descripción)**, introduzca una descripción de la finalidad del rol.
1. Elija **Create Policy**.
**Paso 2: cree un rol**
Cree un rol de IAM para los permisos de Distributor.
1. En el panel de navegación de la consola de IAM, elija **Roles** y, a continuación, elija **Crear rol**.
1. En **Select type of trusted entity** (Seleccionar el tipo de entidad de confianza), elija **Servicio de AWS**.
1. Justo debajo de **Choose the service that will use this role (Elegir el servicio que utilizará este rol)**, elija **EC2** y, a continuación, elija **Next: Permissions (Siguiente: Permisos)**.
1. En **Select your use case (Seleccione su caso de uso)**, elija **EC2** y, a continuación, **Next: Permissions (Siguiente: Permisos)**.
1. En la lista de políticas, selecciona la casilla de verificación situada junto a **Amazon SSMManaged InstanceCore**. (Escriba `SSM` en el cuadro de búsqueda si necesita reducir la lista.)
1. En esta lista de políticas, selecciona la casilla situada junto a **EC2InstanceProfileForImageBuilder**. (Escriba `ImageBuilder` en el cuadro de búsqueda si necesita reducir la lista.)
1. Elija **Next: Tags (Siguiente: Etiquetas)**.
1. (Opcional) Agregue uno o varios pares clave-valor de etiqueta para organizar, realizar un seguimiento o controlar el acceso a este rol y, a continuación, elija **Siguiente: revisar**.
1. En **Role name (Nombre del rol)**, escriba un nombre para el rol, por ejemplo, `InvokeDistributor` u otro nombre que prefiera.
1. (Opcional) En **Role description (Descripción de rol)**, sustituya el texto predeterminado por una descripción de este rol.
1. Elija **Create role**. El sistema le devuelve a la página **Roles**.
**Paso 3: asocie la política al rol**
El último paso para configurar los permisos de Distributor es asociar la política de IAM al rol de IAM.
1. En la página **Roles** de la consola de IAM, seleccione el rol que acaba de crear. Se abre la página **Summary** (Resumen) del rol.
1. Seleccione **Attach policies (Asociar políticas)**.
1. Busque la política creada en el procedimiento anterior y seleccione la casilla junto al nombre.
1. Elija **Asociar política**.
Utilice este rol en el recurso de configuración de infraestructura de Generador de Imágenes para cualquier imagen que incluya componentes que utilicen de Systems Manager Distributor. Para obtener más información, consulte [Crear una configuración de infraestructura](create-infra-config.md).
## Configuración de `distributor-package-windows` como componente independiente
Para usar el componente `distributor-package-windows` en una receta, defina los siguientes parámetros que configuran el paquete que se va a instalar.
**nota**
Antes de utilizar el componente `distributor-package-windows` en una receta, debe asegurarse de que se cumplan todos los [Requisitos previos](#mgdcomponent-distributor-prereq).
+ **Acción** (obligatorio): especifique si desea instalar o desinstalar el paquete. Los valores válidos son `Install` y `Uninstall`. Este valor se establece de forma predeterminada en `Install`.
+ **PackageName**(Obligatorio): el nombre del paquete del distribuidor que se va a instalar o desinstalar. Para obtener una lista de nombres de paquete válidos, consulte [Búsqueda de paquetes Distributor](#mgdcomponent-distributor-find-pkg).
+ **PackageVersion**(Opcional): la versión del paquete distribuidor que se va a instalar. PackageVersion toma de forma predeterminada la versión recomendada.
+ **AdditionalArguments**(Opcional): cadena JSON que contiene los parámetros adicionales que debe proporcionar al script para instalar, desinstalar o actualizar un paquete. Para obtener más información, consulte **additionalArguments** en la sección **Inputs (Entradas)** de [aws:configurePackage](https://docs.aws.amazon.com/systems-manager/latest/userguide/documents-command-ssm-plugin-reference.html#aws-configurepackage) de la página de **referencia del complemento del documento Systems Manager Command**.
## Configuración de `aws-vss-components-windows` como componente independiente
Al utilizar el componente `aws-vss-components-windows` en una receta, tiene la opción de configurar el parámetro `PackageVersion` para utilizar una versión específica del paquete `AwsVssComponents`. Si omite este parámetro, el componente utilizará de forma predeterminada la versión recomendada del paquete `AwsVssComponents`.
**nota**
Antes de utilizar el componente `aws-vss-components-windows` en una receta, debe asegurarse de que se cumplan todos los [Requisitos previos](#mgdcomponent-distributor-prereq).
## Búsqueda de paquetes Distributor
Amazon y terceros proporcionan paquetes públicos que puede instalar con Systems Manager Distributor.
Para ver los paquetes disponibles en Consola de administración de AWS, inicie sesión en la [AWS Systems Manager consola](https://console.aws.amazon.com/systems-manager/;) y seleccione **Distribuidor** en el panel de navegación. La página **Distributor** muestra todos los paquetes disponibles para usted. Para obtener más información sobre la lista de paquetes disponibles en el AWS CLI, consulte [Ver paquetes (línea de comandos)](https://docs.aws.amazon.com/systems-manager/latest/userguide/distributor-view-packages.html) en la *Guía del AWS Systems Manager usuario*.
También puede crear sus propios paquetes de Systems Manager Distributor privados. Para obtener más información, consulte [Crear un paquete](https://docs.aws.amazon.com/systems-manager/latest/userguide/distributor-working-with-packages-create.html) en la *Guía del usuario de AWS Systems Manager *.