Instalación de una aplicación de componentes gestionada por un paquete distribuidor para imágenes de Windows de Image Builder - Generador de Imágenes de EC2
Requisitos previosConfiguración de permisos para Systems Manager DistributorConfiguración de distributor-package-windows como componente independienteConfiguración de aws-vss-components-windows como componente independienteBúsqueda de paquetes Distributor

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 gestionada por un paquete distribuidor para imágenes de Windows de Image Builder

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 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.

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 para recetas de imagen o Creación de una nueva versión de una receta de contenedor para recetas de contenedor. Para obtener más información sobre el AwsVssComponents paquete, consulte Crear una instantánea coherente con las aplicaciones de VSS en la Guía del usuario de Amazon EC2.

Requisitos previos

Antes de utilizar los componentes del 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.

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 AWS Management Console 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/.

  2. En el panel de navegación, seleccione Policies (Políticas) y, a continuación, seleccione Create policy (Crear política).

  3. 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.

    {
	"Version": "2012-10-17",
	"Statement": [
		{
			"Sid": "AllowDistributorSendCommand",
			"Effect": "Allow",
			"Action": [
				"ssm:SendCommand"
			],
			"Resource": [
				"arn:${AWS::Partition}:ssm:${AWS::Region}::document/AWS-ConfigureAWSPackage",
				"arn:${AWS::Partition}:ec2:${AWS::Region}:${AWS::AccountId}:instance/*"
			]
		},
		{
			"Sid": "AllowGetCommandInvocation",
			"Effect": "Allow",
			"Action": [
				"ssm:GetCommandInvocation"
			],
			"Resource": [
				"*"
			]
		}
	]
}

  4. Elija Review policy.

  5. En Name (Nombre), escriba un nombre para identificar la política, por ejemplo, InvokeDistributor u otro nombre que prefiera.

  6. (Opcional) En Description (Descripción), introduzca una descripción de la finalidad del rol.

  7. 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.

  2. En Select type of trusted entity (Seleccionar el tipo de entidad de confianza), elija Servicio de AWS.

  3. 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).

  4. En Select your use case (Seleccione su caso de uso), elija EC2 y, a continuación, Next: Permissions (Siguiente: Permisos).

  5. En la lista de políticas, seleccione la casilla de verificación situada junto a ManagedInstanceCoreAmazonSSM. (Escriba SSM en el cuadro de búsqueda si necesita reducir la lista.)

  6. En esta lista de políticas, seleccione la casilla situada junto a EC2. InstanceProfileForImageBuilder (Escriba ImageBuilder en el cuadro de búsqueda si necesita reducir la lista.)

  7. Elija Next: Tags (Siguiente: Etiquetas).

  8. (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.

  9. En Role name (Nombre del rol), escriba un nombre para el rol, por ejemplo, InvokeDistributor u otro nombre que prefiera.

  10. (Opcional) En Role description (Descripción de rol), sustituya el texto predeterminado por una descripción de este rol.

  11. 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.

  2. Seleccione Attach policies (Asociar políticas).

  3. Busque la política creada en el procedimiento anterior y seleccione la casilla junto al nombre.

  4. 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.

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.

  • 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.

  • 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 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.

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 AWS Management Console, inicie sesión en la AWS Systems Manager consola 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) 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 en la Guía del usuario de AWS Systems Manager .