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 au Amazon Q Developer Agent for code transformation
Les informations suivantes peuvent vous aider à résoudre les problèmes courants liés au Amazon Q Developer Agent for code transformation.
Rubriques
- Pourquoi Amazon Q ne parvient-il pas à télécharger mon projet ?
- Pourquoi sont mes Maven les commandes échouent ?
- Comment ajouter Maven à mon PATH ?
- Pourquoi Amazon Q ne parvient-il pas à créer mon code ?
- Pourquoi ma transformation a-t-elle échoué au bout de 55 minutes ?
- Pourquoi ne puis-je pas télécharger mon code transformé ?
- Comment accéder aux journaux de transformation du code ?
- Comment puis-je trouver mon identifiant de poste de transformation ?
Pourquoi Amazon Q ne parvient-il pas à télécharger mon projet ?
Si le téléchargement de votre projet échoue, cela est probablement dû à l'un des problèmes suivants. Consultez le sujet correspondant à l'erreur que vous voyez sur Amazon Q.
Rubriques
Réduire la taille du projet
Pour transformer votre code, Amazon Q génère un artefact de projet, qui inclut votre code source, les dépendances du projet et les journaux de compilation. La taille maximale d'un artefact de projet pour une tâche de transformation est de 2 Go. Si vous recevez une erreur concernant la taille de l'artefact du projet, vous devez réduire la taille de votre projet ou essayer de transformer un projet plus petit. Vous pouvez consulter la taille du fichier d'artefact de votre projet dans les journaux de transformation du code. Pour plus d’informations, consultez Comment accéder aux journaux de transformation du code ?.
Configurez les paramètres du proxy dans votre IDE
Pour transformer votre code, Amazon Q télécharge l'artefact de votre projet dans un compartiment Amazon S3 appartenant au service. Une partie du processus de téléchargement implique l'utilisation SSL de TLS certificats pour établir la communication entre Amazon S3 et votreIDE. Si vous utilisez un serveur proxy, le SSL ou les TLS certificats utilisés par votre serveur proxy doivent être fiables, sinon Amazon Q ne sera pas en mesure de télécharger votre projet.
Si vous recevez une erreur liée à votre proxy ou à vos certificats, vous devrez probablement configurer votre IDE système d'exploitation pour qu'il fasse confiance à vos certificats ou mettre à jour d'autres paramètres de proxy.
Note
Vous pouvez également rencontrer des problèmes non liés aux certificats si vous vous trouvez derrière le serveur proxy ou le pare-feu de votre entreprise. Si vous suivez les procédures ci-dessous pour configurer vos certificats et que vous rencontrez toujours des problèmes, contactez votre administrateur réseau pour vous assurer que vous êtes autorisé à communiquer avec Amazon S3 depuis votreIDE. Pour de plus amples informations, veuillez consulter Autoriser l'accès à Amazon S3.
Configurer les certificats dans JetBrains
Pour configurer votre JetBrains IDEEnvironnement d'exécution Java (JRE) Pour faire confiance aux TLS certificats SSL ou utilisés par votre serveur proxy, vous devez importer les TLS certificats SSL or dans le cacerts
fichier duJRE. Le cacerts
fichier contient des certificats racines fiables pour des connexions sécurisées, tels que HTTPS etSSL, et il fait partie des paramètres de sécurité JRE du fichier. Pour importer un certificat, suivez la procédure ci-dessous.
Note
Nous vous recommandons d'effectuer une sauvegarde du cacerts
fichier avant de le modifier, car toute erreur peut entraîner des problèmes de connexion sécurisée.
-
Déterminez le chemin d'accès au
cacerts
fichier dans votreJRE. Le chemin ducacerts
fichier dans le fichier interne JRE livré avec votre JetBrains IDEdépend du système d'exploitation et de la version du JetBrains IDEtu utilises.Vous trouverez ci-dessous des exemples de chemins d'accès au
cacerts
fichier dans les systèmes d'exploitation courants. Choisissez votre système d'exploitation pour voir des exemples.Note
<JetBrains Installation Folder>
fait référence au répertoire où JetBrains les produits sont installés. Ce répertoire est généralement choisi au cours du processus d'installation.Le
jbr
dossier représente le contenu JRE fourni avec JetBrains IDEs, qui est une version spécifique du logiciel JRE conçue pour être utilisée avec JetBrains IDEs. -
Déterminez le certificat que vous devez importer dans le
cacerts
fichier. Le fichier de certificat possède généralement une extension de.der
fichier.cer
.crt
, ou. Si vous ne savez pas quels certificats vous devez ajouter, contactez votre administrateur réseau. -
Importez le certificat dans le
cacerts
keystore. Vous pouvez le faire à l'aide de lakeytool
commande Java.-
Ouvrez une invite de commande et entrez la commande suivante :
keytool -import -alias <alias> -file <certificate_file> -keystore <path_to_cacerts>
-
En
<alias>
effet, vous pouvez ajouter un nom au certificat que vous importez pour y faire référence ultérieurement. Cette option est facultative. -
Pour
<certificate_file>
, spécifiez le chemin d'accès au certificat que vous importez. Il doit s'agir d'un chemin vers le.der
fichier.cer
.crt
, ou contenant le certificat. -
Pour
<path_to_cacerts>
, spécifiez le chemin d'accès au fichiercacerts
keystore que vous avez enregistré à l'étape 1. Il s'agit du fichier dans lequel vous importez le certificat.
Par exemple, si vous souhaitez importer un certificat nommé
my_certificate.cer
dans lecacerts
keystore du fichier JRE groupé dans IntelliJ IDEA sous Windows, et si vous souhaitez attribuer l'aliasmyalias
au certificat, la commande peut être :keytool -import -alias myalias -file my_certificate.cer -keystore "C:\Program Files\JetBrains\IntelliJ IDEA 2022.3.2\jbr\bin\cacerts"
-
-
Au cours du processus d'importation, il vous sera demandé de saisir le mot de passe du keystore. Le mot de passe par défaut pour le
cacerts
keystore estchangeit
. -
Après avoir exécuté la commande, il vous sera demandé de faire confiance au certificat. Pour confirmer que le certificat est fiable et terminer l'importation, entrez
yes
. -
Vous devrez peut-être également ajouter les certificats au fichier IDE lui-même, en plus duJRE. Pour plus d'informations, consultez la section Certificats de serveur
dans le JetBrains .
Configurer les certificats dans Visual Studio Code
Pour configurer Visual Studio Code pour faire confiance aux SSL TLS certificats utilisés par votre serveur proxy, assurez-vous d'avoir configuré les paramètres de proxy suivants pour votre système d'exploitation.
Configurez les paramètres de proxy suivants pour Visual Studio Code sur macOS.
Ajoutez des certificats à votre trousseau macOS
Si ce n'est pas déjà fait, vous devez ajouter les certificats utilisés par votre serveur proxy à votre macOS porte-clés. Pour plus d'informations sur l'ajout de certificats à votre trousseau, consultez la section Ajouter des certificats à un trousseau à l'aide de Keychain Access sur Mac
Installation de l'VSCodeextension Mac CA
L'VSCodeextension Mac CA
Pour installer l'extension :
-
Recherchez
mac-ca-vscode
dans le VS Code dans le volet des extensions, puis choisissez Installer. -
Redémarrer VS Code.
Mettre à jour les paramètres du proxy dans VS Code sur macOS
Mettez à jour les paramètres suivants pour vous assurer VS Code est correctement configuré pour votre proxy.
-
Ouvrez les paramètres dans VS Code.
-
Entrez
proxy
dans la barre de recherche. -
Dans le champ Http : Proxy, ajoutez votre proxyURL.
-
Désélectionnez Http : Proxy Strict SSL.
-
Dans la liste déroulante Http : Proxy Support, sélectionnez Activé.
-
Dans la barre de recherche des paramètres, entrez
http.experimental.systemCertificatesV2
. Sélectionnez Http › Experimental : System Certificates V2.
Configurez les paramètres de proxy suivants pour Visual Studio Code sous Windows.
Ajouter un certificat en tant que certificat racine sécurisé sous Windows
Si ce n'est pas déjà fait, vous devez ajouter les certificats utilisés par votre serveur proxy à votre magasin Trusted Root Certification Authorities sous Windows. Pour ajouter un certificat, suivez la procédure suivante :
-
Ouvrez l'outil de recherche ou une fenêtre de commande Exécuter.
-
Entrez ce qui suit pour ouvrir l'outil Certificate Manager :
certmgr.msc
-
Choisissez le magasin Trusted Root Certification Authorities.
-
Cliquez avec le bouton droit sur Certificats, sélectionnez Toutes les tâches, puis sélectionnez Importer... .
-
Suivez les instructions données pour importer votre certificat proxy.
-
Après avoir importé votre certificat, confirmez qu'il a été ajouté.
Dans le magasin des autorités de certification Trusted Root, double-cliquez sur Certificats. Cliquez avec le bouton droit sur le certificat que vous avez ajouté et sélectionnez Propriétés. Sous Objectifs du certificat, l'option Activer tous les objectifs de ce certificat doit être sélectionnée.
Installez l'extension Win-CA VSCode
L'VSCodeextension Win-CA
Pour installer l'extension :
-
Recherchez
win-ca
dans le VS Code volet des paramètres. -
Dans la liste déroulante Injecter, choisissez Ajouter.
Mettre à jour les paramètres du proxy dans VS Code sous Windows
Mettez à jour les paramètres suivants pour vous assurer VS Code est correctement configuré pour votre proxy.
-
Ouvrez les paramètres dans VS Code.
-
Entrez
proxy
dans la barre de recherche. -
Dans le champ Http : Proxy, ajoutez votre proxyURL.
-
Désélectionnez Http : Proxy Strict SSL.
-
Dans la liste déroulante Http : Proxy Support, sélectionnez Activé.
-
Dans la barre de recherche des paramètres, entrez
http.experimental.systemCertificatesV2
. Sélectionnez Http › Experimental : System Certificates V2. -
Redémarrer VS Code.
Autoriser l'accès à Amazon S3
Lors d'une transformation, le Amazon Q Developer Agent for code transformation télécharge votre code dans un compartiment Amazon S3 appartenant au service. Si votre réseau ou votre organisation n'a pas configuré l'accès à Amazon S3, Amazon Q n'est pas en mesure de télécharger votre projet.
Pour qu'Amazon Q puisse charger votre projet, assurez-vous que la configuration de votre proxy et les autres composants réseau, tels que les politiques de prévention contre la perte de données (DLP), sont configurés de manière à autoriser l'accès à Amazon S3. Vous devrez peut-être également autoriser le compartiment Amazon S3 dans lequel Amazon Q télécharge votre projet. Pour de plus amples informations, veuillez consulter Périmètres de données pour les ressources Amazon Q.
Si vous transformez un projet de grande envergure, DLP les politiques ou autres composants du réseau peuvent entraîner des retards et empêcher le téléchargement réussi s'ils ne sont pas configurés pour autoriser le compartiment Amazon S3 sur liste d'autorisation. Si vous choisissez de ne pas autoriser le bucket à la liste, vous devrez peut-être transformer un projet plus petit afin qu'Amazon Q puisse le télécharger.
Pourquoi sont mes Maven les commandes échouent ?
Les suivants sont Maven problèmes de configuration que vous pourriez rencontrer dans JetBrains and Visual Studio Code IDEs. Si vous résolvez les problèmes et que vous voyez toujours Maven erreurs, il se peut qu'il y ait un problème avec votre projet. Utilisez les informations contenues dans les journaux d'erreurs pour résoudre tout problème lié à votre projet, puis réessayez de le transformer.
Mettre à jour Maven configuration dans JetBrains
Si une transformation échoue dans JetBrains en raison de Maven problèmes de commande, les journaux d'erreurs apparaissent dans l'onglet Exécuter. Utilisez les informations contenues dans les journaux pour résoudre le problème. Voici quelques problèmes que vous devrez peut-être résoudre :
-
Assurez-vous que votre Maven le chemin d'accueil est défini sur Bundled. Accédez à Paramètres, puis développez la section Création, exécution, déploiement. Développez la section Outils de construction, puis développez Maven. Dans la liste déroulante du chemin d'accueil de Maven, choisissez Bundled.
-
Assurez-vous que le Java runtime environment (JRE) utilise votre projetJDK. Accédez à Paramètres, puis développez la section Création, exécution, déploiement. Élargir Mavenet choisissez Runner. Dans la liste JREdéroulante, choisissez Utiliser le projet JDK.
-
Assurez-vous que Maven est activé. Accédez aux paramètres et choisissez Plugins. Rechercher pour Maven et choisissez le Maven . Si vous voyez un bouton Activer, choisissez-le pour activer Maven.
Mettre à jour Maven configuration dans Visual Studio Code
Si une transformation échoue dans VS Code à cause de Maven problèmes de commande, un fichier texte contenant les journaux d'erreurs s'ouvre dans un nouvel onglet. Utilisez les informations contenues dans les journaux pour résoudre le problème.
Assurez-vous d'avoir configuré l'une des options suivantes :
-
Votre projet contient un Maven enveloppe dans le dossier racine du projet
-
Une version de Maven pris en charge par Amazon Q est disponible sur votre
PATH
Pour plus d’informations, consultez Comment ajouter Maven à mon PATH ?.
Comment ajouter Maven à mon PATH
?
Pour transformer votre code en VS Code sans utiliser un Maven emballage, vous devez installer Maven et ajoutez-le à votre PATH
variable.
Pour vérifier si vous avez Maven déjà installé correctement, exécuté mvn -v
dans un nouveau terminal du système d'exploitation en dehors de Visual Studio Code. Vous devriez voir une sortie avec votre Maven version.
Si vous obtenez une sortie dans votre Visual Studio Code terminal mais pas dans le terminal de votre système d'exploitation, ou si la commande n'est pas trouvée, vous devez ajouter Maven à votrePATH
.
Pour ajouter Maven pour vousPATH
, suivez les instructions de votre machine.
Pourquoi Amazon Q ne parvient-il pas à créer mon code ?
Si la transformation échoue alors qu'Amazon Q crée votre code, il est possible que votre projet ne soit pas configuré correctement pour l'environnement dans lequel Amazon Q génère votre code. Vous devrez peut-être mettre à jour la configuration de votre build ou l'implémentation du code.
Consultez la sortie du journal de construction fournie par Amazon Q pour déterminer si vous pouvez apporter des modifications à votre projet. Voici quelques problèmes courants susceptibles d'empêcher Amazon Q de créer votre code.
Supprimer les chemins absolus dans le fichier pom.xml
Si votre fichier pom.xml contient un chemin absolu, Amazon Q ne sera pas en mesure de trouver les fichiers appropriés et, par conséquent, il se peut qu'il ne soit pas en mesure de créer votre code.
Voici un exemple de chemin absolu que vous pourriez avoir dans votre pom.xml
fichier :
<toolspath> <path>/Library/Java/JavaVirtualMachines/jdk-11.0.11.jdk/Contents/Home/lib/tools.jar</path> </toolspath>
Au lieu d'utiliser un chemin absolu, vous pouvez créer un chemin relatif à l'aide d'un pointeur. Voici un exemple de la façon dont vous pouvez remplacer le chemin absolu précédent par un chemin relatif :
<toolspath> <path>${java.home}/../lib/tools.jar</path> </toolspath>
Supprimer les bases de données locales ou externes dans les tests unitaires
Amazon Q exécute tous les tests unitaires de votre projet lors de la génération de votre code. Si un test unitaire appelle une base de données locale ou externe, Amazon Q n'aura pas accès à la base de données, ce qui entraînera l'échec de la compilation. Pour éviter l'échec de la génération, vous devez soit supprimer l'appel de base de données du test unitaire, soit supprimer le test unitaire avant de soumettre la transformation.
Pourquoi ma transformation a-t-elle échoué au bout de 55 minutes ?
Si votre tâche de transformation de code échoue au bout de 55 minutes, le temps de création de votre code dépasse probablement le délai de génération. Il y a actuellement une limite de temps de 55 minutes pour créer votre code.
Si votre temps de création local prend 55 minutes ou plus, réduisez le temps de génération de votre projet pour transformer votre code. Si votre build local est plus rapide que le build avec Code Transformation, vérifiez que votre projet ne comporte pas de tâches susceptibles d'échouer ou de prendre plus de temps dans un autre environnement. Envisagez de désactiver les scénarios de test de longue durée. Envisagez également d'utiliser des délais d'expiration pour les tentatives d'accès à des ressources qui pourraient ne pas être disponibles dans un IDE environnement sécurisé ou sur Internet.
Pourquoi ne puis-je pas télécharger mon code transformé ?
Si vous ne parvenez pas à télécharger votre code une fois la transformation terminée, cela est probablement dû à l'un des problèmes suivants. Consultez le sujet correspondant à l'erreur que vous voyez sur Amazon Q.
Rubriques
Réduire la taille du projet
Une fois la transformation terminée, Amazon Q génère un artefact de sortie contenant une différence avec votre code mis à niveau et un résumé de la transformation contenant des informations sur les modifications apportées. L'artefact de sortie doit être inférieur ou égal à 1 Go pour pouvoir être téléchargé. IDE
Si l'artefact en sortie dépasse la limite, vous ne pourrez pas télécharger le code mis à niveau ou le résumé de transformation. Essayez de transformer un projet plus petit pour éviter un artefact de sortie volumineux. Si le problème persiste, contactez AWS Support. Pour plus d'informations sur la prise AWS Support de contact avec Amazon Q, consultezUtiliser Amazon Q Developer pour discuter avec AWS Support.
Téléchargez le code diff dans les 24 heures
Le fichier de différence de code contenant votre code mis à niveau n'est disponible que 24 heures après la fin de la transformation. Si plus de 24 heures se sont écoulées depuis la fin de la transformation, redémarrez-la pour télécharger le fichier diff.
Configurez les paramètres du proxy dans votre IDE
Le Amazon Q Developer Agent for code transformation télécharge votre code mis à niveau depuis un compartiment Amazon S3 appartenant au service. Une partie du processus de téléchargement implique l'utilisation SSL de TLS certificats pour établir la communication entre Amazon S3 et votreIDE. Si vous utilisez un serveur proxy, le SSL ou les TLS certificats utilisés par votre serveur proxy doivent être fiables, sinon Amazon Q ne sera pas en mesure de télécharger votre projet.
Pour télécharger votre code, vous devrez peut-être configurer vos certificats de confiance ou mettre IDE à jour d'autres paramètres de proxy. Pour plus d'informations sur la mise à jour de vos paramètres de proxy, consultezConfigurez les paramètres du proxy dans votre IDE.
Supprimer les caractères génériques dans JetBrains paramètres du proxy
Si vous avez configuré les paramètres du proxy dans votre JetBrains IDE, le message d'erreur suivant peut s'afficher lors du téléchargement de votre code mis à niveau :
software.amazon.awssdk.core.exception.SdkClientException: Unable to execute HTTP request: Dangling meta character '*' near index 0
Cela est probablement dû à la présence d'un caractère générique (*) dans le champ Pas de proxy pour les paramètres IDE de votre proxy. Le Java SDK utilisé par le Amazon Q Developer Agent for code transformation ne prend pas en charge les entrées génériques dans ce champ.
Pour télécharger votre code, supprimez tous les caractères génériques du champ Aucun proxy pour, puis redémarrez votreIDE. Si vous devez spécifier des hôtes qui doivent contourner le proxy, utilisez une expression régulière au lieu d'un caractère générique. Pour mettre à jour les paramètres du proxy dans votre JetBrains IDE, consultez la section HTTPProxy
Comment accéder aux journaux de transformation du code ?
Access se connecte JetBrains
Pour plus d'informations sur la façon d'accéder JetBrains fichiers journaux, voir Localisation des fichiers IDE journaux
Pour rechercher les journaux émis par le Amazon Q Developer Agent for code transformation dans JetBrains, recherchez dans les IDE journaux la chaîne suivante :
software.aws.toolkits.jetbrains.services.codemodernizer
Les journaux de transformation du code commencent par la chaîne précédente. Logs générés par Maven sont affichés dans l'onglet Exécuter et comportent la chaîne précédente avant et après l'entrée du journal.
Access se connecte Visual Studio Code
Pour rechercher les journaux émis par le Amazon Q Developer Agent for code transformation dans VS Code, effectuez les étapes suivantes :
-
Choisissez Afficher dans la barre de navigation supérieure, puis sélectionnez Palette de commandes.
-
Effectuez
Amazon Q: View Logs
une recherche dans la palette de commandes qui s'affiche. -
Les journaux s'ouvrent dans leIDE. Pour rechercher dans les fichiers journaux
CodeTransformation
, utilisezCMD + F
ouControl + F
.
Connexion à la transformation du code VS Code sont préfixés parCodeTransformation:
. Voici un exemple de journal généré dans VS Code pour un Maven erreur de copie des dépendances :
2024-02-12 11:29:16 [ERROR]: CodeTransformation: Error in running Maven copy-dependencies command mvn = /bin/sh: mvn: command not found
Comment puis-je trouver mon identifiant de poste de transformation ?
Trouvez votre numéro d'emploi dans JetBrains
Pour trouver un identifiant de poste de transformation dans JetBrains, accédez à l'onglet Détails de la transformation dans le Transformation Hub et choisissez l'icône Afficher le statut du travail (horloge).
Trouvez votre numéro d'emploi dans Visual Studio Code
Pour trouver un identifiant de tâche de transformation dans VS Code, accédez au Transformation Hub et choisissez l'icône Afficher le statut de la tâche (horloge).