Résolution des problèmes liés à AWS Systems ManagerDistributor

Les informations suivantes peuvent vous aider à résoudre les problèmes liés à l'utilisation de Distributor, une fonctionnalité de AWS Systems Manager.

Un package erroné portant le même nom est installé

Problème : vous avez installé un package, mais Distributor en a installé un autre à la place.

Cause : lors de l'installation, Systems Manager recherche les packages publiés par AWS avant les packages externes définis par l'utilisateur. Si le nom du package défini par l'utilisateur est identique à celui d'un package publié par AWS, c'est le package AWS qui est installé à la place du vôtre.

Solution : pour éviter ce problème, donnez à votre package un nom différent de celui du package publié par AWS.

Erreur : impossible de récupérer le manifeste ; la dernière version du package est introuvable

Problème : vous avez reçu une erreur similaire à la suivante.

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

Cause : vous utilisez une version de SSM Agent avec Distributor qui est antérieure à la version 2.3.274.0.

Solution : mettez à jour l'SSM Agent vers la version 2.3.274.0 ou ultérieure. Pour plus d’informations, consultez Mise à jour de SSM Agent à l'aide de Run Command ou Guide détaillé : mise à jour automatique de SSM Agent avec l’AWS CLI.

Erreur : Impossible de récupérer le manifeste ; exception de validation

Problème : vous avez reçu une erreur similaire à la suivante.

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

Cause : vous utilisez une version de SSM Agent avec Distributor qui est antérieure à la version 2.3.274.0.

Solution : mettez à jour l'SSM Agent vers la version 2.3.274.0 ou ultérieure. Pour plus d’informations, consultez Mise à jour de SSM Agent à l'aide de Run Command ou Guide détaillé : mise à jour automatique de SSM Agent avec l’AWS CLI.

Le package n'est pas pris en charge (l'action d'installation du package est manquante)

Problème : vous avez reçu une erreur similaire à la suivante.

Package is not supported (package is missing install action)

Cause : la structure du répertoire du package est incorrecte.

Solution : ne zippez pas un répertoire parent contenant le logiciel et les scripts requis. Au lieu de cela, créez un fichier .zip de tous les contenus requis directement dans le chemin absolu. Pour vérifier que la création du fichier .zip est correcte, dézippez le répertoire de la plateforme cible et vérifiez la structure du répertoire. Par exemple, le chemin absolu du script d'installation doit être /ExamplePackage_targetPlatform/install.sh.

Erreur : échec de téléchargement du manifeste : le document avec le nom n'existe pas

Problème : vous avez reçu une erreur similaire à la suivante.

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

Cause 1 : Distributor ne peut pas trouver le package par son nom lorsqu’un package Distributor est partagé à partir d’un autre compte.

Solution 1 : lors du partage d’un package à partir d’un autre compte, utilisez l’Amazon Resource Name (ARN) complet pour le package et pas seulement son nom.

Cause 2 : lorsque vous utilisez un VPC, vous n’avez pas fourni à votre profil d’instance IAM l’accès au compartiment S3 géré AWS qui contient le document AWS-ConfigureAWSPackage pour la Région AWS que vous ciblez.

Solution 2 : assurez-vous que votre profil d’instance IAM fournit à SSM Agent l’accès au compartiment S3 géré AWS qui contient le document AWS-ConfigureAWSPackage pour la Région AWS que vous ciblez, comme expliqué dans Communications de l'SSM Agent avec des compartiments S3 gérés par AWS.

Chargement échoué.

Problème : vous avez reçu une erreur similaire à la suivante.

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

Cause : le nom de votre package de logiciels inclut une espace. Par exemple, le téléchargement de Hello World.msi échouerait.