Amazon n' CodeCatalyst est plus ouvert aux nouveaux clients. Les clients existants peuvent continuer à utiliser le service normalement. Pour de plus amples informations, veuillez consulter [Comment effectuer une migration depuis CodeCatalyst](migration.md).
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.
# Tutoriels de mise en route
Amazon CodeCatalyst propose différents modèles pour vous aider à démarrer vos projets. Vous pouvez également choisir de commencer par un projet vide et d'y ajouter des ressources. Suivez les étapes décrites dans ces didacticiels pour découvrir certaines des manières dont vous pouvez travailler CodeCatalyst.
Si c'est la première fois que vous l'utilisez CodeCatalyst, nous vous suggérons de commencer par[Tutoriel : Création d'un projet avec le plan d'application Web moderne à trois niveaux](getting-started-template-project.md).
**Note**
Pour suivre ces didacticiels, vous devez d'abord terminer la configuration. Pour de plus amples informations, veuillez consulter [Configurer et se connecter à CodeCatalystConfigurer et se connecter à CodeCatalyst](setting-up-topnode.md).
**Topics**
+ [Tutoriel : Création d'un projet avec le plan d'application Web moderne à trois niveaux](getting-started-template-project.md)
+ [Tutoriel : Commencer avec un projet vide et ajouter manuellement des ressources](getting-started-blank-template.md)
+ [Tutoriel : Utiliser les fonctionnalités CodeCatalyst génératives de l'IA pour accélérer votre travail de développement](getting-started-project-assistance.md)
Pour des didacticiels supplémentaires axés sur des domaines fonctionnels spécifiques dans CodeCatalyst, voir :
+ [Commencer à utiliser les notifications Slack](getting-started-notifications.md)
+ [Commencer à utiliser les référentiels de CodeCatalyst sources et le plan d'application d'une seule page](source-getting-started.md)
+ [Commencer à utiliser les flux de travail](workflows-getting-started.md)
+ [Commencer à utiliser des plans personnalisés](getting-started-bp.md)
+ [Commencez avec le guide du développeur CodeCatalyst d'Amazon Action](https://docs.aws.amazon.com/codecatalyst/latest/adk/action-development-intro.html)
Pour des didacticiels approfondis, voir :
+ [Tutoriel : télécharger des artefacts sur Amazon S3](build-deploy.md)
+ [Tutoriel : Déployer une application sans serveur](deploy-tut-lambda.md)
+ [Tutoriel : Déployer une application sur Amazon ECS](deploy-tut-ecs.md)
+ [Tutoriel : Déploiement d'une application sur Amazon EKS](deploy-tut-eks.md)
+ [Tutoriel : code Lint à l'aide d'une action GitHub](integrations-github-action-tutorial.md)
+ [Tutoriel : Création et mise à jour d'une application React](blueprint-getting-started-tutorial.md)
# Tutoriel : Création d'un projet avec le plan d'application Web moderne à trois niveaux
Vous pouvez vous lancer plus rapidement dans le développement de logiciels en créant un projet à l'aide d'un plan. Un projet créé à l'aide d'un plan inclut les ressources dont vous avez besoin, notamment un référentiel de sources pour gérer votre code et un flux de travail pour créer et déployer l'application. Dans ce didacticiel, nous allons vous expliquer comment utiliser le modèle d'**application Web moderne à trois niveaux** pour créer un projet sur Amazon. CodeCatalyst Le didacticiel inclut également la visualisation de l'exemple déployé, l'invitation d'autres utilisateurs à travailler dessus et la modification du code avec des pull requests qui sont automatiquement créées et déployées sur les ressources du connected Compte AWS lorsque la pull request est fusionnée. Lorsque CodeCatalyst crée votre projet à l'aide de rapports, de flux d'activités et d'autres outils, votre plan crée AWS des ressources Compte AWS associées à votre projet. Vos fichiers de plan vous permettent de créer et de tester un exemple d'application moderne et de le déployer sur l'infrastructure du AWS Cloud.
L'illustration suivante montre comment les outils intégrés CodeCatalyst sont utilisés pour créer un problème afin de suivre, de fusionner et de créer automatiquement le changement, puis de démarrer un flux de travail dans le CodeCatalyst projet qui exécute des actions pour autoriser AWS CDK et CloudFormation approvisionner votre infrastructure.
Les actions génèrent des ressources dans le système associé Compte AWS et déploient votre application vers une AWS Lambda fonction sans serveur dotée d'un point de terminaison API Gateway. L' AWS Cloud Development Kit (AWS CDK) action convertit une ou plusieurs AWS CDK piles en CloudFormation modèles et déploie des piles sur votre. Compte AWS Les ressources de vos piles incluent les CloudFront ressources Amazon pour distribuer du contenu Web dynamique, une instance Amazon DynamoDB pour les données de votre application, ainsi que les rôles et les politiques qui prennent en charge l'application déployée.
![\[Une modification de code, depuis la création d'un problème jusqu'à la modification du référentiel source, qui est ensuite automatiquement créée et déployée sur les ressources dans AWS\]](http://docs.aws.amazon.com/fr_fr/codecatalyst/latest/userguide/images/modern-app-overview.png)
Lorsque vous créez un projet avec le plan d'**application Web moderne à trois niveaux**, votre projet est créé avec les ressources suivantes :
**Dans le CodeCatalyst projet** :
+ Un [référentiel source](source.md) avec un exemple de code et un flux de travail YAML
+ Un [flux de travail](workflow.md) qui crée et déploie l'exemple de code chaque fois qu'une modification est apportée à la branche par défaut
+ Un tableau des problèmes et un carnet de dossiers que vous pouvez utiliser pour planifier et suivre le travail
+ Une suite de rapports de test avec des rapports automatisés inclus dans l'exemple de code
**Dans le document associé Compte AWS** :
+ Trois AWS CloudFormation piles qui créent les ressources nécessaires à l'application.
Pour plus de détails sur les ressources qui seront créées dans AWS et dans CodeCatalyst le cadre de ce didacticiel, voir[Référence](#getting-started-template-project-reference).
**Note**
Les ressources et les exemples inclus dans un projet dépendent du plan que vous sélectionnez. Amazon CodeCatalyst propose plusieurs plans de projet qui définissent les ressources liées au langage ou au cadre défini. Pour en savoir plus sur les plans, voir[Création d'un projet complet avec des CodeCatalyst plansCréation d'un projet complet avec des plans](project-blueprints.md).
**Topics**
+ [Conditions préalables](#getting-started-template-project-prerequisites)
+ [Étape 1 : Création du projet d'application Web moderne à trois niveaux](#getting-started-template-project-proj-create)
+ [Étape 2 : Invitez quelqu'un à rejoindre votre projet](#getting-started-template-project-ipa-user)
+ [Étape 3 : créer des problèmes sur lesquels collaborer et suivre le travail](#getting-started-template-project-issue)
+ [Étape 4 : Afficher votre référentiel source](#getting-started-template-project-source)
+ [Étape 5 : Création d'un environnement de développement avec une branche de test et modification rapide du code](#getting-started-template-project-create-devenvironment)
+ [Étape 6 : Afficher le flux de travail qui crée l'application moderne](#getting-started-template-project-view-workflow)
+ [Étape 7 : demandez à d'autres personnes de revoir vos modifications](#getting-started-template-project-pull-request)
+ [Étape 8 : Clôturer le problème](#getting-started-template-project-close-issue)
+ [nettoyer des ressources ;](#getting-started-template-project-clean-up)
+ [Référence](#getting-started-template-project-reference)
## Conditions préalables
Pour créer un projet d'application moderne dans ce didacticiel, vous devez avoir effectué les tâches [Configurer et se connecter à CodeCatalystConfigurer et se connecter à CodeCatalyst](setting-up-topnode.md) suivantes :
+ Disposez d'un identifiant AWS Builder pour vous connecter à CodeCatalyst.
+ Appartenez à un espace et le rôle **d'**administrateur** de l'espace ou d'utilisateur** avancé vous est attribué dans cet espace. Pour plus d’informations, consultez [Création d’un espace](spaces-create.md), [Octroi d'autorisations d'espace aux utilisateurs](spaces-members.md) et [Rôle d’administrateur de l’espace](ipa-role-types.md#ipa-role-space-admin).
+ Compte AWS Associez-vous à votre espace et détenez le rôle IAM que vous avez créé lors de votre inscription. Par exemple, lors de l'inscription, vous avez la possibilité de choisir de créer un rôle de service avec une politique de rôle appelée politique de **CodeCatalystWorkflowDevelopmentRole-*spaceName***rôle. Le rôle portera un nom `CodeCatalystWorkflowDevelopmentRole-spaceName` avec un identifiant unique ajouté. Pour plus d'informations sur le rôle et la politique de rôle, consultez[Comprendre le rôle **CodeCatalystWorkflowDevelopmentRole-*spaceName***du service](ipa-iam-roles.md#ipa-iam-roles-service-role). Pour connaître les étapes de création du rôle, consultez[Création du **CodeCatalystWorkflowDevelopmentRole-*spaceName***rôle pour votre compte et votre espace](ipa-iam-roles.md#ipa-iam-roles-service-create).
## Étape 1 : Création du projet d'application Web moderne à trois niveaux
Une fois que vous l'avez créé, c'est dans votre projet que vous allez développer et tester le code, coordonner les tâches de développement et consulter les indicateurs du projet. Votre projet contient également vos outils et ressources de développement.
Dans ce didacticiel, vous allez utiliser le modèle d'**application Web moderne à trois niveaux** pour créer une application interactive. Le flux de travail créé et exécuté automatiquement dans le cadre de votre projet créera et déploiera l'application. Le flux de travail ne s'exécute correctement qu'une fois que tous les rôles et informations de compte ont été configurés pour votre espace. Une fois le flux de travail exécuté avec succès, vous pouvez accéder à l'URL du point de terminaison pour voir l'application.
**Pour créer un projet à l'aide d'un plan**
1. Ouvrez la CodeCatalyst console à l'[adresse https://codecatalyst.aws/](https://codecatalyst.aws/).
1. Dans la CodeCatalyst console, accédez à l'espace dans lequel vous souhaitez créer un projet.
1. Sélectionnez **Create a project (Créer un projet)**.
1. Choisissez **Commencer par un plan**.
1. Dans la barre de recherche, saisissez **modern**.
1. **Sélectionnez le plan d'**application Web moderne à trois niveaux**, puis cliquez sur Suivant.**
1. Dans **Nommer votre projet**, entrez un nom de projet. Par exemple :
**MyExampleProject**.
**Note**
Le nom doit être unique dans votre espace.
1. Dans **Compte**, choisissez celui Compte AWS que vous avez ajouté lors de votre inscription. Le plan installera des ressources dans ce compte.
1. Dans **Rôle de déploiement**, choisissez le rôle que vous avez ajouté lors de votre inscription. Par exemple, sélectionnez `CodeCatalystWorkflowDevelopmentRole-spaceName`.
Si aucun rôle n'est répertorié, ajoutez-en un. Pour ajouter un rôle, choisissez **Ajouter un rôle IAM** et ajoutez le rôle à votre Compte AWS. Pour de plus amples informations, veuillez consulter [Permettre l'accès aux AWS ressources avec Connected Comptes AWS](ipa-connect-account.md).
1. Dans **Compute platform**, choisissez **Lambda**.
1. Dans l'**option d'hébergement frontal**, choisissez **Amplify** Hosting. Pour plus d'informations AWS Amplify, voir [Qu'est-ce que l' AWS Amplify hébergement ?](https://docs.aws.amazon.com/amplify/latest/userguide/welcome.html) dans le *guide de AWS Amplify l'utilisateur*.
1. Dans **Région de déploiement**, entrez le code de région dans Région AWS lequel vous souhaitez que le plan pilote déploie l'application Mysfits et les ressources de support. Pour obtenir la liste des codes de région, consultez la section [Points de terminaison régionaux](https://docs.aws.amazon.com/general/latest/gr/rande.html#regional-endpoints) dans le *Références générales AWS*.
1. Dans **Nom de l'application**, laissez la valeur par défaut de`mysfitsstring`.
1. (Facultatif) Sous **Générer un aperçu du projet**, choisissez **Afficher le code** pour prévisualiser les fichiers source que le plan va installer. Choisissez **Afficher le flux de travail** pour prévisualiser les fichiers CI/CD de définition du flux de travail que le plan va installer. L'aperçu est mis à jour de manière dynamique en fonction de vos sélections.
1. Sélectionnez **Create a project (Créer un projet)**.
Le flux de travail du projet démarre dès que vous créez le projet. Il faudra un peu de temps pour terminer la création et le déploiement du code. En attendant, invitez quelqu'un d'autre à participer à votre projet.
## Étape 2 : Invitez quelqu'un à rejoindre votre projet
Maintenant que vous avez configuré votre projet, invitez d'autres personnes à travailler avec vous.
**Pour inviter quelqu'un à rejoindre votre projet**
1. Accédez au projet auquel vous souhaitez inviter des utilisateurs.
1. Dans le volet de navigation, sélectionnez **Paramètres du projet**.
1. Dans l'onglet **Membres**, sélectionnez **Inviter**.
1. Entrez les adresses e-mail des personnes que vous souhaitez inviter en tant qu'utilisateurs de votre projet. Vous pouvez saisir plusieurs adresses e-mail séparées par un espace ou une virgule. Vous pouvez également choisir parmi les membres de votre espace qui ne sont pas membres du projet.
1. Choisissez le rôle de l'utilisateur.
Lorsque vous avez terminé d'ajouter des utilisateurs, choisissez **Inviter**.
## Étape 3 : créer des problèmes sur lesquels collaborer et suivre le travail
CodeCatalyst vous aide à suivre les fonctionnalités, les tâches, les bogues et tout autre travail impliqué dans votre projet présentant des problèmes. Vous pouvez créer des problèmes pour suivre le travail et les idées nécessaires. Par défaut, lorsque vous créez un problème, celui-ci est ajouté à votre backlog. Vous pouvez déplacer les problèmes vers un tableau où vous pouvez suivre le travail en cours. Vous pouvez également attribuer un problème à un membre du projet en particulier.
**Pour créer un problème pour un projet**
1. Dans le volet de navigation, sélectionnez **Problèmes**.
1. Choisissez **Créer un problème**.
1. Dans **Titre du numéro**, saisissez le nom du problème. Fournissez éventuellement une description du problème. Dans cet exemple, utilisez **make a change in the `src/mysfit_data.json` file.**
1. Choisissez la priorité, l'estimation, le statut et les étiquettes. Sous **Personne assignée**, choisissez **\$1Ajouter moi** pour vous attribuer le problème.
1. Choisissez **Créer un problème**. Le problème est désormais visible sur le tableau. Choisissez la carte pour déplacer le problème vers la colonne **En cours**.
Pour de plus amples informations, veuillez consulter [Suivez et organisez le travail en cas de problèmes dans CodeCatalystSuivez et organisez le travail en cas de problèmes](issues.md).
## Étape 4 : Afficher votre référentiel source
Votre plan installe un référentiel source qui contient les fichiers permettant de définir et de prendre en charge votre application ou votre service. Voici quelques répertoires et fichiers remarquables du référentiel source :
+ Répertoire **.cloud9** : contient les fichiers de support pour l'environnement de AWS Cloud9 développement.
+ Répertoire **.codecatalyst** : contient le fichier de définition du `YAML` flux de travail pour chaque flux de travail inclus dans le plan.
+ Répertoire **.idea** — Contient les fichiers de support pour les environnements de JetBrains développement.
+ Répertoire **.vscode** : contient les fichiers de support pour l'environnement de développement de code Visual Studio.
+ Répertoire **CDKStacks** — Contient les fichiers de AWS CDK pile qui définissent l'infrastructure dans le. AWS Cloud
+ répertoire **src** — Contient le code source de l'application.
+ répertoire **tests** : contient des fichiers pour les tests entiers et unitaires exécutés dans le cadre du CI/CD flux de travail automatisé qui s'exécute lorsque vous créez et testez votre application.
+ répertoire **Web** — Contient le code source du frontend. Les autres fichiers incluent des fichiers de projet tels que le `package.json` fichier contenant des métadonnées importantes concernant votre projet, la `index.html` page du site Web, le `.eslintrc.cjs` fichier contenant le code linting et le `tsconfig.json` fichier permettant de spécifier les fichiers racines et les options du compilateur.
+ `Dockerfile`file — Décrit le conteneur de l'application.
+ `README.md`fichier — Contient les informations de configuration du projet.
**Pour accéder aux référentiels sources d'un projet**
1. Accédez à votre projet, puis effectuez l'une des opérations suivantes :
+ Sur la page de résumé de votre projet, choisissez le référentiel souhaité dans la liste, puis choisissez **Afficher le référentiel**.
+ Dans le volet de navigation, choisissez **Code**, puis sélectionnez **Référentiels sources**. Dans **Référentiels sources**, choisissez le nom du référentiel dans la liste. Vous pouvez filtrer la liste des référentiels en saisissant une partie du nom du référentiel dans la barre de filtre.
1. Sur la page d'accueil du référentiel, consultez le contenu du référentiel et les informations sur les ressources associées, telles que le nombre de pull requests et les flux de travail. Par défaut, le contenu de la branche par défaut est affiché. Vous pouvez modifier l'affichage en choisissant une autre branche dans la liste déroulante.
## Étape 5 : Création d'un environnement de développement avec une branche de test et modification rapide du code
Vous pouvez rapidement travailler sur le code de votre référentiel source en créant un environnement de développement. Pour ce didacticiel, nous partons du principe que vous allez :
+ Créez un environnement AWS Cloud9 de développement.
+ Choisissez l'option permettant de travailler dans une nouvelle branche de la branche **principale** lors de la création de l'environnement de développement.
+ Utilisez le nom `test` de cette nouvelle branche.
Dans une étape ultérieure, vous utiliserez l'environnement de développement pour modifier le code et créer une pull request.
**Pour créer un environnement de développement avec une nouvelle branche**
1. Ouvrez la CodeCatalyst console à l'[adresse https://codecatalyst.aws/](https://codecatalyst.aws/).
1. Accédez au projet dans lequel vous souhaitez créer un environnement de développement.
1. Choisissez le nom du référentiel dans la liste des référentiels sources du projet. Dans le volet de navigation, vous pouvez également choisir **Code**, choisir **Référentiels sources** et choisir le référentiel pour lequel vous souhaitez créer un environnement de développement.
1. Sur la page d'accueil du référentiel, choisissez **Create Dev Environment**.
1. Choisissez un IDE compatible dans le menu déroulant. Pour plus d’informations, consultez [Environnements de développement intégrés pris en charge pour les environnements de développement](devenvironment-create.md#devenvironment-supported-ide).
1. Choisissez le référentiel à cloner, choisissez **Travailler dans une nouvelle branche**, entrez le nom de la **branche dans le champ Nom** de la branche et choisissez une branche à partir de laquelle créer la nouvelle branche dans le menu déroulant **Créer une branche depuis**.
1. Ajoutez éventuellement un alias pour l'environnement de développement.
1. Vous pouvez éventuellement cliquer sur le bouton **d'édition de la configuration de l'environnement** de développement pour modifier la configuration de calcul, de stockage ou de temporisation de l'environnement de développement.
1. Choisissez **Créer**. Pendant la création de votre environnement de développement, la colonne d'état de l'environnement de développement affichera **Démarrage**, et la colonne d'état indiquera En **cours d'exécution** une fois l'environnement de développement créé. Un nouvel onglet s'ouvre avec votre environnement de développement dans l'IDE de votre choix. Vous pouvez modifier le code, valider et appliquer vos modifications.
Dans cette section, vous allez travailler avec votre exemple d'application généré en CodeCatalyst apportant des modifications au code à l'aide de requêtes d'extraction qui sont automatiquement créées et déployées sur les ressources de la connexion Compte AWS lorsque la demande d'extraction est fusionnée.
**Pour apporter une modification à votre `src/mysfit_data.json` fichier**
1. Accédez à l'environnement de développement de votre projet. Dans AWS Cloud9, développez le menu de navigation latéral pour parcourir les fichiers. `mysfits`Développez `src` et ouvrez`src/mysfit_data.json`.
1. Dans le fichier, modifiez la valeur du `"Age":` champ de 6 à 12. Votre ligne doit ressembler à ce qui suit :
```
{
"Age": 12,
"Description": "Twilight's personality sparkles like the night sky and is looking for a forever home with a Greek hero or God. While on the smaller side at 14 hands, he is quite adept at accepting riders and can fly to 15,000 feet. Twilight needs a large area to run around in and will need to be registered with the FAA if you plan to fly him above 500 feet. His favorite activities include playing with chimeras, going on epic adventures into battle, and playing with a large inflatable ball around the paddock. If you bring him home, he'll quickly become your favorite little Pegasus.",
"GoodEvil": "Good",
"LawChaos": "Lawful",
"Name": "Twilight Glitter",
"ProfileImageUri": "https://www.mythicalmysfits.com/images/pegasus_hover.png",
"Species": "Pegasus",
"ThumbImageUri": "https://www.mythicalmysfits.com/images/pegasus_thumb.png"
},
```
1. Enregistrez le fichier.
1. Accédez au référentiel mysfits à l'aide de la **cd /projects/mysfits** commande.
1. Ajoutez, validez et publiez vos modifications à l'aide des commandes **git add****, git commit** **et git push**.
```
git add .
git commit -m "make an example change"
git push
```
## Étape 6 : Afficher le flux de travail qui crée l'application moderne
Après avoir créé le projet d'application moderne, CodeCatalyst génère plusieurs ressources en votre nom, y compris un flux de travail. Un *flux de travail* est une procédure automatisée définie dans un fichier .yaml qui décrit comment créer, tester et déployer votre code.
Dans ce didacticiel, vous avez CodeCatalyst créé un flux de travail et l'avez démarré automatiquement lorsque vous avez créé votre projet. (Le flux de travail est peut-être toujours en cours d'exécution en fonction de la date à laquelle vous avez créé votre projet.) Utilisez les procédures suivantes pour vérifier la progression du flux de travail, consulter les journaux et les rapports de test générés, puis accéder à l'URL de l'application déployée.
**Pour vérifier la progression du flux de travail**
1. **Dans le volet de navigation de la CodeCatalyst console, choisissez **CI/CD**, puis Workflows.**
La liste des flux de travail s'affiche. Il s'agit des flux de travail générés et lancés par le CodeCatalyst plan lorsque vous avez créé votre projet.
1. Observez la liste des flux de travail. Vous devriez en voir quatre :
+ Les deux flux de travail en haut correspondent à la `test` branche que vous avez créée précédemment[Étape 5 : Création d'un environnement de développement avec une branche de test et modification rapide du code](#getting-started-template-project-create-devenvironment). Ces flux de travail sont des clones, les flux de travail de la `main` branche. Le n'**ApplicationDeploymentPipeline**est pas actif car il est configuré pour être utilisé avec la `main` branche. Le **OnPullRequest**flux de travail n'a pas été exécuté car aucune pull request n'a été effectuée.
+ Les deux flux de travail en bas correspondent à la `main` branche créée lorsque vous avez exécuté le plan plus tôt. Le **ApplicationDeploymentPipeline**flux de travail est actif et son exécution est en cours (ou terminée).
**Note**
Si l'**ApplicationDeploymentPipeline**exécution échoue avec une **DeployBackend**erreur ou une erreur **Build @cdk\$1bootstrap**, cela peut être dû au fait que vous avez déjà exécuté l'application Web moderne à trois niveaux et qu'elle a laissé d'anciennes ressources en conflit avec le plan actuel. Vous devrez supprimer ces anciennes ressources, puis réexécuter le flux de travail. Pour de plus amples informations, veuillez consulter [nettoyer des ressources ;](#getting-started-template-project-clean-up).
1. Choisissez le **ApplicationDeploymentPipeline**flux de travail associé à la `main` branche, en bas. Ce flux de travail a été exécuté à l'aide du code source de la `main` branche.
Un diagramme de flux de travail apparaît. Le diagramme montre plusieurs blocs, chacun représentant une tâche ou une *action*. La plupart des actions sont organisées verticalement, les actions situées en haut étant exécutées avant celles situées en dessous. Les actions agencées côte à côte s'exécutent en parallèle. Les actions regroupées doivent toutes s'exécuter correctement avant que l'action située en dessous puisse démarrer.
Les principaux blocs sont les suivants :
+ **WorkflowSource**— Ce bloc représente votre dépôt source. Il indique, entre autres informations, le nom du référentiel source (**mysfits**) et le commit qui a automatiquement lancé l'exécution du flux de travail. CodeCatalyst a généré ce commit lorsque vous avez créé votre projet.
+ **Construire** — Ce bloc représente un regroupement de deux actions qui doivent toutes deux être terminées avec succès pour que l'action suivante commence.
+ **DeployBackend**— Ce bloc représente une action qui déploie les composants principaux de l'application dans le AWS cloud.
+ **Tests** — Ce bloc représente un groupe de deux actions de test qui doivent toutes deux se terminer avec succès pour que l'action suivante démarre.
+ **DeployFrontend**— Ce bloc représente une action qui déploie les composants frontaux de l'application dans le AWS cloud.
1. Choisissez l'onglet **Définition** (en haut). Le [fichier de définition du flux](workflow-reference.md) de travail apparaît sur la droite. Le fichier contient les sections importantes suivantes :
+ Une `Triggers` section, en haut. Cette section indique que le flux de travail doit démarrer chaque fois que le code est transféré vers la `main` branche du référentiel source. Les push vers d'autres branches (par exemple`test`) ne démarreront pas ce flux de travail. Le flux de travail s'exécute à l'aide des fichiers de la `main` branche.
+ Une `Actions` section, sous`Triggers`. Cette section définit les actions que vous voyez dans le diagramme de flux de travail.
1. Choisissez l'onglet **État le plus récent** (en haut), puis choisissez une action dans le diagramme de flux de travail.
1. Sur la droite, choisissez l'onglet **Configuration** pour voir les paramètres de configuration utilisés par l'action lors de la dernière exécution. Chaque paramètre de configuration possède une propriété correspondante dans le fichier de définition du flux de travail.
1. Laissez la console ouverte et passez à la procédure suivante.
**Pour consulter les journaux de construction et les rapports de test**
1. Choisissez l'onglet **État le plus récent**.
1. Dans le diagramme du flux de travail, choisissez l'**DeployFrontend**action.
1. Attendez que l'action soit terminée. Surveillez que l'icône « En cours » (![\[Workflow in progress.\]](http://docs.aws.amazon.com/fr_fr/codecatalyst/latest/userguide/images/flows/run-in-progress.png)) soit remplacée par une icône « Succès » (![\[Workflow success.\]](http://docs.aws.amazon.com/fr_fr/codecatalyst/latest/userguide/images/flows/run-success.png)).
1. Choisissez l'action **build\$1backend**.
1. Choisissez l'onglet **Journaux** et développez quelques sections pour afficher les messages du journal relatifs à ces étapes. Vous pouvez voir les messages relatifs à la configuration du backend.
1. Choisissez l'onglet **Rapports**, puis sélectionnez le `backend-coverage.xml` rapport. CodeCatalyst affiche le rapport associé. Le rapport indique les tests de couverture de code qui ont été exécutés et indique la proportion de lignes de code validées avec succès par les tests, par exemple 80 %.
Pour plus d'informations sur les rapports de test, consultez[Tests avec des flux de travailTests avec des flux de travail](test-workflow-actions.md).
**Astuce**
Vous pouvez également consulter vos rapports de test en choisissant **Rapports** dans le volet de navigation.
1. Laissez la CodeCatalyst console ouverte et passez à la procédure suivante.
**Pour confirmer que l'application moderne a été déployée avec succès**
1. Retournez au **ApplicationDeploymentPipeline**flux de travail et choisissez le ***string*lien Exécuter** de la dernière exécution.
1. Dans le diagramme du flux de travail, recherchez l'**DeployFrontend**action et cliquez **sur le lien Afficher l'application**. Le site Web de Mysfit apparaît.
**Note**
Si le lien de l'**application View** n'apparaît pas dans l'**DeployFrontend**action, assurez-vous d'avoir choisi le lien Run ID.
1. **Recherchez le pégase Mysfit nommé Twilight Glitter.** Notez la valeur correspondant à l'âge. C'est le cas`6`. Vous allez modifier le code pour mettre à jour l'âge.
## Étape 7 : demandez à d'autres personnes de revoir vos modifications
Maintenant que des modifications ont été apportées à une branche nommée`test`, vous pouvez demander à d'autres personnes de les examiner en créant une pull request. Procédez comme suit pour créer une pull request afin de fusionner les modifications de la `test` branche dans la `main` branche.
**Pour créer une demande d’extraction**
1. Accédez à votre projet.
1. Effectuez l’une des actions suivantes :
+ Dans le volet de navigation, choisissez **Code**, choisissez **Pull requests**, puis **Create pull request**.
+ Sur la page d'accueil du référentiel, choisissez **Plus**, puis **Create pull request**.
+ Sur la page du projet, choisissez **Create pull request**.
1. Dans le **référentiel source**, assurez-vous que le référentiel source spécifié est celui qui contient le code validé. Cette option n'apparaît que si vous n'avez pas créé la pull request depuis la page principale du dépôt.
1. Dans **Branche de destination**, choisissez la branche dans laquelle vous souhaitez fusionner le code une fois celui-ci révisé.
1. Dans **Branche source**, choisissez la branche qui contient le code validé.
1. Dans **Titre de la demande d'extraction**, entrez un titre qui aide les autres utilisateurs à comprendre ce qui doit être revu et pourquoi.
1. (Facultatif) Dans la **description de la Pull request**, fournissez des informations telles qu'un lien vers les problèmes ou une description de vos modifications.
**Astuce**
Vous pouvez choisir **Write description for me** afin de générer CodeCatalyst automatiquement une description des modifications contenues dans la pull request. Vous pouvez apporter des modifications à la description générée automatiquement après l'avoir ajoutée à la pull request.
Cette fonctionnalité nécessite que les fonctionnalités d'IA générative soient activées pour l'espace et ne sont pas disponibles pour les pull requests dans les référentiels liés. Pour plus d'informations, consultez [la section Gestion des fonctionnalités d'IA générative](https://docs.aws.amazon.com/codecatalyst/latest/adminguide/managing-generative-ai-features.html).
1. (Facultatif) Dans **Problèmes**, choisissez **Lier les problèmes**, puis choisissez un problème dans la liste ou entrez son ID. Pour dissocier un problème, cliquez sur l'icône de dissociation.
1. (Facultatif) Dans **Réviseurs obligatoires**, sélectionnez **Ajouter les réviseurs requis**. Choisissez parmi la liste des membres du projet pour les ajouter. Les réviseurs requis doivent approuver les modifications avant que la pull request puisse être fusionnée dans la branche de destination.
**Note**
Vous ne pouvez pas ajouter un réviseur à la fois comme réviseur obligatoire et comme réviseur facultatif. Vous ne pouvez pas vous ajouter en tant que réviseur.
1. (Facultatif) Dans **Réviseurs facultatifs**, choisissez **Ajouter des réviseurs facultatifs**. Choisissez parmi la liste des membres du projet pour les ajouter. Les réviseurs facultatifs n'ont pas à approuver les modifications comme condition préalable pour que la pull request puisse être fusionnée dans la branche de destination.
1. Passez en revue les différences entre les branches. La différence affichée dans une pull request réside dans les modifications entre la révision dans la branche source et la base de fusion, qui est le commit principal de la branche de destination au moment de la création de la pull request. Si aucune modification ne s'affiche, il se peut que les branches soient identiques ou que vous ayez choisi la même branche pour la source et pour la destination.
1. Lorsque vous êtes certain que la pull request contient le code et les modifications que vous souhaitez vérifier, choisissez **Create**.
**Note**
Après avoir créé la pull request, vous pouvez ajouter des commentaires. Des commentaires peuvent être ajoutés à la pull request ou à des lignes individuelles des fichiers, ainsi qu'à la pull request globale. Vous pouvez ajouter des liens vers des ressources, telles que des fichiers, en utilisant le signe @ suivi du nom du fichier.
Lorsque vous créez la pull request, le **OnPullRequest**flux de travail commence à utiliser les fichiers source de la `test` branche. Pendant que vos réviseurs approuvent votre modification de code, vous pouvez observer les résultats en choisissant le flux de travail et en consultant le résultat du test.
Après avoir examiné la modification, vous pouvez fusionner le code. La fusion du code avec la branche par défaut lancera automatiquement le flux de travail qui créera et déploiera vos modifications.
**Pour fusionner une pull request depuis la CodeCatalyst console**
1. Accédez à votre projet d'application moderne.
1. Sur la page du projet, sous **Ouvrir les pull requests**, choisissez la pull request que vous souhaitez fusionner. Si vous ne voyez pas la pull request, choisissez **Afficher tout**, puis choisissez-la dans la liste. Choisissez **Merge (Fusionner)**.
1. Choisissez parmi les stratégies de fusion disponibles pour la pull request. **Sélectionnez ou désélectionnez éventuellement l'option permettant de supprimer la branche source après avoir fusionné la pull request, puis choisissez Merge.**
**Note**
Si le bouton **Fusionner** n'est pas actif ou si le libellé **Non fusionnable s'affiche**, cela signifie qu'un ou plusieurs réviseurs requis n'ont pas encore approuvé la pull request ou que la pull request ne peut pas être fusionnée dans la CodeCatalyst console. Un réviseur qui n'a pas approuvé une pull request est indiqué par une icône en forme d'horloge dans la section **Vue d'ensemble**, dans la zone des **détails de la pull request**. Si tous les réviseurs requis ont approuvé la pull request mais que le bouton **Fusionner** n'est toujours pas actif, il se peut que vous ayez un conflit de fusion. Vous pouvez résoudre les conflits de fusion pour la branche de destination dans la CodeCatalyst console, puis fusionner la pull request, ou vous pouvez résoudre les conflits et fusionner localement, puis transférer le commit contenant la fusion vers CodeCatalyst. Pour plus d'informations, consultez [Fusion d'une pull request (Git)](pull-requests-merge.md#pull-requests-merge-git) votre documentation Git.
Une fois que vous avez fusionné les modifications de la `test` branche dans la **main** branche, les modifications démarrent automatiquement le **ApplicationDeploymentPipeline**flux de travail qui crée et déploie votre modification.
**Pour voir le commit fusionné s'exécuter dans le ApplicationDeploymentPipeline flux de travail**
1. **Dans le volet de navigation, choisissez **CI/CD**, puis Workflows.**
1. Dans **Workflows**, dans **ApplicationDeploymentPipeline**, développez **Recent runs**. Vous pouvez voir le flux de travail lancé par le commit de fusion. Vous pouvez éventuellement le choisir pour suivre la progression de la course.
1. Une fois l'exécution terminée, rechargez l'URL que vous avez consultée plus tôt. Regardez le pégase pour vérifier que l'âge a changé.
![\[La modification du code fusionnée, créée et déployée, visible dans l'application\]](http://docs.aws.amazon.com/fr_fr/codecatalyst/latest/userguide/images/modified-mysfits.png)
## Étape 8 : Clôturer le problème
Lorsqu'un problème est résolu, il peut être fermé sur la CodeCatalyst console.
**Pour résoudre un problème lié à un projet**
1. Accédez à votre projet.
1. Dans le volet de navigation, sélectionnez **Problèmes**.
1. Drag-and-drop le problème est renvoyé à la colonne **Terminé**.
Pour de plus amples informations, veuillez consulter [Suivez et organisez le travail en cas de problèmes dans CodeCatalystSuivez et organisez le travail en cas de problèmes](issues.md).
## nettoyer des ressources ;
Nettoyez CodeCatalyst et supprimez AWS les traces de ce didacticiel dans votre environnement.
Vous pouvez choisir de continuer à utiliser le projet que vous avez utilisé pour ce didacticiel ou de supprimer le projet et les ressources associées.
**Note**
La suppression de ce projet supprimera tous les référentiels, problèmes et artefacts du projet pour tous les membres.
**Pour supprimer un projet**
1. Accédez à votre projet, puis sélectionnez **Paramètres du projet**.
1. Choisissez l'onglet **Général**.
1. Sous le nom du projet, choisissez **Supprimer le projet**.
**Pour supprimer des ressources dans CloudFormation et Amazon S3**
1. Connectez-vous AWS Management Console avec le même compte que celui que vous avez ajouté à votre CodeCatalyst espace.
1. Va au **CloudFormation**service.
1. Supprimez la pile **mysfits. *string***
1. Supprimez la pile **development-mysfits *string***.
1. Choisissez (mais ne supprimez pas) la **CDKToolkit**pile. Sélectionnez l'onglet **Ressources**. Choisissez le **StagingBucket**lien, puis supprimez le compartiment et son contenu dans Amazon S3.
**Note**
Si vous ne supprimez pas ce compartiment manuellement, une erreur peut s'afficher lors de la réexécution du plan d'application Web moderne à trois niveaux.
1. (Facultatif) Supprimez la **CDKToolkit**pile.
## Référence
Le plan d'application Web moderne à trois niveaux déploie des ressources dans votre CodeCatalyst espace et votre AWS compte dans le cloud. AWS Ces ressources sont les suivantes :
+ **Dans votre CodeCatalyst espace** :
+ Un CodeCatalyst projet qui inclut les ressources suivantes :
+ Un [référentiel source](source.md) — Ce référentiel contient un exemple de code pour une application Web « Mysfits ».
+ Un [flux de travail](workflow.md) — Ce flux de travail crée et déploie le code de l'application Mysfits chaque fois qu'une modification est apportée à la branche par défaut
+ Un [tableau des problèmes](issues.md) et un carnet de dossiers — Ce tableau et ce carnet peuvent être utilisés pour planifier et suivre le travail.
+ Une [suite de rapports de test](test-workflow-actions.md) — Cette suite inclut des rapports automatisés inclus dans l'exemple de code.
+ **Dans le document associé Compte AWS** :
+ Une **CDKToolkit**pile — Cette pile déploie les ressources suivantes :
+ Un compartiment intermédiaire Amazon S3, une politique de compartiment et la AWS KMS clé utilisée pour chiffrer le compartiment.
+ Rôle de déploiement IAM pour l'action de déploiement.
+ AWS Rôles et politiques IAM à l'appui des ressources de la pile.
**Note**
Le n'**CDKToolkit**est pas démonté et recréé pour chaque déploiement. Il s'agit d'une pile qui est initiée dans chaque compte pour prendre en charge le AWS CDK.
+ Une pile **development-mysfits** — Cette *string* BackEnd pile déploie les ressources de backend suivantes :
+ Un point de terminaison Amazon API Gateway.
+ AWS Rôles et politiques IAM à l'appui des ressources de la pile.
+ Une AWS Lambda fonction et une couche fournissent la plate-forme de calcul sans serveur pour les applications modernes.
+ Une politique et un rôle IAM pour le déploiement du bucket et la fonction Lambda.
+ Une *string* pile **mysfits** — Cette pile déploie l' AWS Amplify application frontale.
### Consultez aussi
Pour plus d'informations sur les AWS services dans lesquels les ressources sont créées dans le cadre de ce didacticiel, consultez les rubriques suivantes :
+ **Amazon S3** : un service permettant de stocker vos ressources frontales sur un service de stockage d'objets offrant une évolutivité, une haute disponibilité des données, une sécurité et des performances de pointe. Pour plus d'informations, consultez le [guide de l'utilisateur Amazon S3](https://docs.aws.amazon.com/AmazonS3/latest/userguide/).
+ **Amazon API Gateway** : un service de création, de publication, de maintenance, de surveillance et de sécurisation des protocoles REST, HTTP, et ce, WebSocket APIs à n'importe quelle échelle. Pour plus d'informations, consultez le [guide du développeur d'API Gateway](https://docs.aws.amazon.com/apigateway/latest/developerguide/).
+ **Amplify** — Un service d'hébergement de votre application frontale. Pour plus d'informations, consultez le [Guide de l'utilisateur de l'AWS Amplify hébergement](https://docs.aws.amazon.com/amplify/latest/userguide/welcome.html).
+ **AWS Cloud Development Kit (AWS CDK)**— Un cadre permettant de définir l'infrastructure cloud dans le code et de la provisionner via AWS CloudFormation ce dernier. AWS CDK Cela inclut le AWS CDK Toolkit, qui est un outil de ligne de commande permettant d'interagir avec des AWS CDK applications et des piles. Pour plus d’informations, consultez le [Guide du développeur AWS Cloud Development Kit (AWS CDK)](https://docs.aws.amazon.com/cdk/latest/guide/).
+ **Amazon DynamoDB** : service de base de données NoSQL entièrement géré pour le stockage de données. Pour plus d'informations, consultez le guide du [développeur Amazon DynamoDB](https://docs.aws.amazon.com/amplify/latest/userguide/welcome.html).
+ **AWS Lambda**— Un service permettant d'invoquer votre code sur une infrastructure informatique à haute disponibilité sans provisionner ni gérer de serveurs. Pour plus d’informations, consultez le [Guide du développeur AWS Lambda](https://docs.aws.amazon.com/lambda/latest/dg/).
+ **AWS IAM** — Service permettant de contrôler en toute sécurité l'accès à AWS ses ressources. Pour plus d'informations, consultez le [Guide de l'utilisateur IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/).
# Tutoriel : Commencer avec un projet vide et ajouter manuellement des ressources
Vous pouvez créer un projet vide sans aucune ressource prédéfinie en choisissant le plan de **projet vide** lorsque vous créez le projet. Après avoir créé un projet vide, vous pouvez créer et y ajouter des ressources en fonction des besoins de votre projet. Étant donné que les projets créés sans plan sont vides lors de leur création, cette option nécessite des connaissances supplémentaires en matière de création et de configuration de CodeCatalyst ressources pour démarrer.
**Topics**
+ [Conditions préalables](#getting-started-bt-prerequisites)
+ [Création d'un projet vide](#getting-started-bt-proj-create)
+ [Création d'un référentiel source](#getting-started-bt-source-create)
+ [Création d'un flux de travail pour créer, tester et déployer une modification de code](#getting-started-bt-workflow-create)
+ [Invitez quelqu'un à rejoindre votre projet](#getting-started-bt-ipa-user)
+ [Créez des problèmes sur lesquels collaborer et suivre le travail](#getting-started-bt-issue)
## Conditions préalables
Pour créer un projet vide, le rôle d'**administrateur de l'espace** ou **d'utilisateur avancé** doit vous être attribué. Si c'est la première fois que vous vous connectez à CodeCatalyst, consultez[Configurer et se connecter à CodeCatalystConfigurer et se connecter à CodeCatalyst](setting-up-topnode.md).
## Création d'un projet vide
La création d'un projet est la première étape pour pouvoir travailler ensemble. Si vous souhaitez créer vos propres ressources, telles que des référentiels sources et des flux de travail, vous pouvez commencer par un projet vide.
**Pour créer un projet vide**
1. Accédez à l'espace dans lequel vous souhaitez créer un projet.
1. Sur le tableau de bord de l'espace, choisissez **Créer un projet**.
1. Choisissez **Commencer à zéro**.
1. Sous **Donnez un nom à votre projet**, entrez le nom que vous souhaitez attribuer à votre projet. Le nom doit être unique dans votre espace.
1. Sélectionnez **Create a project (Créer un projet)**.
Maintenant que vous avez un projet vide, l'étape suivante consiste à créer un référentiel source.
## Création d'un référentiel source
Créez un référentiel source pour stocker et collaborer sur le code de votre projet. Les membres du projet peuvent cloner ce dépôt sur leur ordinateur local pour travailler sur le code. Vous pouvez également choisir de lier un dépôt hébergé dans un service pris en charge, mais cela n'est pas abordé dans ce didacticiel. Pour de plus amples informations, veuillez consulter [Lier un référentiel source](source-repositories-link.md).
**Pour créer un référentiel de sources**
1. Ouvrez la CodeCatalyst console à l'[adresse https://codecatalyst.aws/](https://codecatalyst.aws/).
1. Accédez à votre projet.
1. Dans le volet de navigation, choisissez **Code**, puis sélectionnez **Référentiels sources**.
1. Choisissez **Ajouter un référentiel**, puis sélectionnez **Créer un référentiel**.
1. Dans **Nom du référentiel**, saisissez un nom pour le référentiel. Dans ce guide, nous utilisons un autre nom*codecatalyst-source-repository*, mais vous pouvez en choisir un autre. Les noms des référentiels doivent être uniques au sein d'un projet. Pour plus d'informations sur les exigences relatives aux noms de référentiels, consultez[Quotas pour les référentiels sources dans CodeCatalyst](source-quotas.md).
1. (Facultatif) Dans **Description**, ajoutez une description du référentiel afin d'aider les autres utilisateurs du projet à comprendre à quoi sert le référentiel.
1. Choisissez **Créer un référentiel (par défaut)**. Cette option crée un référentiel qui inclut une branche par défaut et un fichier README.md. Contrairement à un dépôt vide, vous pouvez l'utiliser dès sa création.
1. Dans la **branche par défaut**, laissez le nom *principal*, sauf si vous avez une raison d'en choisir un autre. Les exemples présentés dans ce guide utilisent tous le nom *main* pour la branche par défaut.
1. (Facultatif) Ajoutez un `.gitignore` fichier correspondant au type de code que vous souhaitez envoyer.
1. Choisissez **Créer**.
**Note**
CodeCatalyst ajoute un `README.md` fichier à votre dépôt lorsque vous le créez. CodeCatalystcrée également un commit initial pour le dépôt dans une branche par défaut nommée **main**. Vous pouvez modifier ou supprimer le fichier README.md, mais vous ne pouvez pas supprimer la branche par défaut.
Vous pouvez rapidement ajouter du code dans votre dépôt en créant un environnement de développement. Pour ce didacticiel, nous vous recommandons de créer un environnement de développement en utilisant AWS Cloud9 et de choisir l'option permettant de créer une branche à partir de la branche **principale** lors de la création de l'environnement de développement. Nous utilisons le nom **test** de cette succursale, mais vous pouvez saisir un autre nom de succursale si vous préférez.
**Pour créer un environnement de développement avec une nouvelle branche**
1. Ouvrez la CodeCatalyst console à l'[adresse https://codecatalyst.aws/](https://codecatalyst.aws/).
1. Accédez au projet dans lequel vous souhaitez créer un environnement de développement.
1. Choisissez le nom du référentiel dans la liste des référentiels sources du projet. Dans le volet de navigation, vous pouvez également choisir **Code**, choisir **Référentiels sources** et choisir le référentiel pour lequel vous souhaitez créer un environnement de développement.
1. Sur la page d'accueil du référentiel, choisissez **Create Dev Environment**.
1. Choisissez un IDE compatible dans le menu déroulant. Pour plus d’informations, consultez [Environnements de développement intégrés pris en charge pour les environnements de développement](devenvironment-create.md#devenvironment-supported-ide).
1. Choisissez le référentiel à cloner, choisissez **Travailler dans une nouvelle branche**, entrez le nom de la **branche dans le champ Nom** de la branche et choisissez une branche à partir de laquelle créer la nouvelle branche dans le menu déroulant **Créer une branche depuis**.
1. Ajoutez éventuellement un alias pour l'environnement de développement.
1. Vous pouvez éventuellement cliquer sur le bouton **d'édition de la configuration de l'environnement** de développement pour modifier la configuration de calcul, de stockage ou de temporisation de l'environnement de développement.
1. Choisissez **Créer**. Pendant la création de votre environnement de développement, la colonne d'état de l'environnement de développement affichera **Démarrage**, et la colonne d'état indiquera En **cours d'exécution** une fois l'environnement de développement créé. Un nouvel onglet s'ouvre avec votre environnement de développement dans l'IDE de votre choix. Vous pouvez modifier le code, valider et appliquer vos modifications.
## Création d'un flux de travail pour créer, tester et déployer une modification de code
Dans CodeCatalyst, vous organisez la création, le test et le déploiement de vos applications ou services dans des flux de travail. Les flux de travail se composent d'actions et peuvent être configurés pour s'exécuter automatiquement après la survenue d'événements spécifiques du référentiel source, tels que des transferts de code ou l'ouverture ou la mise à jour d'une pull request. Pour de plus amples informations sur les flux de travail, veuillez consulter [Créez, testez et déployez avec des flux de travailCréez, testez et déployez avec des flux de travail](workflow.md).
Suivez les instructions [Commencer à utiliser les flux de travail](workflows-getting-started.md) pour créer votre premier flux de travail.
## Invitez quelqu'un à rejoindre votre projet
Maintenant que vous avez configuré votre projet personnalisé, invitez d'autres personnes à travailler avec vous.
**Pour inviter quelqu'un à rejoindre votre projet**
1. Accédez au projet auquel vous souhaitez inviter des utilisateurs.
1. Dans le volet de navigation, sélectionnez **Paramètres du projet**.
1. Dans l'onglet **Membres**, sélectionnez **Inviter**.
1. Entrez les adresses e-mail des personnes que vous souhaitez inviter en tant qu'utilisateurs de votre projet. Vous pouvez saisir plusieurs adresses e-mail séparées par un espace ou une virgule. Vous pouvez également choisir parmi les membres de votre espace qui ne sont pas membres du projet.
1. Choisissez le rôle de l'utilisateur.
Lorsque vous avez terminé d'ajouter des utilisateurs, choisissez **Inviter**.
## Créez des problèmes sur lesquels collaborer et suivre le travail
CodeCatalyst vous aide à suivre les fonctionnalités, les tâches, les bogues et tout autre travail impliqué dans votre projet présentant des problèmes. Vous pouvez créer des problèmes pour suivre le travail et les idées nécessaires. Par défaut, lorsque vous créez un problème, celui-ci est ajouté à votre backlog. Vous pouvez déplacer les problèmes vers un tableau où vous pouvez suivre le travail en cours. Vous pouvez également attribuer un problème à un membre du projet en particulier.
**Pour créer un problème pour un projet**
1. Ouvrez la CodeCatalyst console à l'[adresse https://codecatalyst.aws/](https://codecatalyst.aws/).
Assurez-vous de naviguer dans le projet dans lequel vous souhaitez créer des problèmes. Pour afficher tous les projets, dans le volet de navigation, choisissez **Amazon** et CodeCatalyst, si nécessaire, choisissez **Afficher tous les projets**. Choisissez le projet dans lequel vous souhaitez créer ou traiter les problèmes.
1. Dans le volet de navigation, choisissez **Track**, puis **Backlog**.
1. Choisissez **Créer un problème**.
1. Dans **Titre du numéro**, saisissez le nom du problème. Fournissez éventuellement une description du problème. Choisissez le statut, la priorité et l'estimation du problème, si vous le souhaitez. Vous pouvez également attribuer le problème à un membre du projet depuis la liste des membres du projet.
**Astuce**
Vous pouvez choisir d'attribuer un problème à **Amazon Q** pour qu'Amazon Q essaie de le résoudre. Si la tentative aboutit, une pull request sera créée et le statut du problème passera à **En révision** afin que vous puissiez revoir et tester le code. Pour de plus amples informations, veuillez consulter [Tutoriel : Utiliser les fonctionnalités CodeCatalyst génératives de l'IA pour accélérer votre travail de développement](getting-started-project-assistance.md).
Cette fonctionnalité nécessite que les fonctionnalités d'IA génératives soient activées pour l'espace. Pour plus d'informations, consultez [la section Gestion des fonctionnalités d'IA générative](https://docs.aws.amazon.com/codecatalyst/latest/adminguide/managing-generative-ai-features.html).
1. Choisissez **Enregistrer**.
Après avoir créé des problèmes, vous pouvez les attribuer aux membres du projet, les estimer et les suivre sur un tableau Kanban. Pour de plus amples informations, veuillez consulter [Suivez et organisez le travail en cas de problèmes dans CodeCatalystSuivez et organisez le travail en cas de problèmes](issues.md).
# Tutoriel : Utiliser les fonctionnalités CodeCatalyst génératives de l'IA pour accélérer votre travail de développement
Si vous avez un projet et un référentiel de sources sur Amazon CodeCatalyst dans un espace où les fonctionnalités d'IA générative sont activées, vous pouvez utiliser ces fonctionnalités pour accélérer le développement de logiciels. Les développeurs ont souvent plus de tâches à accomplir que de temps pour les accomplir. Ils ne prennent souvent pas le temps d'expliquer leurs modifications de code à leurs collègues lorsqu'ils créent des pull requests pour examiner ces modifications, s'attendant à ce que les autres utilisateurs trouvent ces modifications explicites. Les créateurs et réviseurs de pull request n'ont pas non plus le temps de rechercher et de lire attentivement tous les commentaires sur une pull request, en particulier si la pull request comporte plusieurs révisions. CodeCatalyst s'intègre à l'agent de développement Amazon Q pour le développement de logiciels afin de fournir des fonctionnalités d'IA génératives qui peuvent à la fois aider les membres de l'équipe à accomplir leurs tâches plus rapidement et augmenter le temps dont ils disposent pour se concentrer sur les aspects les plus importants de leur travail.
Amazon Q Developer est un assistant conversationnel génératif alimenté par l'IA qui peut vous aider à comprendre, créer, étendre et exploiter des applications. AWS Pour accélérer votre développement AWS, le modèle sur lequel repose Amazon Q est complété par AWS du contenu de haute qualité afin de produire des réponses plus complètes, exploitables et référencées. Pour plus d’informations, consultez la section [What is Amazon Q Developer?](https://docs.aws.amazon.com/amazonq/latest/aws-builder-use-ug/what-is.html) du *guide de l’utilisateur Amazon Q Developer*.
**Note**
**Propulsé par Amazon Bedrock** : AWS implémente la [détection automatique des abus](https://docs.aws.amazon.com//bedrock/latest/userguide/abuse-detection.html). Étant donné que les fonctionnalités **Rédiger une description pour moi**, **Créer un résumé du contenu**, **Recommander des tâches**, **Utiliser Amazon Q pour créer ou ajouter des fonctionnalités à un projet** et **Attribuer des problèmes à Amazon Q** avec l’agent Amazon Q Developer de développement logiciel sont basées sur Amazon Bedrock, les utilisateurs peuvent tirer pleinement parti des contrôles mis en œuvre dans Amazon Bedrock pour renforcer la sûreté, la sécurité et l’utilisation responsable de l’intelligence artificielle (IA).
Dans ce didacticiel, vous apprendrez à utiliser les fonctionnalités de l'IA générative pour vous aider CodeCatalyst à créer des projets avec des plans, ainsi qu'à ajouter des plans à des projets existants. En outre, vous apprendrez à résumer les modifications entre les branches lors de la création de pull requests et à synthétiser les commentaires laissés sur une pull request. Vous apprendrez également à créer des problèmes avec vos idées de modification ou d'amélioration du code et à les attribuer à Amazon Q. Dans le cadre de la résolution des problèmes assignés à Amazon Q, vous apprendrez comment autoriser Amazon Q à suggérer des tâches et comment attribuer et travailler sur les tâches créées dans le cadre de la résolution d'un problème.
**Topics**
+ [Conditions préalables](#getting-started-project-assistance-prerequisites)
+ [Utiliser Amazon Q pour choisir un plan lors de la création d'un projet ou de l'ajout de fonctionnalités](#getting-started-project-assistance-create-apply-bp)
+ [Créez un résumé des modifications de code entre les branches lors de la création d'une pull request](#getting-started-project-assistance-pull-request-summary)
+ [Créez un résumé des commentaires laissés sur les modifications de code dans une pull request](#getting-started-project-assistance-comment-summary)
+ [Créez un problème et attribuez-le à Amazon Q](#getting-started-project-assistance-issue-to-code)
+ [Créez un problème et demandez à Amazon Q de vous recommander des tâches à ce sujet](#getting-started-project-assistance-issue-to-tasks)
+ [nettoyer des ressources ;](#getting-started-project-assistance-clean-up)
## Conditions préalables
Pour utiliser les CodeCatalyst fonctionnalités de ce didacticiel, vous devez d'abord avoir terminé les ressources suivantes et y avoir accès :
+ Vous disposez d'un AWS Builder ID ou d'une identité d'authentification unique (SSO) à laquelle vous pouvez vous connecter. CodeCatalyst
+ Vous vous trouvez dans un espace où les fonctionnalités d'IA génératives sont activées. Pour plus d'informations, consultez [la section Gestion des fonctionnalités d'IA générative](https://docs.aws.amazon.com/codecatalyst/latest/adminguide/managing-generative-ai-features.html).
+ Vous avez le rôle de contributeur ou d'administrateur de projet dans un projet dans cet espace.
+ À moins que vous ne créiez un projet avec une IA générative, votre projet existant possède au moins un référentiel source configuré pour celui-ci. Les référentiels liés ne sont pas pris en charge.
+ Lorsque vous attribuez des problèmes à une solution initiale créée par l'IA générative, le projet ne peut pas être configuré avec l'extension **Jira Software**. L'extension n'est pas prise en charge pour cette fonctionnalité.
Pour plus d'informations, consultez [Création d’un espace](spaces-create.md), [Suivez et organisez le travail en cas de problèmes dans CodeCatalystSuivez et organisez le travail en cas de problèmes](issues.md), [Ajoutez des fonctionnalités aux projets avec des extensions dans CodeCatalystAjoutez des fonctionnalités aux projets avec des extensions](extensions.md) et [Octroi d'accès avec des rôles d'utilisateur](ipa-roles.md).
Ce didacticiel est basé sur un projet créé à l'aide du modèle d'**application Web moderne à trois niveaux** avec Python. Si vous utilisez un projet créé avec un plan différent, vous pouvez toujours suivre les étapes, mais certaines informations peuvent varier, telles que l'exemple de code et la langue.
## Utiliser Amazon Q pour choisir un plan lors de la création d'un projet ou de l'ajout de fonctionnalités
En tant que développeur de projet, vous pouvez collaborer avec Amazon Q, un assistant d'intelligence artificielle générative, lors de la création de nouveaux projets ou de l'ajout de composants à des projets existants. Vous pouvez fournir à Amazon Q les exigences relatives à votre projet en interagissant avec celui-ci via une interface de type chat. Sur la base de vos besoins, Amazon Q suggère un plan et décrit également les exigences qui ne peuvent pas être satisfaites. Si votre espace possède des plans personnalisés, Amazon Q en prend connaissance et inclut également ces plans dans les recommandations. Si vous êtes satisfait, vous pouvez ensuite suivre la suggestion d'Amazon Q, qui créera les ressources nécessaires, telles qu'un référentiel de sources contenant le code correspondant à vos besoins. Amazon Q crée également des problèmes liés aux exigences qui ne peuvent pas être satisfaites avec un plan. Pour en savoir plus sur les CodeCatalyst plans disponibles, consultez[Création d'un projet complet avec des CodeCatalyst plansCréation d'un projet complet avec des plans](project-blueprints.md). Pour en savoir plus sur l'utilisation d'Amazon Q avec des plans, consultez[Bonnes pratiques lors de l'utilisation d'Amazon Q pour créer des projets ou ajouter des fonctionnalités à l'aide de plans](projects-create.md#projects-create-amazon-q).
**Pour créer un projet avec Amazon Q**
1. Ouvrez la CodeCatalyst console à l'[adresse https://codecatalyst.aws/](https://codecatalyst.aws/).
1. Dans la CodeCatalyst console, accédez à l'espace dans lequel vous souhaitez créer un plan.
1. Sur le tableau de bord de l'espace, choisissez **Create with Amazon Q.**
1. Dans le champ de saisie de texte d'invite Amazon Q, fournissez des instructions en rédigeant une brève description du projet que vous souhaitez créer. Par exemple, `“I want to create a project in Python that has a presentation layer responsible for how the data is presented, an application layer that contains the core logic and functionality of the application, and a data layer that manages the storage and retrieval of the data.”`
(Facultatif) Sous **Exemples d'essai**, vous pouvez utiliser une invite préécrite en choisissant un plan. Par exemple, si vous choisissez l'application React, l'invite suivante s'affiche : `“I want to create a project in Python that has a presentation layer responsible for how the data is presented, an application layer that contains the core logic and functionality of the application, and a data layer that manages the storage and retrieval of the data. I also want to add authentication and authorization mechanisms for security and allowable actions.”`
1. Choisissez **Envoyer pour envoyer** vos instructions à Amazon Q. L'assistant d'IA générative fournit une suggestion et décrit les exigences auxquelles le plan ne peut pas répondre. Par exemple, Amazon Q peut suggérer ce qui suit en fonction de vos critères :
```
I recommend using the Modern three-tier web application blueprint based on
your requirements. Blueprints are dynamic and can always be updated and edited later.
Modern three-tier web application
By Amazon Web Services
This blueprint creates a Mythical Mysfits 3-tier web application with a modular presentation, application, and data layers.
The application leverages containers, infrastructure as code (IaC), continuous integration and continuous delivery (CI/CD),
and serverless code functions.
Version: 0.1.163
View details
The following requirements could not be met so I will create issues for you.
• Add authentication and authorization mechanisms for security and allowable actions.
```
1. (Facultatif) Pour afficher les détails détaillés du plan suggéré, choisissez **Afficher les détails**.
1. Effectuez l’une des actions suivantes :
1. Choisissez **Oui, utilisez ce plan** si vous êtes satisfait de la suggestion.
1. Choisissez **Modifier l'invite** si vous souhaitez modifier l'invite.
1. Choisissez **Recommencer** si vous souhaitez effacer complètement l'invite.
1. Effectuez l’une des actions suivantes :
1. Choisissez **Configurer** si vous souhaitez configurer le plan suggéré. Vous pouvez également configurer le plan ultérieurement.
1. Choisissez **Ignorer** si vous ne souhaitez pas modifier les configurations du plan pour le moment.
1. Si vous avez choisi de configurer le plan, choisissez **Continuer** après avoir modifié les ressources du projet.
1. Lorsque vous y êtes invité, entrez le nom que vous souhaitez attribuer à votre projet et les noms des ressources associées. Le nom doit être unique dans votre espace.
1. Choisissez **Créer un projet** pour créer un projet avec le plan. Amazon Q crée des ressources à l'aide du plan. Par exemple, si vous créez un projet avec le plan d'application d'une seule page, un référentiel source pour le code et les flux de travail pertinents est créé. CI/CD
1. (Facultatif) Par défaut, Amazon Q crée également des problèmes liés aux exigences qui ne sont pas satisfaites par un plan. Vous pouvez choisir les éléments pour lesquels vous ne souhaitez pas créer de problèmes. Après avoir choisi de laisser Amazon Q créer des problèmes, vous pouvez également attribuer un problème à Amazon Q. Il analysera le problème dans le contexte des référentiels sources donnés, en fournissant un résumé des fichiers sources et du code pertinents. Pour plus d’informations, consultez [Recherche et affichage des problèmes](issues-view.md), [Créez un problème et attribuez-le à Amazon Q](#getting-started-project-assistance-issue-to-code) et [Bonnes pratiques lors de la création et du traitement des problèmes assignés à Amazon Q](issues-create-issue.md#issues-create-issue-assign-genai-best-practices).
Après avoir créé un projet avec Amazon Q, vous pouvez également utiliser Amazon Q pour ajouter de nouveaux composants, car il suggère des CodeCatalyst plans en fonction de vos besoins.
**Pour ajouter un plan avec Amazon Q**
1. Ouvrez la CodeCatalyst console à l'[adresse https://codecatalyst.aws/](https://codecatalyst.aws/).
1. Dans la CodeCatalyst console, accédez au projet dans lequel vous souhaitez ajouter un plan.
1. Choisissez **Ajouter avec Amazon Q.**
1. Dans le champ de saisie de texte d'invite Amazon Q, fournissez des instructions en rédigeant une brève description du projet que vous souhaitez créer. Par exemple, `“I want to create a project in Python that has a presentation layer responsible for how the data is presented, an application layer that contains the core logic and functionality of the application, and a data layer that manages the storage and retrieval of the data.”`
(Facultatif) Sous **Exemples d'essai**, vous pouvez utiliser une invite préécrite en choisissant un plan. Par exemple, si vous choisissez l'application React, l'invite suivante s'affiche : `“I want to create a project in Python that has a presentation layer responsible for how the data is presented, an application layer that contains the core logic and functionality of the application, and a data layer that manages the storage and retrieval of the data. I also want to add authentication and authorization mechanisms for security and allowable actions.”`
1. Choisissez **Envoyer pour envoyer** vos instructions à Amazon Q. L'assistant d'IA générative fournit une suggestion et décrit les exigences auxquelles le plan ne peut pas répondre. Par exemple, Amazon Q peut suggérer ce qui suit en fonction de vos critères :
```
I recommend using the Single-page application blueprint based on your requirements. Blueprints are dynamic and can always be updated and edited later.
Single-page application
By Amazon Web Services
This blueprint creates a SPA (single-page application) using React, Vue, or Angular frameworks and deploys to AWS Amplify Hosting.
Version: 0.2.15
View details
The following requirements could not be met so I will create issues for you.
• The application should have reusable UI components
• The application should support for client-side routing
• The application may require server-side rendering for improved performance and SEO
```
1. (Facultatif) Pour afficher les détails détaillés du plan suggéré, choisissez **Afficher les détails**.
1. Effectuez l’une des actions suivantes :
1. Choisissez **Oui, utilisez ce plan** si vous êtes satisfait de la suggestion.
1. Choisissez **Modifier l'invite** si vous souhaitez modifier l'invite.
1. Choisissez **Recommencer** si vous souhaitez effacer complètement l'invite.
1. Effectuez l’une des actions suivantes :
1. Choisissez **Configurer** si vous souhaitez configurer le plan suggéré. Vous pouvez également configurer le plan ultérieurement.
1. Choisissez **Ignorer** si vous ne souhaitez pas modifier les configurations du plan pour le moment.
1. Si vous avez choisi de configurer le plan, choisissez **Continuer** après avoir modifié les ressources du projet.
1. Choisissez **Ajouter au projet** pour ajouter des ressources à un projet avec le plan. Amazon Q crée des ressources à l'aide du plan. Par exemple, si vous ajoutez à un projet avec le plan d'application d'une seule page, un référentiel source pour le code et les flux de travail pertinents est créé CI/CD .
1. (Facultatif) Par défaut, Amazon Q crée également des problèmes liés aux exigences qui ne sont pas satisfaites par un plan. Vous pouvez choisir les éléments pour lesquels vous ne souhaitez pas créer de problèmes. Après avoir choisi de laisser Amazon Q créer des problèmes, vous pouvez également attribuer un problème à Amazon Q. Il analysera le problème dans le contexte des référentiels sources donnés, en fournissant un résumé des fichiers sources et du code pertinents. Pour plus d’informations, consultez [Créez un problème et attribuez-le à Amazon Q](#getting-started-project-assistance-issue-to-code) et [Bonnes pratiques lors de la création et du traitement des problèmes assignés à Amazon Q](issues-create-issue.md#issues-create-issue-assign-genai-best-practices).
## Créez un résumé des modifications de code entre les branches lors de la création d'une pull request
Une pull request est le principal moyen pour vous et les autres membres du projet de consulter, commenter et fusionner les modifications de code d'une branche à l'autre. Vous pouvez utiliser des pull requests pour examiner les modifications de code de manière collaborative afin de détecter des modifications ou des correctifs mineurs, des ajouts de fonctionnalités majeures ou de nouvelles versions de vos logiciels publiés. Le résumé des modifications du code et de l'intention qui sous-tend ces modifications dans le cadre de la description de la pull request est utile aux personnes qui examineront le code, et permet également de comprendre l'historique des modifications apportées au code au fil du temps. Cependant, les développeurs s'appuient souvent sur leur code pour s'expliquer ou pour fournir des détails ambigus plutôt que de décrire leurs modifications avec suffisamment de détails pour que les réviseurs puissent comprendre ce qu'ils examinent ou quelle était l'intention qui sous-tend les modifications apportées au code.
Vous pouvez utiliser la fonctionnalité **Write description for me** lorsque vous créez des pull requests pour qu'Amazon Q crée une description des modifications contenues dans une pull request. Lorsque vous choisissez cette option, Amazon Q analyse les différences entre la branche source contenant les modifications de code et la branche de destination dans laquelle vous souhaitez fusionner ces modifications. Il crée ensuite un résumé de ces modifications, ainsi que sa meilleure interprétation de l'intention et de l'effet de ces modifications.
**Note**
Cette fonctionnalité ne fonctionne pas avec les sous-modules Git. Il ne résumera aucune modification apportée à un sous-module Git inclus dans la pull request.
Cette fonctionnalité n'est pas disponible pour les pull requests dans les référentiels liés.
Vous pouvez essayer cette fonctionnalité avec n'importe quelle pull request que vous créez, mais dans ce didacticiel, nous allons la tester en apportant quelques modifications simples au code contenu dans un projet créé dans un plan d'application **Web moderne à trois niveaux** basé sur Python.
**Astuce**
Si vous utilisez un projet créé avec un plan différent ou votre propre code, vous pouvez toujours suivre ce didacticiel, mais les exemples de ce didacticiel ne correspondront pas au code de votre projet. Au lieu de suivre l'exemple suggéré ci-dessous, apportez de simples modifications au code de votre projet dans une branche, puis créez une pull request pour tester la fonctionnalité, comme indiqué dans les étapes suivantes.
Tout d'abord, vous allez créer une branche dans le référentiel source. Vous allez ensuite modifier rapidement le code d'un fichier de cette branche à l'aide de l'éditeur de texte de la console. Vous allez ensuite créer une pull request et utiliser la fonctionnalité **Rédiger une description pour moi pour** résumer les modifications que vous avez apportées.
**Pour créer une branche (console)**
1. Dans la CodeCatalyst console, accédez au projet dans lequel se trouve votre référentiel source.
1. Choisissez le nom du référentiel dans la liste des référentiels sources du projet. Dans le volet de navigation, vous pouvez également choisir **Code**, puis **Référentiels sources**.
1. Choisissez le référentiel dans lequel vous souhaitez créer une branche.
1. Sur la page d'aperçu du référentiel, choisissez **Plus**, puis sélectionnez **Créer une branche**.
1. Entrez le nom de la branche.
1. Choisissez une branche à partir de laquelle créer la branche, puis choisissez **Create**.
Une fois que vous avez une branche, modifiez un fichier dans cette branche par une simple modification. Dans cet exemple, vous allez modifier le `test_endpoint.py` fichier pour faire passer le nombre de tentatives de test **3** à **5**.
**Astuce**
Vous pouvez également choisir de créer ou d'utiliser un environnement de développement pour effectuer cette modification de code. Pour de plus amples informations, veuillez consulter [Création d’un environnement de développement](devenvironment-create.md).
**Pour modifier le `test_endpoint.py` fichier dans la console**
1. Sur la page d'aperçu du référentiel **mysfits** source, choisissez la liste déroulante des branches et choisissez la branche que vous avez créée lors de la procédure précédente.
1. Dans **Fichiers**, accédez au fichier que vous souhaitez modifier. Par exemple, pour modifier le `test_endpoint.py` fichier, développez **les tests**, **développez l'entier**, puis choisissez`test_endpoint.py`.
1. Choisissez **Modifier**.
1. À la ligne 7, modifiez le nombre de fois où tous les tests seront réessayés :
```
def test_list_all(retry=3):
```
par :
```
def test_list_all(retry=5):
```
1. Choisissez **Commit** et validez vos modifications dans votre branche.
Maintenant que vous avez une branche modifiée, vous pouvez créer une pull request.
**Créez une pull request avec un résumé des modifications**
1. Sur la page de présentation du référentiel, choisissez **Plus**, puis **Create pull request**.
1. Dans **Branche de destination**, choisissez la branche dans laquelle vous souhaitez fusionner le code une fois celui-ci révisé.
**Astuce**
Choisissez la branche à partir de laquelle vous avez créé votre branche dans la procédure précédente pour une démonstration la plus simple de cette fonctionnalité. Par exemple, si vous avez créé votre branche à partir de la branche par défaut du dépôt, choisissez cette branche comme branche de destination pour votre pull request.
1. Dans **Branche source**, choisissez la branche qui contient les modifications que vous venez de valider dans le `test_endpoint.py` fichier.
1. Dans **Titre de la demande d'extraction**, entrez un titre qui aide les autres utilisateurs à comprendre ce qui doit être revu et pourquoi.
1. Dans **Description de la pull request**, choisissez **Write description for me pour** qu'Amazon Q crée une description des modifications contenues dans la pull request.
1. Un résumé des modifications s'affiche. Passez en revue le texte suggéré, puis choisissez **Accepter et ajouter à la description**.
1. Modifiez éventuellement le résumé pour mieux refléter les modifications que vous avez apportées au code. Vous pouvez également choisir d'ajouter des réviseurs ou de lier des problèmes à cette pull request. Lorsque vous avez terminé d'apporter les modifications supplémentaires souhaitées, choisissez **Créer**.
## Créez un résumé des commentaires laissés sur les modifications de code dans une pull request
Lorsque les utilisateurs examinent une pull request, ils laissent souvent plusieurs commentaires sur les modifications apportées à cette pull request. S'il y a beaucoup de commentaires de la part de nombreux réviseurs, il peut être difficile de sélectionner des thèmes communs dans les commentaires, ou même de s'assurer que vous avez examiné tous les commentaires dans toutes les révisions. Vous pouvez utiliser la fonctionnalité **Créer un résumé des commentaires** pour qu'Amazon Q analyse tous les commentaires laissés sur les modifications de code dans une pull request et crée un résumé de ces commentaires.
**Note**
Les résumés des commentaires sont éphémères. Si vous actualisez une pull request, le résumé disparaît. Les résumés de contenu n'incluent pas de commentaires sur l'ensemble de la pull request, mais uniquement des commentaires laissés sur les différences de code dans les révisions de la pull request.
Cette fonctionnalité ne fonctionne pas avec les commentaires laissés sur les modifications de code dans les sous-modules Git.
Cette fonctionnalité n'est pas disponible pour les pull requests dans les référentiels liés.
**Pour créer un résumé des commentaires dans une pull request**
1. Accédez à la pull request que vous avez créée lors de la procédure précédente.
**Astuce**
Si vous préférez, vous pouvez utiliser n'importe quelle pull request ouverte dans votre projet. Dans la barre de navigation, choisissez **Code**, choisissez **Pull requests** et choisissez n'importe quelle pull request ouverte.
1. Ajoutez quelques commentaires à la pull request dans **Changes** si la pull request ne contient pas déjà de commentaires.
1. Dans **Vue d'ensemble**, choisissez **Créer un résumé des commentaires**. Une fois terminée, la section **Récapitulatif des commentaires** s'agrandit.
1. Consultez le résumé des commentaires laissés sur les modifications du code dans les révisions de la pull request, et comparez-le aux commentaires de la pull request.
## Créez un problème et attribuez-le à Amazon Q
Les équipes de développement créent des problèmes pour suivre et gérer leur travail, mais il arrive qu'un problème persiste, soit parce que l'on ne sait pas exactement qui doit y travailler, soit parce qu'il nécessite des recherches sur une partie particulière de la base de code, soit parce qu'il faut d'abord s'occuper d'autres tâches urgentes. CodeCatalyst inclut l'intégration avec Amazon Q Developer Agent pour le développement de logiciels. Vous pouvez attribuer des problèmes à un assistant d'intelligence artificielle génératif appelé **Amazon Q** qui peut analyser un problème en fonction de son titre et de sa description. Si vous attribuez le problème à Amazon Q, celui-ci tentera de créer un projet de solution que vous pourrez évaluer. Cela peut vous aider, vous et votre équipe, à vous concentrer et à optimiser votre travail sur les problèmes qui nécessitent votre attention, tandis qu'Amazon Q travaille sur une solution aux problèmes que vous ne disposez pas des ressources nécessaires pour résoudre immédiatement.
**Astuce**
**Amazon Q est** le plus performant pour résoudre les problèmes simples et directs. Pour de meilleurs résultats, utilisez un langage simple pour expliquer clairement ce que vous voulez faire.
Lorsque vous attribuez un problème à **Amazon Q**, CodeCatalyst celui-ci est marqué comme bloqué jusqu'à ce que vous confirmiez la manière dont vous souhaitez qu'Amazon Q le traite. Vous devez répondre à trois questions avant de pouvoir continuer :
+ Que vous souhaitiez confirmer chaque étape ou que vous souhaitiez qu'elle se poursuive sans commentaires. Si vous choisissez de confirmer chaque étape, vous pouvez répondre à Amazon Q avec des commentaires sur l'approche créée afin qu'il puisse répéter son approche si nécessaire. Amazon Q peut également consulter les commentaires des utilisateurs sur toute pull request qu'il crée si vous choisissez cette option. Si vous choisissez de ne pas confirmer chaque étape, Amazon Q peut terminer son travail plus rapidement, mais il ne prendra pas en compte les commentaires que vous lui ferez dans le cadre du problème ou des pull request qu'il crée.
+ Si vous souhaitez l'autoriser à mettre à jour les fichiers de flux de travail dans le cadre de son travail. Les flux de travail de votre projet sont peut-être configurés pour démarrer des exécutions lors d'événements de pull request. Dans ce cas, toute pull request créée par Amazon Q qui inclut la création ou la mise à jour du flux de travail YAML peut démarrer une exécution des flux de travail inclus dans la pull request. Il est recommandé de ne pas autoriser Amazon Q à travailler sur des fichiers de flux de travail, sauf si vous êtes certain qu'aucun flux de travail de votre projet n'exécutera automatiquement ces flux de travail avant de consulter et d'approuver la pull request qu'il crée.
+ Si vous souhaitez l'autoriser à suggérer la création de tâches pour décomposer le travail lié au problème en tranches plus petites qui peuvent être attribuées individuellement aux utilisateurs, y compris Amazon Q lui-même. Permettre à Amazon Q de suggérer et de créer des tâches peut contribuer à accélérer le développement de problèmes complexes en permettant à plusieurs personnes de travailler sur des parties distinctes du problème. Cela peut également aider à réduire la complexité de la compréhension de l'ensemble du travail, car le travail nécessaire pour accomplir chaque tâche est idéalement plus simple que le problème auquel elle appartient.
+ Dans quel référentiel source souhaitez-vous qu'il fonctionne. Même si votre projet possède plusieurs référentiels de sources, Amazon Q ne peut travailler que sur le code d'un seul référentiel de sources. Les référentiels liés ne sont pas pris en charge.
Une fois que vous avez fait et confirmé vos choix, **Amazon Q** place le problème dans l'état **En cours** pendant qu'il tente de déterminer la nature de la demande en fonction du titre du problème et de sa description, ainsi que du code contenu dans le référentiel spécifié. Il créera un commentaire épinglé dans lequel il fournira des mises à jour sur l'état de ses travaux. Après avoir examiné les données, Amazon Q formulera une approche potentielle pour trouver une solution. Amazon Q enregistre ses actions en mettant à jour son commentaire épinglé et en commentant l'évolution du problème à chaque étape. Contrairement aux commentaires et réponses épinglés, il ne conserve pas une trace strictement chronologique de ses travaux. Il place plutôt les informations les plus pertinentes sur son travail au niveau supérieur du commentaire épinglé. Il tentera de créer du code en fonction de son approche et de son analyse du code déjà présent dans le référentiel. S'il parvient à générer une solution potentielle, il créera une branche et validera le code à cette branche. Il crée ensuite une pull request qui fusionnera cette branche avec la branche par défaut. Lorsque Amazon Q a terminé son travail, il place le problème **dans En cours de révision** afin que vous et votre équipe sachiez qu'un code est prêt à être évalué.
**Note**
Cette fonctionnalité est uniquement disponible via **Issues** in the USA West (Oregon) Region. Il n'est pas disponible si vous avez configuré votre projet pour utiliser Jira avec l'extension **Jira Software**. De plus, si vous avez personnalisé la mise en page de votre tableau, il est possible que le problème ne change pas d'état. Pour de meilleurs résultats, n'utilisez cette fonctionnalité qu'avec des projets dotés d'une disposition de tableau standard.
Cette fonctionnalité ne fonctionne pas avec les sous-modules Git. Il ne peut pas modifier les sous-modules Git inclus dans le dépôt.
Une fois que vous avez attribué un problème à Amazon Q, vous ne pouvez pas modifier le titre ou la description du problème, ni l'attribuer à quelqu'un d'autre. Si vous annulez l'attribution du problème à **Amazon Q**, celui-ci terminera l'étape en cours, puis cessera de fonctionner. Il ne peut pas reprendre le travail ni être réaffecté au problème une fois qu'il a été annulé.
Un problème peut être automatiquement déplacé dans la colonne **En cours d'examen** s'il est attribué à Amazon Q si un utilisateur choisit de l'autoriser à créer des tâches. Cependant, le problème dans **En cours de révision** peut toujours comporter des tâches dans un état différent, par exemple dans l'état **En cours**.
Dans cette partie du didacticiel, vous allez créer trois problèmes basés sur les fonctionnalités potentielles du code inclus dans les projets créés avec le modèle d'**application Web moderne à trois niveaux** : un pour ajouter un pour créer une nouvelle créature Mysfit, un pour ajouter une fonctionnalité de tri et un pour mettre à jour un flux de travail afin d'inclure une branche nommée. **test**
**Note**
Si vous travaillez sur un projet avec un code différent, créez des problèmes avec les titres et les descriptions liés à cette base de code.
**Pour créer un problème et obtenir une solution à évaluer**
1. Dans le volet de navigation, choisissez **Problèmes** et assurez-vous que vous êtes dans la vue **Tableau**.
1. Choisissez **Créer un problème**.
1. Donnez au numéro un titre qui explique ce que vous voulez faire dans un langage simple. Par exemple, pour ce numéro, entrez le titre de**Create another mysfit named Quokkapus**. Dans **Description**, fournissez les informations suivantes :
```
Expand the table of mysfits to 13, and give the new mysfit the following characteristics:
Name: Quokkapus
Species: Quokka-Octopus hybrid
Good/Evil: Good
Lawful/Chaotic: Chaotic
Age: 216
Description: Australia is full of amazing marsupials, but there's nothing there quite like the Quokkapus.
She's always got a friendly smile on her face, especially when she's using her eight limbs to wrap you up
in a great big hug. She exists on a diet of code bugs and caffeine. If you've got some gnarly code that needsa
assistance, adopt Quokkapus and put her to work - she'll love it! Just make sure you leave enough room for
her to grow, and keep that coffee coming.
```
1. (Facultatif) Joignez une image à utiliser comme miniature et photo de profil pour le MysFit to the Issue. Dans ce cas, mettez à jour la description pour inclure des détails sur les images que vous souhaitez utiliser et pourquoi. Par exemple, vous pouvez ajouter ce qui suit à la description : « Le Mysfit nécessite le déploiement de fichiers image sur le site Web. Ajoutez ces images jointes à ce numéro au référentiel source dans le cadre du travail, et déployez-les sur le site Web. »
**Note**
Les images jointes peuvent ou non être déployées sur le site Web lors des interactions de ce didacticiel. Vous pouvez ajouter vous-même les images au site Web, puis laisser des commentaires pour qu'Amazon Q mette à jour son code afin qu'il pointe vers les images que vous souhaitez qu'il utilise après avoir créé une pull request.
Passez en revue la description et assurez-vous qu'elle contient tous les détails nécessaires avant de passer à l'étape suivante.
1. Dans **Destinataires**, choisissez **Attribuer à Amazon Q.**
1. Dans **Référentiel source**, choisissez le référentiel source qui contient le code du projet.
1. Faites glisser le **bouton Require Amazon Q pour qu'il s'arrête après chaque étape et attendez que son sélecteur de travail** passe à l'état actif si nécessaire.
**Note**
Choisir l'option d'arrêt d'Amazon Q après chaque étape vous permet de commenter le problème ou les tâches créées. Vous avez ainsi la possibilité de demander à Amazon Q de modifier son approche jusqu'à trois fois en fonction de vos commentaires. Si vous choisissez de ne pas arrêter Amazon Q après chaque étape afin de pouvoir passer en revue son travail, le travail progressera peut-être plus rapidement car Amazon Q n'attend pas vos commentaires, mais vous ne serez pas en mesure d'influencer l'orientation d'Amazon Q en laissant des commentaires. Amazon Q ne répondra pas non plus aux commentaires laissés dans une pull request si vous choisissez cette option.
1. Laissez le sélecteur **Autoriser Amazon Q à modifier les fichiers de flux** de travail à l'état inactif.
1. Faites glisser le sélecteur **Autoriser Amazon Q pour suggérer la création de tâches** sur l'état actif.
1. Choisissez **Créer un problème**. Votre point de vue change sur le tableau des problèmes.
1. Choisissez **Créer un numéro** pour créer un autre numéro, cette fois avec le titre**Change the get\$1all\$1mysfits() API to return mysfits sorted by the Age attribute**. Attribuez ce problème à **Amazon Q** et créez-le.
1. Choisissez **Créer un numéro** pour créer un autre numéro, cette fois avec le titre**Update the OnPullRequest workflow to include a branch named test in its triggers**. Vous pouvez éventuellement créer un lien vers le flux de travail dans la description. Attribuez ce problème à **Amazon Q**, mais assurez-vous cette fois que le sélecteur **Autoriser Amazon Q à modifier les fichiers de flux** de travail est défini sur l'état actif. Créez le problème pour revenir au tableau des problèmes.
**Astuce**
Vous pouvez rechercher des fichiers, y compris des fichiers de flux de travail, en saisissant le symbole arobase (`@`) et en saisissant le nom du fichier.
Une fois que vous avez créé et attribué les problèmes, ils seront placés dans **En cours**. Amazon Q ajoutera des commentaires permettant de suivre l'évolution du problème dans un commentaire épinglé. S'il est en mesure de définir une approche pour une solution, il mettra à jour la description du problème avec une section **Contexte** contenant son analyse de la base de code et une section **Approche** détaillant l'approche proposée pour créer une solution. Si Amazon Q parvient à trouver une solution au problème décrit dans le problème, il créera une branche et modifiera le code dans cette branche afin de mettre en œuvre la solution proposée. Si le code proposé présente des similitudes avec le code source ouvert dont Amazon Q a connaissance, il fournira un fichier contenant des liens vers ce code afin que vous puissiez le consulter. Une fois que le code est prêt, il crée une pull request afin que vous puissiez consulter les modifications de code suggérées, ajoute un lien vers cette pull request au problème et place le problème dans **En révision**.
**Important**
Vous devez toujours examiner les modifications de code dans une pull request avant de la fusionner. Les modifications de code de fusion effectuées par Amazon Q, comme toute autre modification de code, peuvent avoir un impact négatif sur votre code de base et votre code d'infrastructure si le code fusionné n'est pas correctement examiné et contient des erreurs lors de la fusion.
**Pour examiner un problème et une pull request associée contenant des modifications apportées par Amazon Q**
1. Dans **Problèmes**, choisissez un problème en **cours attribué à** Amazon Q. Consultez les commentaires pour suivre l'évolution d'Amazon Q. Si c'est le cas, examinez le contexte et abordez les informations enregistrées dans la description du problème. Si vous avez choisi d'autoriser Amazon Q à suggérer des tâches, passez en revue les tâches proposées et prenez les mesures nécessaires. Par exemple, si Amazon Q suggère des tâches et que vous souhaitez modifier l'ordre ou attribuer des tâches à des utilisateurs spécifiques, choisissez **Modifier, ajouter ou réorganiser les tâches** et effectuez les mises à jour nécessaires. Lorsque vous avez fini de consulter le problème, choisissez **X** pour fermer le volet des problèmes.
**Astuce**
Pour voir l'avancement des tâches, choisissez la tâche dans la liste des tâches du numéro. Les tâches n'apparaissent pas séparément sur le tableau et ne sont accessibles qu'en cas de problème. Si une tâche est affectée à Amazon Q, vous devez ouvrir la tâche pour approuver les actions qu'elle souhaite effectuer. Vous devez également ouvrir une tâche pour voir les pull requests associées, car elles n'apparaîtront pas sous forme de liens dans le numéro, mais uniquement dans la tâche. Pour revenir à un problème à partir d'une tâche, cliquez sur le lien vers le problème.
1. Choisissez maintenant un problème attribué à Amazon Q qui est **en cours de révision**. Passez en revue le contexte et abordez l'approche qu'il enregistre dans la description du problème. Passez en revue les commentaires pour comprendre les actions qu'il a effectuées. Passez en revue toutes les tâches créées pour le travail lié à ce problème, y compris leur progression, les mesures que vous pourriez avoir à prendre et les commentaires éventuels. Dans **Pull requests**, choisissez le lien vers la pull request à côté de l'étiquette **Open** pour vérifier le code.
**Astuce**
Les pull requests générées pour les tâches apparaissent uniquement sous forme de pull requests liées dans la vue des tâches. Elles n'apparaissent pas sous forme de pull requests liées au problème.
1. Dans la pull request, passez en revue les modifications apportées au code. Pour de plus amples informations, veuillez consulter [Révision d’une demande pull](pull-requests-review.md). Laissez des commentaires sur la pull request si vous souhaitez qu'Amazon Q modifie l'un des codes suggérés. Soyez précis lorsque vous laissez des commentaires pour Amazon Q pour de meilleurs résultats.
Par exemple, lorsque vous examinez la pull request créée pour**Create another mysfit named Quokkapus**, vous remarquerez peut-être une faute de frappe dans la description. Vous pouvez laisser un commentaire pour Amazon Q indiquant « Modifiez la description pour corriger la faute de frappe « needsa » en ajoutant un espace entre « needs » et « a » ». Vous pouvez également laisser un commentaire demandant à Amazon Q de mettre à jour la description et de fournir l'intégralité de la description révisée afin qu'elle soit incorporée.
Si vous avez chargé des images du nouveau Mysfit sur le site Web, vous pouvez laisser un commentaire pour qu'Amazon Q mette à jour le Mysfit avec des pointeurs vers l'image et la miniature à utiliser pour le nouveau Mysfit.
**Note**
Amazon Q ne répondra pas aux commentaires individuels. Amazon Q n'intégrera les commentaires laissés dans les commentaires des pull requests que si vous avez choisi l'option par défaut qui consiste à arrêter après chaque étape d'approbation lors de la création du problème.
1. (Facultatif) Une fois que vous et les autres utilisateurs du projet avez laissé tous les commentaires souhaités concernant les modifications du code, choisissez **Create revision** pour qu'Amazon Q crée une révision de la pull request qui intègre les modifications que vous avez demandées dans les commentaires. La progression de la création de révisions sera signalée par Amazon Q dans la section **Vue d'ensemble**, et non dans la section **Modifications**. Assurez-vous d'actualiser votre navigateur pour consulter les dernières mises à jour d'Amazon Q concernant la création de la révision.
**Note**
Seul l'utilisateur qui a créé le problème peut créer une révision de la pull request. Vous ne pouvez demander qu'une seule révision d'une pull request. Assurez-vous d'avoir résolu tous les problèmes liés aux commentaires et d'être satisfait du contenu des commentaires avant de choisir **Créer une révision**.
1. Un flux de travail est exécuté pour chaque pull request dans cet exemple de projet. Assurez-vous qu'un flux de travail s'exécute correctement avant de fusionner la pull request. Vous pouvez également choisir de créer des flux de travail et des environnements supplémentaires pour tester le code avant de le fusionner. Pour de plus amples informations, veuillez consulter [Commencer à utiliser les flux de travail](workflows-getting-started.md).
1. Lorsque vous êtes satisfait de la dernière révision de la pull request, choisissez **Merge**.
## Créez un problème et demandez à Amazon Q de vous recommander des tâches à ce sujet
Un problème peut parfois nécessiter une charge de travail complexe ou longue. CodeCatalyst inclut l'intégration avec Amazon Q Developer Agent pour le développement de logiciels. Vous pouvez demander à **Amazon Q** d'analyser un problème en fonction de son titre et de sa description, et de recommander une répartition logique du travail en tâches distinctes. Il tentera de créer une liste de tâches recommandées qui pourra ensuite être revue, modifiée et choisir de créer ou non. Cela peut vous aider, vous et votre équipe, à attribuer des parties individuelles du travail aux utilisateurs de manière plus facile à gérer et à réaliser plus rapidement.
**Pour créer et consulter une liste de tâches recommandées pour un problème**
1. Dans le volet de navigation, choisissez **Problèmes** et assurez-vous que vous êtes dans la vue **Tableau**.
1. Choisissez **Créer un problème**.
1. Donnez au numéro un titre qui explique ce que vous voulez faire dans un langage simple. Par exemple, pour ce numéro, entrez le titre de**Change the get\$1all\$1mysfits() API to return mysfits sorted by the Good/Evil attribute**. Dans **Description**, fournissez les informations suivantes :
```
Update the API to allow sorting of mysfits by whether they are Good, Neutral, or Evil. Add a button on the website that allows users to quickly choose this sort and to exclude alignments that they don't want to see.
```
1. Passez en revue la description et assurez-vous qu'elle contient tous les détails nécessaires avant de passer à l'étape suivante.
1. Dans **Personnes assignées**, choisissez de vous attribuer le problème.
1. Choisissez **Créer un problème**. Votre point de vue change sur le tableau des problèmes.
1. Choisissez le numéro que vous venez de créer pour l'ouvrir. Choisissez **Recommander des tâches**.
1. Choisissez le référentiel source qui contient le code du problème. Choisissez **Commencer à recommander des tâches.**
La boîte de dialogue se ferme et Amazon Q commence à analyser la complexité du problème. Si le problème est complexe, il suggère de diviser le travail en tâches distinctes et séquentielles. Lorsque la liste est prête, choisissez **Afficher les tâches recommandées**. Vous pouvez ajouter des tâches supplémentaires, modifier les tâches recommandées et réorganiser les tâches. Si vous êtes d'accord avec les recommandations, choisissez **Créer des tâches** pour créer les tâches. Vous pouvez ensuite attribuer ces tâches aux utilisateurs pour qu'ils y travaillent, ou même à Amazon Q lui-même.
## nettoyer des ressources ;
Une fois ce didacticiel terminé, envisagez de prendre les mesures suivantes pour nettoyer les ressources que vous avez créées pendant ce didacticiel et dont vous n'avez plus besoin.
+ Annulez l'attribution à Amazon Q de tous les problèmes qui ne sont plus résolus. Si Amazon Q a terminé de résoudre un problème ou n'a pas trouvé de solution, veillez à annuler l'attribution d'Amazon Q afin d'éviter d'atteindre le quota maximum pour les fonctionnalités d'IA génératives. Pour plus d'informations, consultez [Gestion des fonctionnalités d'IA générative](https://docs.aws.amazon.com/codecatalyst/latest/adminguide/managing-generative-ai-features.html) et [tarification](https://codecatalyst.aws/explore/pricing).
+ Déplacez tous les problèmes pour lesquels le travail est terminé vers **Terminé**.
+ Si le projet n'est plus nécessaire, supprimez-le.