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

Cette section fournit des conseils pour résoudre les problèmes courants liés à AWS Transform custom.

Emplacements des journaux

AWS Transform CLI gère les journaux aux emplacements suivants :

Journaux de conversation :

Linux and macOS

~/.aws/atx/custom/<conversation_id>/logs/<timestamp>-conversation.log

Windows

%USERPROFILE%\.aws\atx\custom\<conversation_id>\logs\<timestamp>-conversation.log

Ces journaux contiennent l'historique complet des conversations pour le débogage d'exécutions de transformations spécifiques.

Journaux des sous-agents :

Linux and macOS

~/.aws/atx/custom/<conversation_id>/logs/subagents/<name>.log

Windows

%USERPROFILE%\.aws\atx\custom\<conversation_id>\logs\subagents\<name>.log

Ces journaux contiennent les résultats des sous-agents générés par l'agent principal lors des transformations. Il n'est pas nécessaire de gérer directement les sous-agents.

Journaux de débogage des développeurs :

Linux and macOS

~/.aws/atx/logs/debug*.log
~/.aws/atx/logs/error.log

Windows

%USERPROFILE%\.aws\atx\logs\debug*.log
%USERPROFILE%\.aws\atx\logs\error.log

Ces journaux fournissent des informations détaillées sur les opérations et les erreurs de la CLI. Chaque fichier journal est limité à 5 Mo avant d'être transféré. Ce répertoire peut contenir plusieurs journaux de débogage, tels que debug1.log et debug2.log.

Problèmes courants

Problèmes d'installation :

Si l'installation échoue, assurez-vous que la version Node.js 22 ou ultérieure est installée :

node --version

Téléchargez Node.js depuis https://nodejs.org/en/download si nécessaire.

Problèmes d'authentification :

Vérifiez que vos AWS informations d'identification sont correctement configurées :

aws sts get-caller-identity

Assurez-vous que votre utilisateur ou rôle IAM dispose des transform-custom:* autorisations requises.

Problèmes de connectivité réseau :

Si vous rencontrez des erreurs de connexion, vérifiez l'accès réseau aux points de terminaison requis :

Si vous travaillez dans un environnement où Internet est restreint, mettez à jour les règles de pare-feu pour autoriser la mise en liste de ces URL.

Problèmes de configuration de la région :

Si vous rencontrez des erreurs liées à la région :

Problèmes liés à Git :

Assurez-vous que Git est installé et que votre dépôt est sous le contrôle de source de Git :

git --version
git status

AWS Transform Custom nécessite que les référentiels soient sous le contrôle de source git.

Problèmes liés à l'exécution de la transformation :

En cas d'échec d'une transformation :

Problèmes liés à la reprise de la conversation :

Si vous ne parvenez pas à reprendre une conversation :

Obtention de support

Pour obtenir une assistance supplémentaire, consultez la AWS section Support via la AWS console.

Lorsque vous ouvrez un ticket d'assistance, incluez :

Problèmes d'accès au S3

Le service personnalisé AWS Transform fournit des URL pré-signées S3 pour faciliter le chargement et le téléchargement des fichiers de transformation potentiellement volumineux sur les machines clientes. to/from Cela signifie que non seulement la CLI interagit avec les points de terminaison du service AWS Transform, mais également avec les points de terminaison du service S3. Ces interactions utilisent des URL pré-signées, de sorte que les informations d'identification IAM de votre client ne nécessitent aucune autorisation S3, mais les configurations du serveur proxy de votre machine locale et les politiques de point de terminaison VPC S3 de votre réseau peuvent parfois restreindre ce trafic.

Consultez les messages d'erreur Emplacements des journaux pour obtenir des informations plus détaillées afin de déterminer à l'origine de toute défaillance d'outil ou de tout refus d'accès S3 lié au téléchargement et au chargement de fichiers de transformation.

Si vous utilisez un VPN/Proxy serveur qui exploite les variables d'no_proxyenvironnement https_proxy et, pensez à ajouter les valeurs suivantes à la valeur de votre variable d'no_proxyenvironnement afin de contourner le proxy pour les points de terminaison des services personnalisés S3 et AWS Transform, par exemple :

Linux and macOS

export no_proxy=.s3.amazonaws.com,transform-custom.<region>.api.aws

Windows (PowerShell)

$env:no_proxy=".s3.amazonaws.com,transform-custom.<region>.api.aws"

Si vous utilisez un AWS PrivateLink pour Amazon S3 dans votre VPC, une politique a peut-être été définie pour restreindre le trafic S3. Assurez-vous que votre politique de point de terminaison VPC S3 autorise GetObject et fonctionne pour les PutObject compartiments appartenant au service personnalisé AWS Transform. Cela peut être accompli en ajoutant l'instruction suivante à votre politique de point de terminaison VPC :

{
    "Effect": "Allow",
    "Principal": "*",
    "Action": ["s3:PutObject","s3:GetObject"],
    "Resource": "arn:aws:s3:::aws-transform-custom-*/*"
}

DenyLes déclarations explicites contenues dans les politiques ont priorité sur Allow les déclarations. Consultez les politiques des points de terminaison VPC S3 pour détecter les Deny déclarations susceptibles de restreindre l'accès.