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

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

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

Les informations suivantes peuvent vous aider à résoudre les problèmes susceptibles de survenir lorsque vous utilisez 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 de package défini par l'utilisateur est identique au nom d'un package AWS publié, le AWS package est installé à la place de votre package.

Solution : Pour éviter ce problème, donnez à votre package un nom différent du nom d'un package AWS publié.

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 Procédure pas à pas : mise à jour automatique SSM Agent avec 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 Procédure pas à pas : mise à jour automatique SSM Agent avec 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 : Distributorne peut pas trouver le package par son nom lorsqu'un package Distributor est partagé à partir d'un autre compte.

Solution : Lorsque vous partagez un package depuis un autre compte, utilisez le nom complet de la ressource Amazon (ARN) pour le package, et pas uniquement son nom.

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.