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.

Concepts du référentiel source

Voici quelques concepts à connaître lorsque vous travaillez avec des référentiels CodeCatalyst sources.

Projets

Un projet représente un effort de collaboration CodeCatalyst qui soutient les équipes et les tâches de développement. Une fois que vous avez un projet, vous pouvez ajouter, mettre à jour ou supprimer des utilisateurs et des ressources, personnaliser le tableau de bord de votre projet et suivre l'avancement du travail de votre équipe. Vous pouvez avoir plusieurs projets au sein d'un même espace.

Les référentiels sources sont spécifiques aux projets dans lesquels vous les créez ou les liez dans un espace. Vous ne pouvez pas partager un référentiel entre des projets et vous ne pouvez pas lier un référentiel à plusieurs projets dans un espace. Les utilisateurs ayant le rôle de contributeur ou d'administrateur de projet dans un projet peuvent interagir avec les référentiels sources associés à ce projet conformément aux autorisations accordées à ces rôles. Pour de plus amples informations, veuillez consulter Octroi d'accès avec des rôles d'utilisateur.

Référentiels de sources

Un référentiel source est l'endroit où vous stockez en toute sécurité le code et les fichiers de votre projet. Il enregistre également l'historique des versions de vos fichiers. Par défaut, un référentiel source est partagé avec les autres utilisateurs de votre CodeCatalyst projet. Vous pouvez disposer de plusieurs référentiels sources pour un projet. Vous pouvez créer des référentiels sources pour les projets dans CodeCatalyst, ou vous pouvez choisir de lier un référentiel source existant hébergé par un autre service si ce service est pris en charge par une extension installée. Par exemple, vous pouvez lier un GitHub dépôt à un projet après avoir installé l'extension GitHub Repositories. Pour plus d’informations, consultez Stockage du code source dans des référentiels pour un projet dans CodeCatalyst et Démarrage rapide : installation d'extensions, connexion de fournisseurs et liaison de ressources dans CodeCatalyst.

Environnements de développement

Un environnement de développement est un environnement de développement basé sur le cloud que vous pouvez utiliser CodeCatalyst pour travailler rapidement sur le code stocké dans les référentiels sources de votre projet. Les outils de projet et les bibliothèques d'applications inclus dans votre environnement de développement sont définis par un fichier de développement dans le référentiel source de votre projet. Si vous n'avez pas de fichier de développement dans votre dépôt source, un fichier de développement par défaut sera automatiquement appliqué. Le fichier de développement par défaut inclut des outils pour les langages de programmation et les frameworks les plus fréquemment utilisés. Par défaut, un environnement de développement est configuré pour disposer d'un processeur à 2 cœursRAM, de 4 Go et de 16 Go de stockage persistant.

Vous pouvez choisir de cloner une branche existante de votre référentiel source dans votre environnement de développement, ou vous pouvez choisir de créer une nouvelle branche dans le cadre de la création de l'environnement de développement.

Jetons d'accès personnels (PATs)

Un jeton d'accès personnel (PAT) est similaire à un mot de passe. Il est associé à votre identité d'utilisateur pour être utilisé dans tous les espaces et projets de CodeCatalyst. Vous pouvez accéder PATs à CodeCatalyst des ressources qui incluent des environnements de développement intégrés (IDEs) et des référentiels de sources basés sur Git. PATsvous représentent CodeCatalyst et vous pouvez les gérer dans vos paramètres utilisateur. Un utilisateur peut en avoir plusieursPAT. Les jetons d'accès personnels ne s'affichent qu'une seule fois. Il est recommandé de les stocker en toute sécurité sur votre ordinateur local. Par défaut, PATs expirent au bout d'un an.

Lorsque vous travaillez avec des environnements de développement intégrés (IDEs), PATs ils sont l'équivalent d'un mot de passe Git. Indiquez le mot de passe PAT lorsqu'on vous le demande lorsque vous configurez votre IDE compte pour travailler avec un dépôt Git. Pour plus d'informations sur la façon de vous connecter IDE à un dépôt basé sur Git, consultez la documentation de votreIDE.

Branches

Une branche est un pointeur ou une référence vers un commit dans Git et dans CodeCatalyst. Vous pouvez utiliser des branches pour organiser votre travail. Par exemple, vous pouvez utiliser des branches pour travailler sur une version nouvelle ou différente de fichiers sans affecter les fichiers des autres branches. Vous pouvez utiliser des branches pour développer de nouvelles fonctionnalités, stocker une version spécifique de votre projet, etc. Un dépôt source peut comporter une ou plusieurs branches. Lorsque vous créez un projet à l'aide d'un modèle, le référentiel source créé pour le projet contient des exemples de fichiers dans une branche appelée main. La branche principale est la branche par défaut du référentiel.

Branches par défaut

Les référentiels source CodeCatalyst ont une branche par défaut, quelle que soit la manière dont vous les créez. Si vous choisissez de créer un projet à l'aide d'un modèle, le référentiel source créé pour ce projet inclut un fichier README .md en plus des exemples de code, des définitions de flux de travail et d'autres ressources. Si vous créez un référentiel source sans utiliser de modèle, un fichier README .md est ajouté pour vous lors de la première validation et une branche par défaut est créée pour vous dans le cadre de la création du référentiel. Cette branche par défaut est nommée main. Cette branche par défaut est celle utilisée comme branche de base ou par défaut dans les référentiels locaux (dépôts) lorsque les utilisateurs clonent le référentiel. Vous pouvez modifier la branche utilisée comme branche par défaut. Pour de plus amples informations, veuillez consulter Gestion de la branche par défaut d'un dépôt.

Vous ne pouvez pas supprimer la branche par défaut d'un dépôt source. Les résultats de recherche incluent uniquement les résultats de la branche par défaut.

Validations

Un commit est une modification apportée à un fichier ou à un ensemble de fichiers. Dans la CodeCatalyst console Amazon, un commit enregistre vos modifications et les envoie vers un référentiel source. Le commit inclut des informations sur le changement, notamment l'identité de l'utilisateur qui a effectué le changement, l'heure et la date du changement, le titre du commit et tout message inclus concernant le changement. Pour de plus amples informations, veuillez consulter Comprendre les modifications apportées au code source à l'aide de validations sur Amazon CodeCatalyst.

Dans le contexte d'un dépôt source en CodeCatalyst, les validations sont des instantanés du contenu et des modifications apportées au contenu de votre dépôt. Vous pouvez également ajouter des balises Git aux validations, afin d'identifier des validations spécifiques.

Demandes d'extraction

Une pull request est le principal moyen par lequel vous et les autres utilisateurs examinez, commentez et fusionnez les modifications de code d'une branche à l'autre dans un référentiel source. 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. Dans une pull request, vous pouvez examiner les modifications entre les branches source et de destination ou les différences entre les révisions de ces branches. Vous pouvez ajouter des commentaires à des lignes de code individuelles ainsi que des commentaires sur la pull request dans son ensemble.

Révisions

Une révision est une version mise à jour d'une pull request. Chaque envoi vers la branche source d'une pull request crée une révision qui contient les modifications apportées aux validations incluses dans ce push. Vous pouvez voir les différences entre les révisions d'une pull request en plus des différences entre les branches source et de destination. Pour de plus amples informations, veuillez consulter Révision du code avec des pull requests sur Amazon CodeCatalyst.

Flux de travail

Un flux de travail est une procédure automatisée qui décrit comment créer, tester et déployer votre code dans le cadre d'un système d'intégration et de livraison continues (CI/CD). Un flux de travail définit une série d'étapes, ou d'actions, à effectuer lors de l'exécution d'un flux de travail. Un flux de travail définit également les événements, ou déclencheurs, qui déclenchent le démarrage du flux de travail. Pour configurer un flux de travail, vous devez créer un fichier de définition de flux de travail à l'aide du visuel ou de l'YAMLéditeur de la CodeCatalyst console.

Un référentiel source peut également stocker les fichiers de configuration et d'autres informations relatives aux flux de travail, aux notifications, aux problèmes et aux autres informations de configuration du projet. Les fichiers de configuration sont créés et stockés dans le référentiel source lorsque vous créez des ressources qui nécessitent des fichiers de configuration ou lorsque vous spécifiez le référentiel comme action source pour un flux de travail. Si vous créez un projet à partir d'un plan, les fichiers de configuration seront déjà stockés dans le référentiel source créé pour vous dans le cadre du projet. Ces informations de configuration sont stockées dans un dossier nommé .codecatalyst dans la branche par défaut de votre référentiel. Chaque fois que vous créez une branche de la branche par défaut, vous créez une copie de ce dossier et de sa configuration en plus de tous les autres fichiers et dossiers de cette branche.