Transformation de code avec Amazon Q Developer dans GitHub - Amazon Q Developer
Prérequis

Transformation de code avec Amazon Q Developer dans GitHub

Note

Amazon Q Developer pour GitHub est actuellement disponible en version préliminaire et susceptible d’être modifié.

Grâce à la fonctionnalité de transformation du code, vous pouvez mettre à jour votre pile technologique, améliorer les performances et garantir la compatibilité future tout en préservant les fonctionnalités de base de votre code existant. Avec Amazon Q Developer, vous pouvez éviter les dettes techniques et créer vos applications pour une durabilité et une mise à l'échelle à long terme.

Lorsque vous ajoutez l’étiquette de transformation de code à un problème ou que vous utilisez la commande slash /q transform, Amazon Q Developer transforme votre code de la version Java 8 ou 11 à la version 17. Amazon Q Developer crée ensuite une demande de tirage contenant les modifications et un résumé des modifications que vous pouvez intégrer à votre ligne principale.

Vous pouvez demander à Amazon Q Developer d’effectuer une transformation de code un nombre limité de fois par mois. Vous pouvez augmenter votre utilisation gratuite à tout moment en enregistrant l’installation de l’application Amazon Q Developer avec votre compte AWS. Pour plus d’informations, consultez Augmentation des limites d’utilisation et des détails de configuration dans la console Amazon Q Developer.

Prérequis

Avant de transformer votre base de code avec Amazon Q Developer, tenez compte des exigences suivantes :

Une fois les conditions requises remplies, vous pouvez appliquer l’étiquette d’agent de transformation Amazon Q et mettre à niveau votre base de code dans votre référentiel GitHub.

Important

L’application Amazon Q Developer tente de créer automatiquement l’agent de développement Amazon Q et les étiquettes de l’agent de transformation Amazon Q dans les référentiels GitHub auxquels vous autorisez l’accès. Si les étiquettes ne sont pas créées automatiquement ou si elles sont supprimées par inadvertance, vous pouvez les créer manuellement dans GitHub. Les étiquettes doivent être nommées agent de développement Amazon Q et agent de transformation Amazon Q pour être reconnues et traitées en tant qu’étiquettes Amazon Q Developer. Pour plus d’informations, consultez Création d’une étiquette dans la documentation GitHub.

Pour mettre à jour votre base de code

  1. Si nécessaire, connectez-vous à votre compte GitHub en utilisant vos informations d’identification GitHub.

  2. Accédez à votre organisation GitHub, puis au référentiel dans lequel vous souhaitez transformer votre base de code.

  3. Choisissez Problèmes, puis créez un nouveau problème. Pour plus d’informations, consultez Création d’un problème dans la documentation GitHub.

  4. Dans le champ de saisie de texte Ajouter un titre, entrez un titre qui fournit un contexte à Amazon Q Developer pour la transformation du code (exemple : « Mettre à niveau la base de code »). La description du problème doit également être incluse, car elle fournit également un contexte.

  5. Lorsque vous créez un problème ou que vous configurez un problème existant, vous pouvez appliquer l’étiquette Amazon Q Developer à la transformation du code ou utiliser la commande slash /q transform. Effectuez l’une des actions suivantes :

    • Pour appliquer l’étiquette au problème, effectuez l’une des actions suivantes :

      • Choisissez le menu déroulant Attribuer à Amazon Q fourni sous forme d’extension de navigateur, puis choisissez l’étiquette de l’agent de transformation Amazon Q.

      • Dans le menu de droite, choisissez Étiquettes, puis sélectionnez l’étiquette de l’agent de transformation Amazon Q.

    • Pour utiliser la commande slash /q transform dans un commentaire :

      1. Dans le problème, accédez à Ajouter un commentaire, puis saisissez /q transform dans le champ d’entrée du texte de commentaire.

      2. Choisissez Commentaire.

  6. Choisissez Créer un problème pour terminer la création du problème avec les informations nécessaires pour qu’Amazon Q Developer puisse transformer votre code.

    Lorsqu’Amazon Q Developer aura fini de générer des modifications de code pour le développement des fonctionnalités, il commentera le problème et ouvrira une demande de tirage.

  7. Accédez au commentaire laissé par Amazon Q Developer (exemple : « I finished upgrading your code and opened a pull request: Resolve Upgrade codebase. »), puis choisissez le lien de la demande de tirage.

    Vous pouvez également accéder à l’onglet demandes de tirage, puis choisir la demande de tirage créée par Amazon Q Developer.

  8. Cliquez sur l’onglet Fichiers modifiés pour afficher les modifications.

  9. Si vous êtes satisfaits des modifications de code proposées, vous pouvez fusionner la demande de tirage. Pour plus d’informations, consultez Fusion d’une demande de tirage.

Amazon Q Developer laisse un commentaire qui fournit un résumé de la transformation avec des détails concernant les fichiers mis à jour. Vous pouvez trouver le résumé dans le fichier build_logs.txt fourni dans le commentaire. Si Amazon Q Developer ne parvient pas à effectuer une transformation complète du code, il fournit également un résumé des erreurs qui ont empêché la transformation complète.