Amazon Q Developer pour GitHub (version préliminaire) - Amazon Q Developer

Amazon Q Developer pour GitHub (version préliminaire)

Note

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

Amazon Q Developer pour GitHub ou GitHub Enterprise Cloud vous permet de tirer parti des fonctionnalités d’Amazon Q Developer pour vos flux de travail de développement logiciel. Avec des agents de développement spécialisés, vous pouvez mettre en œuvre de nouvelles idées, examiner le code pour détecter les problèmes de qualité, corriger les vulnérabilités grâce à des tests unitaires et moderniser les applications Java existantes. Une fois que l’agent a terminé une tâche, vous pouvez fournir des commentaires et l’agent répète la solution précédente. Pour plus d’informations, consultez Agents Amazon Q Developer.

Vous pouvez accéder à l’intégration d’Amazon Q Developer via GitHub et l’autoriser à fournir un accès aux référentiels de votre organisation. Pour commencer à utiliser Amazon Q Developer pour GitHub, consultez Démarrage rapide : installation, utilisation de fonctionnalités dans GitHub et augmentation des limites d’utilisation.

Important

Pour installer l’application Amazon Q Developer et autoriser l’accès aux référentiels GitHub, vous devez satisfaire aux exigences de l’organisation GitHub. Pour plus d’informations, consultez Requirements to install a GitHub App et Rôles dans une organisation dans la documentation GitHub.

Note

L’intégration d’Amazon Q Developer avec GitHub traites les données aux États-Unis. Pour plus d’informations, consultez Traitement entre régions dans Amazon Q Developer.

Note

Amazon Q Developer pour GitHub (version préliminaire) n’utilise pas votre contenu pour améliorer le service à l’heure actuelle. Si nous l’autorisons à l’avenir, nous vous en informerons suffisamment à l’avance et nous vous fournirons un moyen de vous opposer à une telle utilisation.

Installation de l’application Amazon Q Developer et autorisation d’accès

En tant qu’administrateur d’organisation GitHub, vous pouvez installer et configurer l’application Amazon Q Developer à partir de GitHub gratuitement, sans avoir besoin de créer un compte AWS pour commencer. Au cours du processus d’installation, vous choisissez de fournir l’accès à tous les référentiels de votre organisation GitHub ou à certains d’entre eux. Après l’installation et l’autorisation, vous avez accès à une utilisation gratuite des fonctionnalités d’Amazon Q Developer dans GitHub. Vous pouvez augmenter l’utilisation gratuite en enregistrant l’installation de l’application dans la console Amazon Q Developer. Pour plus d’informations, consultez Démarrage rapide : installation, utilisation de fonctionnalités dans GitHub et augmentation des limites d’utilisation.

Important

Pour installer l’application Amazon Q Developer et autoriser l’accès aux référentiels GitHub, vous devez satisfaire aux exigences de l’organisation GitHub. Pour plus d’informations, consultez Requirements to install a GitHub App et Rôles dans une organisation dans la documentation GitHub.

Note

Si l’organisation de votre entreprise GitHub a activé la liste d’adresses IP autorisées, vous devez accepter les adresses IP autorisées dans l’application GitHub. Vous pouvez également choisir d’ajouter automatiquement les adresses IP à votre liste d’autorisations. Pour plus d’informations, consultez Allowing access by GitHub Apps et Enabling allowed IP addresses dans la documentation GitHub.

Les adresses IP suivantes sont utilisées pour accéder à vos ressources GitHub :

34.228.181.128 44.219.176.187 54.226.244.221

Agents Amazon Q Developer

Les agents Amazon Q Developer fournissent un support tout au long du cycle de développement logiciel, depuis le codage, les tests et le déploiement jusqu’à la résolution des problèmes et à la modernisation des applications.

  • Agent de développement Amazon Q : après avoir créé un problème et ajouté l’étiquette de développement des fonctionnalités, Amazon Q Developer implémente automatiquement vos nouvelles fonctionnalités et correctifs de bogues. Amazon Q Developer crée une demande de tirage avec les modifications, ainsi qu’un récapitulatif des modifications. Au lieu d’appliquer une étiquette, vous pouvez également lancer le développement de fonctionnalités à l’aide de la commande slash /q dev dans un commentaire du problème. Pour plus d’informations, consultez Développement de fonctionnalités et itération avec Amazon Q Developer dans GitHub.

  • Agent de révision du code Amazon Q : lorsqu’une nouvelle demande de tirage est créée ou si une demande de tirage fermée est ouverte à nouveau, Amazon Q Developer effectue automatiquement une révision du code et fournit des commentaires sur la qualité du code, les problèmes potentiels et les problèmes de sécurité. Amazon Q Developer génère également des correctifs pour les problèmes identifiés, que vous pouvez consulter et choisir de valider dans la demande de tirage. La révision du code inclut un résumé de la révision du code avec les résultats par fil de discussion. Vous pouvez interagir avec Amazon Q Developer en utilisant la commande /q contenue dans les commentaires de la demande de tirage pour poser des questions sur les résultats de la révision du code.

    Les révisions automatiques du code ne sont pas déclenchées par les validations ultérieures effectuées dans le cadre d’une demande de tirage existante. Vous pouvez lancer des révisions de code supplémentaires dans le cadre des demandes de tirage à l’aide de la commande slash /q review. Pour plus d’informations, consultez Révision du code avec Amazon Q Developer dans GitHub.

  • Agent de transformation Amazon Q : après avoir créé un problème et ajouté l’étiquette de transformation du code, Amazon Q Developer transforme votre code de la version Java 8 ou 11 à la version 17. Amazon Q Developer crée une demande de tirage contenant les modifications et un résumé des modifications. Au lieu d’appliquer une étiquette, vous pouvez également lancer la transformation du code à l’aide de la commande slash /q transform dans un commentaire du problème. Pour plus d’informations, consultez Transformation de code avec Amazon Q Developer dans 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.

Enregistrement de l’installation de l’application

L’intégration d’Amazon Q Developer pour GitHub est disponible gratuitement sans qu’il soit nécessaire de créer un compte AWS pour commencer. Vous recevez un nombre limité d’invocations par mois pour le développement de fonctionnalités et la transformation du code, ainsi qu’un nombre limité de lignes pour les révisions de code par mois. Vous pouvez augmenter l’utilisation gratuite 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.

Important

Pour enregistrer l’installation de l’application dans la console Amazon Q Developer, vous devez satisfaire aux exigences de l’organisation GitHub. Pour plus d’informations, consultez Conditions requises pour installer une application GitHub et OAuth apps et organisations dans la documentation GitHub.

Utilisation des extensions de navigateur dans GitHub

Vous pouvez utiliser l’extension Amazon Q Developer dans un navigateur compatible afin d’ajouter rapidement une étiquette pour le développement de fonctionnalités ou la transformation du code en cas de problème GitHub, sans avoir à effectuer de recherche dans les menus d’étiquettes.

L’extension Amazon Q Developer est disponible pour les navigateurs suivants :

Utilisation de commandes slash dans les problèmes GitHub et les demandes de tirage

Vous pouvez utiliser des commandes slash dans les problèmes relatifs aux problèmes avec GitHub ou les demandes de tirage pour invoquer Amazon Q Developer afin d’effectuer des tâches de développement ou de fournir une assistance.

  • /q dev : invoque Amazon Q Developer dans un problème avec GitHub pour implémenter automatiquement les nouvelles fonctionnalités et corriger les bogues. Amazon Q Developer crée une demande de tirage avec les modifications, ainsi qu’un récapitulatif des modifications.

  • /q review : invoque Amazon Q Developer pour effectuer automatiquement des révisions de code lorsque des demandes de tirage sont créées ou rouvertes. Les révisions de code fournissent des commentaires sur la qualité du code, les problèmes potentiels et les problèmes de sécurité, ainsi que des suggestions de correctifs et des résumés des révisions de code avec les résultats des analyses de code par fil de discussion. Utilisez /q dans les commentaires des demandes de tirage pour interagir avec les résultats. Les révisions automatiques ne sont pas déclenchées par les validations ultérieures des demandes de tirage existantes.

  • /q transform : invoque Amazon Q Developer pour transformer automatiquement le code Java 8 ou 11 en Java 17 lorsqu’un problème est créé avec l’étiquette de transformation du code. Amazon Q Developer crée une demande de tirage contenant les modifications et un résumé des modifications.

  • /q help : fournit des informations sur Amazon Q Developer pour GitHub, y compris les commandes slash, les fonctionnalités, les détails de personnalisation, ainsi qu’un lien vers la documentation Amazon Q Developer pour GitHub (version préliminaire) du Guide du développeur Amazon Q Developer.