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 La CLI Transform gère les journaux aux emplacements suivants :

Journaux de conversations :

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 d'avoir installé Node.js 22 ou une version ultérieure :

node --version

Node.js Téléchargez-le 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 votre 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 terminaux requis :

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

Problèmes de configuration des régions :

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 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 :

Si une transformation échoue :

Problèmes de reprise de conversation :

Si vous ne pouvez pas reprendre une conversation :

Obtention de support

Pour obtenir de l'aide supplémentaire, consultez la section AWS Support via la AWS console.

Lorsque vous ouvrez un ticket d'assistance, incluez :

Problèmes d'accès à S3

Le service personnalisé AWS Transform distribue des URL pré-signées S3 pour faciliter le chargement et le téléchargement des fichiers to/from de transformation potentiellement volumineux sur les machines clientes. Cela signifie que non seulement la CLI interagit avec les points de terminaison du service AWS Transform, mais qu'elle interagit é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 parfois, les configurations du serveur proxy de votre machine locale et les politiques des terminaux VPC S3 de votre réseau peuvent restreindre ce trafic.

Consultez les messages d'erreur Emplacements des journaux pour plus de détails afin d'aider à provoquer toute défaillance de l'outil ou 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, il se peut qu'une politique soit définie pour restreindre le trafic S3. Assurez-vous que votre politique relative aux points de terminaison S3 VPC autorise GetObject et PutObject gère les compartiments appartenant au service personnalisé AWS Transform. Cela peut être accompli en ajoutant la déclaration 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 S3 VPC Endpoint pour Deny détecter les déclarations susceptibles de restreindre l'accès.