Renommez un référentiel Git dans votre projet

Azure DevOps Services | Azure DevOps Server 2022 | Azure DevOps Server 2019

Visual Studio 2019 | Visual Studio 2022

Vous pouvez renommer un référentiel Git dans un projet à partir de votre navigateur web. Après avoir renommé le référentiel, chaque membre de votre équipe doit prendre quelques mesures pour réactiver ses machines de développement afin qu’elles se connectent au référentiel sur le serveur.

Prérequis

• Pour renommer un référentiel, vous devez disposer des autorisations Renommer le référentiel sur votre référentiel Git.

• Si vous souhaitez utiliser la commande az repos update pour renommer un référentiel, veillez à suivre les étapes de Prise en main de l’interface de ligne de commande Azure DevOps.

Renommez le référentiel

Browser

1. Dans le portail web, sélectionnez Repos, Fichiers.

   

2. Dans la liste déroulante du référentiel, sélectionnez Gérer les référentiels.

   

3. Sélectionnez le nom du référentiel dans la liste Référentiels, choisissez le menu ..., puis choisissez Renommer le référentiel.

   

4. Renommez le référentiel en tapant le nouveau nom du référentiel et en sélectionnant Renommer.

   

Interface CLI Azure DevOps

Vous pouvez utiliser az repos update pour mettre à jour la branche par défaut ou renommer un référentiel.

az repos show --repository
                [--default-branch]
                [--detect {false, true}]
                [--name]
                [--org]
                [--project]
                [--subscription]

Paramètres

Paramètre	Description
repository	Nom ou ID d’un référentiel.
default-branch	Spécifiez la branche par défaut à définir pour le référentiel. Exemple : « refs/heads/live » ou « live ».
detect	Détectez automatiquement l’organisation. Valeurs acceptées : false, true.
name	Nouveau nom pour le référentiel.
org, organization	URL de l’organisation Azure DevOps. Vous pouvez configurer l’organisation par défaut à l’aide de az devops configure -d organization=<ORG_URL>. Obligatoire s’il n’est pas configuré par défaut ou récupéré via git config. Exemple : https://dev.azure.com/MyOrganizationName/.
project, p	Nom ou ID du projet. Vous pouvez configurer le projet par défaut en utilisant az devops configure -d project=<NAME_OR_ID>. Obligatoire s’il n’est pas configuré par défaut ou récupéré par le biais de la configuration git.
subscription	Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s <NAME_OR_ID>.

Exemple

La commande suivante renomme contosoREPO en contosoFabrikam pour la configuration az devops configure --defaults organization=https://dev.azure.com/fabrikamprime project="Fabrikam Fiber" par défaut.

az repos show --repository contosoREPO --output table
ID                                    Name         Default Branch    Project
------------------------------------  -----------  ----------------  --------------
30954ce5-417b-4930-b8d2-8b6cac934a34  contosoREPO  main              Fabrikam Fiber

Pour plus d’informations, entrez la commande suivante :

az repos update --repository contosoREPO --name contosoFabrikam
{
  "defaultBranch": "refs/heads/main",
  "id": "30954ce5-417b-4930-b8d2-8b6cac934a34",
  "isDisabled": false,
  "isFork": null,
  "name": "contosoFabrikam",
  "parentRepository": null,
  "project": {
    "abbreviation": null,
    "defaultTeamImageUrl": null,
    "description": "Guidance and source control to foster a vibrant ecosystem for Fabrikam Fiber applications and extensions.",
    "id": "56af920d-393b-4236-9a07-24439ccaa85c",
    "lastUpdateTime": "2021-05-24T21:52:14.95Z",
    "name": "Fabrikam Fiber",
    "revision": 438023732,
    "state": "wellFormed",
    "url": "https://dev.azure.com/fabrikamprime/_apis/projects/56af920d-393b-4236-9a07-24439ccaa85c",
    "visibility": "private"
  },
  "remoteUrl": "https://fabrikamprime@dev.azure.com/fabrikamprime/Fabrikam%20Fiber/_git/contosoFabrikam",
  "size": 1627,
  "sshUrl": "git@ssh.dev.azure.com:v3/fabrikam/Fabrikam%20Fiber/contosoFabrikam",
  "url": "https://dev.azure.com/fabrikamprime/56af920d-393b-4236-9a07-24439ccaa85c/_apis/git/repositories/30954ce5-417b-4930-b8d2-8b6cac934a34",
  "validRemoteUrls": null,
  "webUrl": "https://dev.azure.com/fabrikamprime/Fabrikam%20Fiber/_git/contosoFabrikam"
}

Mettez à jour les dépôts distants Git sur vos machines de développement

Git utilise des références distantes pour récupérer (fetch) et envoyer (push) les modifications entre votre copie locale d’un référentiel et la version distante stockée sur le serveur. Une fois qu’un référentiel Git ou un projet a été renommé, vous devez mettre à jour vos références distantes. Mettez à jour vos références pour que l’URL du référentiel distant contienne le projet et le nom du référentiel.

Chaque membre de votre équipe doit mettre à jour ses référentiels Git locaux pour continuer à se connecter à partir de ses machines de développement au référentiel dans le projet. Les instructions ci-dessous montrent comment mettre à jour les dépôts distants pour le référentiel Fabrikam Mobile renommé en Fabrikam.

Obtenez la nouvelle URL du référentiel

1. Sélectionnez Référentiels, Fichiers.

   

2. Sélectionnez Cloner dans le coin supérieur droit de la fenêtre Fichiers et copiez l’URL de clonage.

   

Mettez à jour votre dépôt distant dans Visual Studio

Pour mettre à jour votre dépôt distant :

1. Dans le menu Git dans la barre de menu, sélectionnez Gérer les dépôts distants.

2. Dans la boîte de dialogue Options, sélectionnez le dépôt distant à modifier, puis sélectionnez Modifier.

   

3. Remplacez les références distantes récupérer (fetch) et envoyer (push) par l’URL que vous avez copiée à partir du référentiel distant.

4. Sélectionnez Enregistrer, puis OK pour fermer la boîte de dialogue Options.

Visual Studio 2019 version 16.8 et versions ultérieures fournit une expérience de contrôle de version Git tout en conservant l’interface utilisateur Git de Team Explorer. Pour utiliser Team Explorer, décochez Outils>Options>Fonctionnalités en préversion>Nouvelle expérience utilisateur Git dans la barre de menu. Vous pouvez exercer les fonctionnalités Git à partir de l’une ou l’autre interface de manière interchangeable.

Pour mettre à jour votre dépôt distant à partir de Visual Studio Team Explorer :

1. Connectez-vous au référentiel.

   

2. Ouvrez les paramètres du projet.

   

3. Ouvrez les paramètres du référentiel.

   

4. Modifiez la récupération (fetch) et envoyez (push) des références distantes et collez l’URL que vous avez copiée à partir du référentiel distant.

   

Q&R

Q : Puis-je renommer mon référentiel à nouveau ? Puis-je réutiliser un ancien nom de référentiel ?

R : Oui

Articles connexes

• Définir les stratégies et paramètres de dépôt Git