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 aux transformations Java
Les informations suivantes peuvent vous aider à résoudre les problèmes courants liés à la transformation d'applications Java avec Amazon Q Developer.
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 ?.
Configurer 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 de certificats SSL ou TLS pour établir la communication entre Amazon S3 et votre IDE. Si vous utilisez un serveur proxy, les certificats SSL ou TLS utilisés par votre serveur proxy doivent être fiables, sinon Amazon Q ne pourra pas télécharger votre projet.
Si vous recevez une erreur liée à votre proxy ou à vos certificats, vous devrez probablement configurer votre IDE ou votre 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 votre IDE. Pour de plus amples informations, veuillez consulter Autoriser l'accès à Amazon S3.
Configurer les certificats dans JetBrains
Pour configurer votre JetBrains Environnement d'exécution Java IDE (JRE) Pour faire confiance aux certificats SSL ou TLS utilisés par votre serveur proxy, vous devez importer les certificats SSL ou TLS dans le cacerts
fichier du JRE. Le cacerts
fichier contient des certificats racines fiables pour des connexions sécurisées telles que HTTPS et SSL, et il fait partie des paramètres de sécurité du JRE. Pour importer un certificat, procédez comme suit.
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 votre JRE. Le chemin ducacerts
fichier dans le JRE interne livré avec votre JetBrains L'IDE dépend du système d'exploitation et de la version du JetBrains IDE que vous utilisez.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 JRE fourni avec JetBrains IDEs, qui est une version spécifique du 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 JRE intégré 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, vous serez invité à saisir le mot de passe du keystore. Le mot de passe par défaut du
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 à l'IDE lui-même, en plus du JRE. 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 certificats SSL ou TLS 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, voir Ajouter des certificats à un trousseau à l'aide de Keychain Access sur Mac
Installation de l' VSCode extension Mac CA
L' VSCode extension Mac CA
Pour installer l'extension, procédez comme suit :
-
Recherchez
mac-ca-vscode
dans le VS Code 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 l'URL de votre proxy.
-
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, procédez comme suit :
-
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' VSCode extension Win-CA
Pour installer l'extension, procédez comme suit :
-
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 l'URL de votre proxy.
-
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
Au cours d'une transformation, Amazon Q 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, les politiques DLP ou d'autres composants 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 le 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 L'environnement d'exécution (JRE) utilise le JDK de votre projet. Accédez à Paramètres, puis développez la section Création, exécution, déploiement. Élargir Mavenet choisissez Runner. Dans la liste déroulante JRE, choisissez Utiliser le JDK du projet.
-
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 l'environnement IDE 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 que l'IDE puisse le télécharger.
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 Support. Pour plus d'informations sur la prise Support de contact avec Amazon Q, consultezUtiliser Amazon Q Developer pour discuter avec 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.
Configurer les paramètres du proxy dans votre IDE
Amazon Q 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 de certificats SSL ou TLS pour établir la communication entre Amazon S3 et votre IDE. Si vous utilisez un serveur proxy, les certificats SSL ou TLS utilisés par votre serveur proxy doivent être fiables, sinon Amazon Q ne pourra pas télécharger votre projet.
Pour télécharger votre code, vous devrez peut-être configurer votre IDE pour qu'il approuve les certificats ou mettre à jour d'autres paramètres de proxy. Pour plus d'informations sur la mise à jour de vos paramètres de proxy, consultezConfigurer 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, l'erreur suivante 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 des paramètres proxy de votre IDE. Le SDK Java utilisé par Amazon Q 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 votre IDE. 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 Proxy HTTP
Comment accéder aux journaux de transformation du code ?
Accès et connexion JetBrains
Pour plus d'informations sur la façon d'accéder JetBrains fichiers journaux, voir Localisation des fichiers journaux IDE
Pour rechercher les journaux émis par Amazon Q dans JetBrains, recherchez la chaîne suivante dans les journaux IDE :
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.
Accès et connexion Visual Studio Code
Pour rechercher les journaux émis par Amazon Q 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 apparaît. -
Les journaux s'ouvrent dans l'IDE. 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).