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.

Prérequis

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, consultezConfigurer et se connecter à CodeCatalyst.

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.

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

3. Choisissez Commencer à zéro.

4. Sous Donnez un nom à votre projet, entrez le nom que vous souhaitez attribuer à votre projet. Le nom doit être unique dans votre espace.

5. 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 plus d’informations, consultez Lier un référentiel source.

Pour créer un référentiel source

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

2. Accédez à votre projet.

3. Dans le volet de navigation, choisissez Code, puis sélectionnez Référentiels sources.

4. Choisissez Ajouter un référentiel, puis sélectionnez Créer un référentiel.

5. 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, consultezQuotas pour les référentiels sources dans CodeCatalyst.

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

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

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

9. (Facultatif) Ajoutez un .gitignore fichier correspondant au type de code que vous souhaitez envoyer.

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

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

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

7. Ajoutez éventuellement un alias pour l'environnement de développement.

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

9. 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 affichera 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 travail dans CodeCatalyst.

Suivez les instructions Commencer à utiliser les flux de travail 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.

2. Dans le volet de navigation, sélectionnez Paramètres du projet.

3. Dans l'onglet Membres, choisissez Inviter.

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

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

   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.

2. Dans le volet de navigation, choisissez Track, puis Backlog.

3. Choisissez Créer un problème.

4. 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 plus d’informations, consultez Tutoriel : Utiliser les fonctionnalités CodeCatalyst génératives de l'IA pour accélérer votre travail de développement.

   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.

5. 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 plus d'informations, voir Suivez et organisez le travail en cas de problèmes dans CodeCatalyst.