View a markdown version of this page

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 avec un planMeilleures pratiques lors de l'utilisation d'Amazon Q pour créer des projets ou ajouter des fonctionnalités à l'aide de plansMeilleures pratiques pour utiliser des plans dans le cadre de projetsAjouter des ressources et des tâches aux projets créés

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.

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

CodeCatalyst Les projets vous permettent d'effectuer des tâches de développement à l'aide de flux de travail et de référentiels de integration/continuous diffusion continue (CI/CD) partagés, de gérer les ressources, de suivre les problèmes et d'ajouter des utilisateurs.

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

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 expérimenté.

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 Repartir de zéro.

  4. Sous Donnez un nom à votre projet, entrez le nom que vous souhaitez attribuer à votre projet. Le nom doit être unique au sein de 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 de votre choix tout en continuant à utiliser 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 qui est lié à un GitHub référentiel, à un référentiel Bitbucket ou à un référentiel de GitLab projets. 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 expérimenté. Pour plus d’informations, consultez Création d’un espace et Inviter un utilisateur directement dans un espace.

Pour créer un projet CodeCatalyst contenant des liens vers 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 des référentiels. Sur un site externe, vous êtes invité à vous connecter et CodeCatalyst à donner accès à votre référentiel, 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 GitLab des référentiels sur votre CodeCatalyst espace, vous devez être connecté avec un compte qui possède le rôle d'administrateur de l'espace dans l'espace.

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

    Important

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

    Important

    Une fois que vous avez 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 lors de l'utilisation de 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 référentiel, à votre référentiel Bitbucket ou à votre référentiel de GitLab projets.

    Important

    Bien que vous puissiez lier un GitHub référentiel, un référentiel Bitbucket ou un référentiel de GitLab projet en tant que contributeur, vous ne pouvez dissocier un référentiel tiers qu'en tant qu'administrateur de Space ou administrateur de projet. Pour de plus amples informations, veuillez consulter Dissocier GitHub les référentiels, les référentiels Bitbucket, les référentiels de projets et les GitLab projets Jira 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.

    Note

    • Un GitHub référentiel, un référentiel Bitbucket ou un référentiel 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 référentiel, un référentiel Bitbucket ou un référentiel de GitLab projet portant le même nom qu'un référentiel d'un CodeCatalyst projet.

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

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

    • L'extension GitLab des référentiels 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 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 Associer un dépôt 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 fait auparavant. 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, choisissez de 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

Effectuez l'une des opérations suivantes en fonction de l'extension tierce que vous avez choisi de configurer :

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

    1. Choisissez Connecter un GitHub compte pour accéder au site externe 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. À la place, vous verrez apparaître 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 que vous souhaitez 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 qui seront accessibles par. 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 des 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 associé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 informations d'identification 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 autoriser CodeCatalyst l'accès, puis choisissez Autoriser l'accès.

      Astuce

      Si vous avez déjà connecté un espace de travail Bitbucket à cet espace, vous ne serez pas invité à renouveler votre autorisation. Vous verrez à la place 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 Autoriser l'accès n'est pas actif, modifiez la configuration, puis réessayez.

    Une fois 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 Connecter GitLab l'utilisateur pour accéder au site externe pour lequel GitLab.

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

      Astuce

      Si vous avez déjà connecté un GitLab utilisateur à l'espace, il ne vous sera pas demandé de le réautoriser. Vous serez plutôt redirigé vers la CodeCatalyst console.

    3. Choisissez Authorize AWS Connector 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. Selon le fournisseur de référentiel tiers que vous avez connecté, choisissez les GitHub référentiels, les référentiels Bitbucket ou le menu déroulant GitLab des référentiels pour afficher les référentiels tiers, puis choisissez le référentiel que vous souhaitez lier à 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 au sein de 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 des 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 avec un plan

Vous pouvez fournir toutes les ressources de votre projet et des exemples de code à l'aide d'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 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).

Meilleures 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 plan utiliser ou comment intégrer des fonctionnalités. CodeCatalyst inclut l'intégration à un assistant d'intelligence artificielle génératif appelé Amazon Q qui peut analyser les exigences de votre projet et suggérer un plan qui répond le mieux à vos besoins.

Vous pouvez utiliser Amazon Q pour vous aider à 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é. Des problèmes pour les 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é. Vous pouvez également attribuer ces problèmes à Amazon Q. Si vous attribuez le problème à Amazon Q, l'entreprise tentera de créer une ébauche 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, pendant qu'Amazon Q travaille à une solution aux problèmes que vous ne disposez pas de ressources pour résoudre immédiatement.

Note

Propulsé par Amazon Bedrock  : AWS met en œuvre une détection https://docs.aws.amazon.com/bedrock/latest/userguide/abuse-detection.html 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 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).

Voici quelques bonnes pratiques qui vous aideront à 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 de l'Ouest des États-Unis (Oregon).

  • Utilisez les instructions par défaut fournies par Amazon Q. Amazon Q fait de son mieux pour choisir des 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 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, consultezCréation d'un projet complet avec des CodeCatalyst plans.

  • Autorisez Amazon Q à résoudre les problèmes. Autorisez Amazon Q à créer des problèmes pour vous, à les attribuer et à les suivre. 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.

  • Déconnectez Amazon Q des problèmes qui ne sont plus résolus. Une fois l'exemple terminé, annulez l'attribution à Amazon Q des problèmes qui ne sont plus résolus. Si Amazon Q a terminé ses travaux sur 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 la section Gestion des fonctionnalités génératives de l'IA et de la tarification.

  • Afficher l'utilisation d'Amazon Q. Vous pouvez consulter l'utilisation des fonctionnalités d'IA génératives 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 d'IA génératives de CodeCatalyst sont soumises à des quotas. Pour plus d'informations, consultez les rubriques Tarification Amazon Q pour les développeurs, Activation ou désactivation des fonctionnalités d'IA génératives pour un espace et Facturation.

Meilleures pratiques pour utiliser des plans dans le cadre de projets

Voici quelques bonnes pratiques qui vous aideront à 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 avec 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 de mise en place d'un nouveau projet. En tant qu'auteur de plans personnalisés, vous pouvez consulter des informations sur les 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 vie du développement logiciel de chaque projet, et les utilisateurs de Blueprint 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 les rôles IAM 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 des rôles IAM 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.