Solución de problemas de AWS Systems ManagerDistributor

La siguiente información puede ayudarle a solucionar problemas que pueden ocurrir cuando utiliza Distributor, una capacidad de AWS Systems Manager.

Instalación de paquete incorrecto con el mismo nombre

Problema: ha instalado un paquete, pero Distributor ha instalado un paquete diferente en su lugar.

Causa: durante la instalación, Systems Manager encuentra paquetes publicados por AWS como resultados antes que los paquetes externos definidos por el usuario. Si el nombre del paquete definido por el usuario es el mismo que un nombre de paquete publicado por AWS, el paquete de AWS se instala en lugar de su paquete.

Solución: para evitar este problema, asigne al paquete un nombre algo diferente del nombre de un paquete publicado por AWS.

Error: no se pudo recuperar el manifiesto: no se pudo encontrar la versión más reciente del paquete

Problema: ha recibido un error como el siguiente.

Failed to retrieve manifest: ResourceNotFoundException: Could not find the latest version of package 
arn:aws:ssm:::package/package-name status code: 400, request id: guid

Causa: está utilizando una versión de SSM Agent con Distributor anterior a la versión 2.3.274.0.

Solución: actualice la versión de SSM Agent a la versión 2.3.274.0 o una versión posterior. Para obtener más información, consulte Actualización de SSM Agent mediante Run Command o Tutorial: actualización automática de SSM Agent con AWS CLI.

Error: no se pudo recuperar el manifiesto: excepción de validación

Problema: ha recibido un error como el siguiente.

Failed to retrieve manifest: ValidationException: 1 validation error detected: Value 'documentArn'
at 'packageName' failed to satisfy constraint: Member must satisfy regular expression pattern:
arn:aws:ssm:region-id:account-id:package/package-name

Causa: está utilizando una versión de SSM Agent con Distributor anterior a la versión 2.3.274.0.

Solución: actualice la versión de SSM Agent a la versión 2.3.274.0 o una versión posterior. Para obtener más información, consulte Actualización de SSM Agent mediante Run Command o Tutorial: actualización automática de SSM Agent con AWS CLI.

El paquete no es compatible (falta la acción de instalación del paquete)

Problema: ha recibido un error como el siguiente.

Package is not supported (package is missing install action)

Causa: la estructura del directorio del paquete es incorrecta.

Solución: no comprima un directorio principal que contenga el software y los scripts necesarios. En su lugar, cree un archivo de .zip con todos los contenidos requeridos directamente en la ruta absoluta. Para comprobar que el archivo de .zip se creó correctamente, descomprima el directorio de la plataforma destino y revise la estructura del directorio. Por ejemplo, la ruta absoluta del script de instalación debe ser /ExamplePackage_targetPlatform/install.sh.

Error: Error al descargar el manifiesto: el documento con el nombre no existe

Problema: ha recibido un error como el siguiente.

Failed to download manifest - failed to retrieve package document description: InvalidDocument: Document with name filename does not exist.

Causa: Distributor no puede encontrar el paquete por el nombre del paquete al compartir un paquete de Distributor de otra cuenta.

Solución: cuando comparta un paquete de otra cuenta, utilice el nombre de recurso de Amazon (ARN) completo del paquete y no solo el nombre.

Carga fallida.

Problema: ha recibido un error como el siguiente.

Upload failed. At least one of your files was not successfully uploaded to your S3 bucket.

Causa: el nombre del paquete de software incluye un espacio. Por ejemplo, Hello World.msi no se podría cargar.