Création d’un projet - Amazon CodeCatalyst
Création d'un projet videCréation d'un projet avec un référentiel tiers liéCréation d'un projet à l'aide d'un planBonnes pratiques lors de l'utilisation d'Amazon Q pour créer des projets ou ajouter des fonctionnalités à l'aide de plansBonnes pratiques pour l'utilisation de plans dans le cadre de projetsAjouter des ressources et des tâches aux projets créés

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.

Création d’un projet

Avec les CodeCatalyst projets, vous pouvez effectuer des tâches de développement avec des flux de travail et des référentiels d'intégration continue/livraison continue (CI/CD) partagés, gérer les ressources, suivre les problèmes et ajouter des utilisateurs.

Avant de créer un projet, vous devez avoir le rôle d'administrateur de l'espace ou d'utilisateur avancé.

Création d'un projet vide dans Amazon CodeCatalyst

Vous pouvez créer un projet vide sans ressources et ajouter manuellement les ressources souhaitées ultérieurement.

Avant de créer un projet, vous devez avoir le rôle d'administrateur de l'espace ou d'utilisateur avancé.

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

Création d'un projet avec un référentiel tiers lié

Vous pouvez conserver le code source de votre projet chez un fournisseur tiers préféré tout en utilisant toutes les CodeCatalyst fonctionnalités telles que les plans, la gestion du cycle de vie, les flux de travail, etc. Pour ce faire, vous pouvez créer un nouveau CodeCatalyst projet lié à un GitHub dépôt, un dépôt Bitbucket ou un dépôt de GitLab projet. Vous pouvez ensuite utiliser votre référentiel source lié dans votre CodeCatalyst projet.

Avant de créer un CodeCatalyst projet, vous devez avoir le rôle d'administrateur de l'espace ou d'utilisateur avancé. Pour plus d’informations, consultez Création d'un espace et Inviter un utilisateur directement dans un espace .

Pour créer un projet CodeCatalyst lié à un référentiel source de votre GitHub compte, vous devez effectuer les trois tâches suivantes :

  1. Installez les GitHub référentiels, les référentiels Bitbucket ou GitLab l'extension de référentiels. Sur un site externe, vous êtes invité à vous connecter et à CodeCatalyst fournir un accès à votre dépôt, ce qui est fait dans le cadre de l'étape suivante.

    Important

    Pour installer les GitHub référentiels, les référentiels Bitbucket ou l'extension de GitLab référentiels dans votre CodeCatalyst espace, vous devez être connecté avec un compte ayant le rôle d'administrateur de l'espace dans l'espace.

  2. Connectez votre GitHub compte ou votre espace de travail Bitbucket, ou votre GitLab utilisateur à CodeCatalyst.

    Important

    Pour connecter votre GitHub compte, votre espace de travail Bitbucket, votre GitLab utilisateur à votre CodeCatalyst espace, vous devez être à la fois l'administrateur de la source tierce et l'administrateur de l' CodeCatalyst espace.

    Important

    Après avoir installé une extension de référentiel, le code de tous les référentiels auxquels vous créez un lien CodeCatalyst sera indexé et stocké. CodeCatalyst Cela rendra le code consultable dans. CodeCatalyst Pour mieux comprendre la protection des données de votre code lorsque vous utilisez des référentiels liés dans CodeCatalyst, consultez la section Protection des données dans le guide de l' CodeCatalyst utilisateur Amazon.

  3. Créez un CodeCatalyst projet lié à votre GitHub dépôt, à votre dépôt Bitbucket ou à votre référentiel de GitLab projets.

    Important

    Bien que vous puissiez lier un GitHub dépôt, un dépôt Bitbucket ou un dépôt de GitLab projet en tant que contributeur, vous ne pouvez dissocier un référentiel tiers qu'en tant qu'administrateur de l'espace ou administrateur du projet. Pour de plus amples informations, veuillez consulter Dissociation GitHub des référentiels, des référentiels Bitbucket, des référentiels de projets et des GitLab projets Jira dans CodeCatalyst.

    Important

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

    Il est recommandé de toujours s'assurer que vous disposez de la dernière version de l'extension avant de lier un dépôt.

    Note

    • Un GitHub dépôt, un dépôt Bitbucket ou un dépôt de GitLab projet ne peut être lié qu'à un seul CodeCatalyst projet dans un espace.

    • Vous ne pouvez pas utiliser de référentiels vides ou archivés, de GitHub référentiels Bitbucket ou de référentiels de projets avec des GitLab projets. CodeCatalyst

    • Vous ne pouvez pas lier un GitHub dépôt, un dépôt Bitbucket ou un dépôt de GitLab projet portant le même nom qu'un dépôt d'un CodeCatalyst projet.

    • L'extension GitHub Repositories n'est pas compatible avec les référentiels GitHub Enterprise Server.

    • L'extension Bitbucket Repositories n'est pas compatible avec les référentiels Bitbucket Data Center.

    • L'extension GitLab Repositories n'est pas compatible avec les référentiels de projets GitLab autogérés.

    • Vous ne pouvez pas utiliser les fonctionnalités Rédiger une description pour moi ou Résumer les commentaires avec des référentiels liés. Ces fonctionnalités ne sont disponibles que dans les pull requests in CodeCatalyst.

Pour de plus amples informations, veuillez consulter Ajoutez des fonctionnalités aux projets avec des extensions dans CodeCatalyst.

Pour installer l'extension tierce

  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 Apportez votre propre code.

  4. Sous Lier le référentiel existant, choisissez GitHub les référentiels, les référentiels Bitbucket, les GitLab référentiels en fonction du fournisseur de référentiel tiers que vous souhaitez utiliser. Vous êtes invité à connecter votre GitHub compte, votre espace de travail Bitbucket ou votre GitLab compte si vous ne l'avez pas déjà fait. Si l'extension tierce de votre choix n'est pas déjà installée, une invite d'installation s'affiche.

  5. Si vous y êtes invité, choisissez Installer. Vérifiez les autorisations requises par l'extension, et si vous souhaitez continuer, sélectionnez à nouveau Installer.

Après avoir installé l'extension tierce, l'étape suivante consiste à connecter votre GitHub compte, votre espace de travail Bitbucket ou votre GitLab utilisateur à votre CodeCatalyst espace.

Pour connecter votre GitHub compte, votre espace de travail Bitbucket ou votre GitLab utilisateur à CodeCatalyst

Procédez de l'une des manières suivantes en fonction de l'extension tierce que vous avez choisi de configurer :

  • GitHub référentiels : Connectez-vous à un GitHub compte.

    1. Choisissez Connect GitHub account pour accéder au site externe pour GitHub.

    2. Connectez-vous à votre GitHub compte à l'aide de vos GitHub informations d'identification, puis choisissez le compte sur lequel vous souhaitez installer Amazon CodeCatalyst.

      Astuce

      Si vous avez déjà connecté un GitHub compte à l'espace, il ne vous sera pas demandé de procéder à une nouvelle autorisation. Vous verrez plutôt une boîte de dialogue vous demandant où vous souhaitez installer l'extension si vous êtes membre ou collaborateur de plusieurs GitHub espaces, ou la page de configuration de l' CodeCatalyst application Amazon si vous n'appartenez qu'à un seul GitHub espace. Configurez l'application pour l'accès au référentiel que vous souhaitez autoriser, puis choisissez Enregistrer. Si le bouton Enregistrer n'est pas actif, modifiez la configuration, puis réessayez.

    3. Choisissez si vous souhaitez autoriser l'accès CodeCatalyst à tous les référentiels actuels et futurs, ou choisissez les GitHub référentiels spécifiques dans lesquels vous souhaitez les utiliser. CodeCatalyst L'option par défaut consiste à inclure tous les GitHub référentiels du GitHub compte, y compris les futurs référentiels auxquels. CodeCatalyst

    4. Vérifiez les autorisations accordées à CodeCatalyst, puis choisissez Installer.

    Après avoir connecté votre GitHub compte à CodeCatalyst, vous êtes redirigé vers la page de détails de l'extension GitHub des référentiels, où vous pouvez consulter et gérer les GitHub comptes connectés et les GitHub référentiels liés.

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

    1. Choisissez Connect Bitbucket workspace pour accéder au site externe de Bitbucket.

    2. Connectez-vous à votre espace de travail Bitbucket à l'aide de vos identifiants Bitbucket et vérifiez les autorisations accordées à. CodeCatalyst

    3. Dans le menu déroulant Autoriser pour l'espace de travail, choisissez l'espace de travail Bitbucket auquel vous souhaitez donner CodeCatalyst accès, puis choisissez Autoriser l'accès.

      Astuce

      Si vous avez déjà connecté un espace de travail Bitbucket à cet espace, il ne vous sera pas demandé de procéder à une nouvelle autorisation. Vous verrez plutôt une boîte de dialogue vous demandant où vous souhaitez installer l'extension si vous êtes membre ou collaborateur de plusieurs espaces de travail Bitbucket, ou la page de configuration de l' CodeCatalyst application Amazon si vous n'appartenez qu'à un seul espace de travail Bitbucket. Configurez l'application pour l'accès à l'espace de travail que vous souhaitez autoriser, puis choisissez Autoriser l'accès. Si le bouton Accorder l'accès n'est pas actif, modifiez la configuration, puis réessayez.

    Après avoir connecté votre espace de travail Bitbucket à CodeCatalyst, vous êtes redirigé vers la page de détails de l'extension des référentiels Bitbucket, où vous pouvez consulter et gérer les espaces de travail Bitbucket connectés et les référentiels Bitbucket liés.

  • GitLab référentiels : Connectez-vous à un GitLab utilisateur.

    1. Choisissez Connect GitLab user pour accéder au site externe pour GitLab.

    2. Connectez-vous à votre GitLab utilisateur à l'aide de vos GitLab informations d'identification et passez en revue les autorisations accordées à CodeCatalyst.

      Astuce

      Si vous avez déjà connecté un GitLab utilisateur à l'espace, il ne vous sera pas demandé de l'autoriser à nouveau. Au lieu de cela, vous serez redirigé vers la CodeCatalyst console.

    3. Choisissez Autoriser le AWS connecteur pour GitLab.

    Après avoir connecté votre GitLab utilisateur à CodeCatalyst, vous êtes redirigé vers la page de détails de l'extension GitLab des référentiels, où vous pouvez afficher et gérer les référentiels des GitLab utilisateurs connectés et des GitLab projets liés.

Après avoir connecté votre source tierce à CodeCatalyst, vous pouvez lier les référentiels tiers à vos CodeCatalyst projets.

Pour créer votre projet

  1. Sur la page Créer un projet, choisissez le GitHub compte que vous avez connecté.

  2. En fonction du fournisseur de référentiel tiers que vous avez connecté, choisissez le menu déroulant GitHub des référentiels, des GitLab référentiels Bitbucket ou des référentiels pour afficher les référentiels tiers, puis choisissez le référentiel que vous souhaitez associer à votre projet.

  3. Dans le champ de saisie de texte Nommez votre projet, entrez le nom que vous souhaitez attribuer à votre projet. Le nom doit être unique dans votre espace.

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

Après avoir installé les GitHub référentiels, les référentiels Bitbucket ou l'extension de GitLab référentiels, connecté votre fournisseur de ressources et lié votre référentiel tiers à votre CodeCatalyst projet, vous pouvez l'utiliser dans les CodeCatalyst flux de travail et les environnements de développement. Vous pouvez également créer des référentiels tiers dans le GitHub compte connecté, l'espace de travail Bitbucket ou GitLab l'utilisateur à l'aide du code généré à partir d'un plan. Vous pouvez également utiliser les référentiels liés avec Amazon Q Developer, des plans, etc. Pour plus d’informations, consultez Démarrage automatique d'un flux de travail exécuté après des événements liés à un référentiel tiers et Création d'un environnement de développement.

Création d'un projet à l'aide d'un plan

Vous pouvez fournir toutes les ressources de votre projet et un exemple de code avec un plan de projet. Pour plus d'informations sur les plans, consultez leCréation d'un projet complet avec des CodeCatalyst plans.

Pour créer un projet à l'aide d'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 Bonnes 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 de l'IA.

  4. Dans l'onglet CodeCatalyst Blueprints ou Space Blueprints, choisissez un plan, puis cliquez sur Next.

  5. Sous Nommer votre projet, entrez le nom que vous souhaitez attribuer à votre projet et les noms de ressources associés. Le nom doit être unique dans votre espace.

  6. (Facultatif) Par défaut, le code source créé par le plan 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 des modifications dans la branche par défaut pour les référentiels liés. Pour modifier la branche par défaut d'un dépôt lié, vous devez d'abord en dissocier CodeCatalyst, modifier la branche par défaut, puis la lier à nouveau. Pour de plus amples informations, veuillez consulter Lier GitHub les référentiels, les référentiels Bitbucket, les référentiels de GitLab projets et les projets Jira dans CodeCatalyst.

    Il est recommandé de toujours s'assurer que vous disposez de la dernière version de l'extension avant de lier un dépôt.

    Procédez de l'une des manières 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 sur lequel vous souhaitez stocker le code source créé par le plan.

      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 votre GitHub identité. Pour plus d’informations, consultez Connexions personnelles et Accès aux GitHub ressources par le biais de connexions personnelles.

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

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

  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 mis à jour en fonction des paramètres de projet 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, les connexions et autorisations requises, ainsi que le type de ressources créé par le plan.

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

Bonnes pratiques lors de l'utilisation d'Amazon Q pour créer des projets ou ajouter des fonctionnalités à l'aide de plans

Lorsque vous créez un projet ou que vous souhaitez ajouter de nouveaux composants à un projet existant, vous ne savez peut-être pas quel modèle utiliser ou comment intégrer les fonctionnalités. CodeCatalyst inclut l'intégration avec un assistant d'intelligence artificielle génératif appelé Amazon Q qui peut analyser les exigences de votre projet et suggérer le plan le mieux adapté à vos besoins.

Vous pouvez utiliser Amazon Q pour créer un projet avec un plan qui crée des composants en fonction de vos besoins, ou vous pouvez utiliser Amazon Q pour vous aider à ajouter un plan à un projet existant. Par exemple, pour ajouter des ressources pour une application Web ou une application moderne à un projet, spécifiez vos besoins, puis les ressources seront ajoutées avec un plan recommandé. Les problèmes relatifs aux composants restants peuvent être créés pour vous.

Amazon Q crée également des problèmes liés à des exigences qui ne peuvent pas être traitées par un plan suggéré. En outre, vous pouvez attribuer ces problèmes à Amazon Q. Si vous attribuez le problème à Amazon Q, celui-ci essaiera de créer un projet de solution que vous pourrez évaluer. Cela peut vous aider, vous et votre équipe, à vous concentrer et à optimiser le 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.

Note

Propulsé par Amazon Bedrock : AWS implémente la détection automatique des abus. É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 Amazon Q Developer Agent pour les fonctionnalités 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).

Voici quelques bonnes pratiques pour vous aider à créer des projets et à ajouter des plans avec Amazon Q.

Important

Les fonctionnalités d'IA générative ne sont disponibles que dans la région ouest des États-Unis (Oregon).

  • Utilisez les instructions par défaut fournies par Amazon Q. Amazon Q fait de son mieux pour choisir les plans à partir des instructions fournies.

  • Utilisez les options de configuration proposées par Amazon Q pour prévisualiser les plans. Choisissez un plan pour prévisualiser l'exemple de code et les ressources qui seront créés par le plan.

  • Utilisez un espace activé pour Amazon Q. Pour créer un projet avec Amazon Q, ou pour ajouter des fonctionnalités à un projet avec des plans à l'aide d'Amazon Q, utilisez un espace activé pour les fonctionnalités d'IA génératives. Pour plus d'informations, consultez la section Activation ou désactivation des fonctionnalités d'IA génératives pour un espace.

  • Obtenez plus d'informations sur les plans recommandés par Amazon Q. Vous souhaiterez peut-être en savoir plus sur le type de ressources de projet, les exemples de code et les composants créés à l'aide d'un plan recommandé spécifique. Pour plus d'informations sur les plans disponibles dans CodeCatalyst, voirCréation d'un projet complet avec des CodeCatalyst plans.

  • Autorisez Amazon Q à résoudre les problèmes. Permettez à Amazon Q de créer des problèmes pour vous, de les attribuer et d'en assurer le suivi. 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.

  • Annulez l'attribution à Amazon Q des problèmes qui ne sont plus résolus. Une fois que vous avez terminé l'exemple, annulez l'attribution à Amazon Q des 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 et tarification.

  • Afficher l'utilisation d'Amazon Q. Vous pouvez visualiser l'utilisation des fonctionnalités d'IA générative au niveau de l'utilisateur. Accédez à Mes paramètres pour gérer les quotas d'IA génératifs et afficher l'utilisation en fonction de votre identifiant Builder ou de votre identité d'authentification unique (SSO). Pour plus d'informations, consultez la section Affichage de l'utilisation des fonctionnalités d'IA génératives dans un espace.

Important

Les fonctionnalités génératives de l'IA dans CodeCatalyst sont soumises à des quotas. Pour plus d'informations, consultez Amazon Q Developer Pricing, Activation ou désactivation des fonctionnalités d'IA générative pour un espace et Facturation.

Bonnes pratiques pour l'utilisation de plans dans le cadre de projets

Voici quelques bonnes pratiques pour vous aider à créer un projet avec des plans ou à ajouter des plans.

  • Utilisez les plans fournis par CodeCatalyst pour créer ou ajouter des projets. Vous pouvez utiliser des plans pour créer un projet complet avec du code source et des ressources pour les développeurs. Par exemple, le plan d'application Web crée des ressources d'application et d'infrastructure et déploie une application Web. Vous pouvez créer un projet avec un plan ou ajouter un plan personnalisé à un projet existant. Pour de plus amples informations, veuillez consulter Création d'un projet à l'aide d'un plan. Affichez n'importe quel plan CodeCatalyst pour prévisualiser l'exemple de code et les ressources qui seront créés par le plan.

  • Utilisez des plans personnalisés conçus par votre organisation. Vous pouvez utiliser des plans personnalisés pour créer un projet complet dans votre espace. Le plan personnalisé conçu par votre organisation peut fournir une standardisation et les meilleures pratiques, ce qui peut également contribuer à réduire les efforts liés à la mise en place d'un nouveau projet. En tant qu'auteur d'un plan personnalisé, vous pouvez consulter les détails des projets qui utilisent votre plan dans l'ensemble de votre espace. La gestion du cycle de vie vous permet de gérer de manière centralisée le cycle de développement logiciel de chaque projet, et les utilisateurs du plan peuvent utiliser la gestion du cycle de vie pour régénérer une base de code à partir d'options ou de versions mises à jour d'un plan. Pour de plus amples informations, veuillez consulter Travailler avec la gestion du cycle de vie en tant qu'auteur de plans.

  • Ajoutez le rôle de développeur ou IAM les rôles appropriés au compte de votre projet. Pendant ou après avoir terminé les étapes de création du projet, vous pouvez configurer les autorisations de votre plan en choisissant ou en créant IAM des rôles dans un Compte AWS espace connecté à l'espace.

Ajouter des ressources et des tâches aux projets créés

Une fois que votre projet est prêt, vous pouvez ajouter des ressources et des tâches.