Gestion de la branche par défaut d'un dépôt

Vous pouvez spécifier la branche à utiliser comme branche par défaut dans un référentiel source sur Amazon CodeCatalyst. Tous les référentiels sources CodeCatalyst contiennent du contenu et une branche par défaut, quelle que soit la manière dont vous les créez. Si vous utilisez un plan pour créer un projet, la branche par défaut du référentiel source créé pour ce projet est nommée main. Le contenu de la branche par défaut s'affiche automatiquement sur la page d'aperçu de ce référentiel.

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 plus d’informations, consultez 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.

La branche par défaut est traitée un peu différemment de toutes les autres branches d'un dépôt source. Il possède une étiquette spéciale à côté de son nom, Default. La 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 sur des ordinateurs locaux avec un client Git. Il s'agit également de la valeur par défaut utilisée lors de la création de flux de travail pour le stockage de YAML fichiers de flux de travail et pour le stockage d'informations relatives à des problèmes. Lorsque vous utilisez la fonction de recherche dans CodeCatalyst, seule la branche par défaut d'un dépôt est recherchée. La branche par défaut étant fondamentale pour de nombreux aspects des projets, vous ne pouvez pas supprimer une branche si elle est spécifiée comme branche par défaut. Cependant, vous pouvez choisir d'utiliser une autre branche comme branche par défaut. Dans ce cas, toutes les règles de branche appliquées à l'ancienne branche par défaut seront automatiquement appliquées à la branche que vous spécifiez comme branche par défaut.

Note

Vous devez avoir le rôle d'administrateur de projet pour modifier la branche par défaut des référentiels sources dans les CodeCatalyst projets. Cela ne s'applique pas aux référentiels liés.

Pour afficher et modifier la branche par défaut d'un référentiel

1. Accédez au projet dans lequel se trouve votre référentiel.

2. 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, puis Référentiels sources.

   Choisissez le référentiel dans lequel vous souhaitez afficher les paramètres, y compris la branche par défaut.

3. Sur la page d'aperçu du référentiel, choisissez Plus, puis sélectionnez Gérer les paramètres.

4. Dans Branche par défaut, le nom de la branche spécifiée comme branche par défaut est affiché avec une étiquette intitulée Default à côté du nom. Cette même étiquette apparaît à côté du nom de la branche dans la liste des branches dans Branches.

5. Pour modifier la branche par défaut, choisissez Modifier.

   Note

   Vous devez avoir le rôle d'administrateur de projet dans le projet pour modifier la branche par défaut.

6. Choisissez le nom de la branche que vous souhaitez définir comme branche par défaut dans la liste déroulante, puis choisissez Enregistrer.