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

AWS Systems ManagerChange Managern'est plus ouvert aux nouveaux clients. Les clients existants peuvent continuer à utiliser le service normalement. Pour plus d'informations, consultez AWS Systems ManagerChange Managerla section Modification de la disponibilité.

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 liés à l’utilisation de Distributor, un outil d’ 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 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 AWS géré qui contient le document correspondant au que Région AWS vous AWS-ConfigureAWSPackage ciblez.

Solution 2 : assurez-vous que votre profil d'instance IAM donne accès SSM Agent au compartiment S3 AWS géré qui contient le document correspondant à l'objet AWS-ConfigureAWSPackage que Région AWS vous ciblez, comme expliqué dansCommunications 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.

Erreur : Impossible de trouver la plateforme : aucun manifeste n’a été trouvé pour la plateforme : Oracle, version 8.9, architecture x86_64

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

Failed to find platform: no manifest found for platform: oracle, version 8.9, architecture x86_64

Cause : l’erreur signifie que le manifeste du package JSON n’a aucune définition pour cette plateforme, dans ce cas, Oracle Linux.

Solution : téléchargez le package que vous souhaitez distribuer depuis le site Trend Micro Deep Security Software. Créez un package logiciel .rpm à l’aide de : Créer un package à l’aide du flux de travail simple. Définissez les valeurs suivantes pour le package et complétez le package logiciel de chargement à l’aide du distributeur :

Platform version: _any Target platform: oracle Architecture: x86_64