Commencer à utiliser les référentiels CodeCatalyst sources et le plan de l' Single-page application

Pour créer un projet avec un plan

1. Dans la CodeCatalyst console, accédez à l'espace dans lequel vous souhaitez créer un projet.

2. Sur le tableau de bord de l'espace, choisissez Créer un projet.

3. Choisissez Commencer par un plan.

   Astuce

   Vous pouvez choisir d'ajouter un plan en indiquant à Amazon Q les exigences de votre projet pour qu'Amazon Q vous suggère un plan. Pour plus d’informations, consultez Utiliser Amazon Q pour choisir un plan lors de la création d'un projet ou de l'ajout de fonctionnalités et Meilleures pratiques lors de l'utilisation d'Amazon Q pour créer des projets ou ajouter des fonctionnalités à l'aide de plans. Cette fonctionnalité n'est disponible que dans la région Ouest des États-Unis (Oregon).

   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 génératives d'IA.

4. Dans l'onglet CodeCatalyst Plans ou Plans spatiaux, choisissez un plan, puis choisissez Suivant.

5. Dans Nommez votre projet, entrez le nom que vous souhaitez attribuer à votre projet et les noms des ressources associées. Le nom doit être unique dans votre espace.

6. (Facultatif) Par défaut, le code source créé par le Blueprint est stocké dans un CodeCatalyst référentiel. Vous pouvez également choisir de stocker le code source du plan dans un référentiel tiers. Pour de plus amples informations, veuillez consulter Ajoutez des fonctionnalités aux projets avec des extensions dans CodeCatalyst.

   Important

   CodeCatalyst ne prend pas en charge la détection de modifications dans la branche par défaut pour les référentiels liés. Pour modifier la branche par défaut d'un référentiel lié, vous devez d'abord le dissocier CodeCatalyst, modifier la branche par défaut, puis la lier à nouveau. Pour de plus amples informations, veuillez consulter Lier GitHub des référentiels, des référentiels Bitbucket, des référentiels de GitLab projets et des projets Jira dans CodeCatalyst.

   Il est recommandé de toujours disposer de la dernière version de l'extension avant de lier un référentiel.

   Effectuez l'une des opérations suivantes en fonction du fournisseur de référentiel tiers que vous souhaitez utiliser :

   • GitHub référentiels  : connectez un GitHub compte.

     Choisissez le menu déroulant Avancé, choisissez GitHub comme fournisseur de référentiel, puis choisissez le GitHub compte dans lequel vous souhaitez stocker le code source créé par le Blueprint.

     Note

     Si vous connectez un GitHub compte, vous devez créer une connexion personnelle pour établir un mappage d'identité entre votre CodeCatalyst identité et la GitHub vôtre. Pour plus d’informations, consultez Connexions personnelles et Accès à GitHub des ressources grâce à des liens personnels.

   • Référentiels Bitbucket  : connectez un espace de travail Bitbucket.

     Choisissez le menu déroulant Avancé, choisissez Bitbucket comme fournisseur de référentiel, puis choisissez l'espace de travail Bitbucket dans lequel vous souhaitez stocker le code source créé par le Blueprint.

   • GitLab référentiels  : connectez un GitLab utilisateur.

     Choisissez le menu déroulant Avancé, choisissez GitLab comme fournisseur de référentiel, puis choisissez l' GitLab utilisateur dans lequel vous souhaitez stocker le code source créé par le Blueprint.

7. Sous Ressources du projet, configurez les paramètres du plan. Selon le plan, vous pouvez avoir la possibilité de nommer le nom du référentiel source.

8. (Facultatif) Pour afficher les fichiers de définition avec des mises à jour en fonction des paramètres de projet que vous avez sélectionnés, choisissez Afficher le code ou Afficher le flux de travail dans Générer un aperçu du projet.

9. (Facultatif) Choisissez Afficher les détails dans la fiche du plan pour afficher des détails spécifiques sur le plan, tels qu'un aperçu de l'architecture du plan, des connexions et des autorisations requises, ainsi que le type de ressources que le plan crée.

10. Sélectionnez Create a project (Créer un projet).

Pour accéder aux référentiels sources d'un projet

1. Accédez à votre projet et effectuez l'une des opérations suivantes :

   • Sur la page de résumé de votre projet, choisissez le référentiel de votre choix dans la liste, puis choisissez Afficher le référentiel.

   • Dans le volet de navigation, choisissez Code, puis choisissez 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.

2. Sur la page d'accueil du référentiel, consultez le contenu du référentiel et des informations sur les ressources associées, telles que le nombre de demandes d'extraction 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.

Pour créer un environnement de développement avec une nouvelle branche

1. Ouvrez la CodeCatalyst console à l'adresse https://codecatalyst.aws/.

2. Accédez au projet dans lequel vous souhaitez créer un environnement de développement.

3. Choisissez le nom du référentiel dans la liste des référentiels sources du projet. Sinon, dans le volet de navigation, choisissez Code, choisissez Dépôts sources, puis choisissez le référentiel pour lequel vous souhaitez créer un environnement de développement.

4. Sur la page d'accueil du référentiel, choisissez Create Dev Environment.

5. 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.

6. Choisissez le référentiel à cloner, choisissez Travailler dans une nouvelle branche, entrez un nom de 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 à partir du menu déroulant.

7. Vous pouvez éventuellement ajouter un alias pour l'environnement de développement.

8. Vous pouvez également cliquer sur le bouton Modifier 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.

9. Choisissez Créer. Pendant la création de votre environnement de développement, la colonne d'état de l'environnement de développement affiche Démarrage, et la colonne d'état affiche Exécution une fois l'environnement de développement créé. Un nouvel onglet s'ouvrira avec votre environnement de développement dans l'IDE de votre choix. Vous pouvez modifier le code, valider et appliquer vos modifications.

Pour effectuer et appliquer une modification à partir d'un AWS Cloud9 Environnement de développement

1. Dans AWS Cloud9, développez le menu de navigation latéral pour parcourir les fichiers. srcDéveloppez et ouvrezApp.tsx.

2. Modifiez le texte à l'intérieur des <p> balises.

3. Enregistrez le fichier, puis validez et transférez vos modifications à l'aide du menu Git. Sinon, dans la fenêtre du terminal, validez et envoyez vos modifications à l'aide git commit des git push commandes et.

   git commit -am "Making an example change"
   git push

   Astuce

   Vous devrez peut-être remplacer les répertoires du terminal par le répertoire du référentiel Git avant de pouvoir exécuter correctement les commandes Git.

Pour créer une demande d’extraction

1. Accédez à votre projet.

2. Effectuez l’une des actions suivantes :

   • Dans le volet de navigation, choisissez Code, choisissez Pull requests, puis choisissez Create pull request.

   • Sur la page d'accueil du référentiel, choisissez Plus, puis choisissez Créer une demande d'extraction.

   • Sur la page du projet, choisissez Create pull request.

3. Dans 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 référentiel.

4. Dans Branche de destination, choisissez la branche dans laquelle fusionner le code après l'avoir révisé.

5. Dans Branche source, choisissez la branche qui contient le code validé.

6. Dans Titre de la demande d'extraction, saisissez un titre qui aide les autres utilisateurs à comprendre ce qui doit être révisé et pourquoi.

7. (Facultatif) Dans la description de la demande Pull, fournissez des informations telles qu'un lien vers les problèmes ou une description de vos modifications.

   Astuce

   Vous pouvez choisir Écrire une description pour que je génère 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ératives soient activées pour l'espace et n'est pas disponible pour les demandes d'extraction dans les référentiels liés. Pour plus d'informations, consultez la section Gestion des fonctionnalités génératives d'IA.

8. (Facultatif) Dans Problèmes, choisissez Lier les problèmes, puis choisissez un problème dans la liste ou entrez son identifiant. Pour dissocier un problème, cliquez sur l'icône de dissociation.

9. (Facultatif) Dans Réviseurs obligatoires, choisissez 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 de réviseur à la fois en tant que réviseur obligatoire et en tant que réviseur facultatif. Vous ne pouvez pas vous ajouter en tant que réviseur.

10. (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.

11. Passez en revue les différences entre les branches. La différence affichée dans une pull request réside dans les changements entre la révision de 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 n'est affichée, les branches sont peut-être identiques ou vous avez peut-être choisi la même branche pour la source et la destination.

12. Lorsque vous êtes convaincu que la pull request contient le code et les modifications que vous souhaitez revoir, choisissez Create.

    Note

    Après avoir créé la pull request, vous pouvez ajouter des commentaires. Les commentaires peuvent être ajoutés à la demande d'extraction ou à des lignes individuelles de fichiers, ainsi qu'à la demande d'extraction globale. Vous pouvez ajouter des liens vers des ressources, telles que des fichiers, en utilisant le signe @ suivi du nom du fichier.

Pour fusionner une pull request (console)

1. Dans Pull requests, choisissez la pull request que vous avez créée à l'étape précédente. Dans la pull request, choisissez Fusionner.

2. Choisissez parmi les stratégies de fusion disponibles pour la pull request. Vous pouvez éventuellement sélectionner ou désélectionner l'option permettant de supprimer la branche source après avoir fusionné la pull request, puis choisissez Fusionner. Une fois la fusion terminée, le statut de la demande d'extraction passe à Fusionné et n'apparaît plus dans la vue par défaut des demandes d'extraction. La vue par défaut affiche les pull requests dont le statut est Ouvert. Vous pouvez toujours consulter une pull request fusionnée, mais vous ne pouvez ni l'approuver ni modifier son statut.

   Note

   Si le bouton Fusionner n'est pas actif ou si vous voyez le libellé Non fusionnable, soit le réviseur requis n'a pas encore approuvé la pull request, soit la pull request ne peut pas être fusionnée dans la CodeCatalyst console. Un réviseur qui n'a pas approuvé une demande d'extraction est indiqué par une icône en forme d'horloge dans la section Aperçu de la zone de détails de la demande d'extraction. Si tous les réviseurs requis ont approuvé la pull request mais que le bouton Fusionner n'est toujours pas actif, il se peut qu'il y ait un conflit de fusion ou que vous ayez dépassé le quota de stockage de l'espace. Vous pouvez résoudre les conflits de fusion pour la branche de destination dans un environnement de développement, transférer les modifications, puis fusionner la pull request, ou vous pouvez résoudre les conflits et fusionner localement, puis envoyer le commit contenant la fusion vers CodeCatalyst. Pour plus d'informations, consultez Fusion d'une pull request (Git) et votre documentation Git.

Pour afficher le code déployé

1. Dans Workflows, dansonPushToMainDeployPipeline, développez Exécutions récentes.

   Note

   Il s'agit du nom par défaut du flux de travail pour les projets créés avec le plan d'Single-page application.

2. L'exécution la plus récente est celle lancée par la validation de votre pull request fusionnée dans la main branche et affichera probablement le statut En cours. Choisissez une exécution terminée avec succès dans la liste pour afficher les détails de cette exécution.

3. Choisissez Variables. Copiez la valeur de AppURL. Il s'agit de l'URL de l'application Web monopage déployée. Ouvrez un nouvel onglet de navigateur et collez la valeur pour afficher le code créé et déployé. Laissez l'onglet ouvert.

4. Retournez à la liste des exécutions du flux de travail et attendez que la dernière exécution soit terminée. Lorsque c'est le cas, revenez à l'onglet que vous avez ouvert pour afficher l'application Web et actualisez votre navigateur. Vous devriez voir les modifications que vous avez apportées dans votre pull request fusionnée.