Cambio de nombre de un repositorio Git en el proyecto

Servicios de Azure DevOps | Azure DevOps Server | Azure DevOps Server 2022

Visual Studio 2019 | Visual Studio 2022

Puede cambiar el nombre de un repositorio de Git (repositorio) en un proyecto desde el explorador web. Después de cambiar el nombre del repositorio, cada miembro del equipo debe realizar algunos pasos para volver a habilitar sus máquinas de desarrollo para conectarse al repositorio en el servidor.

Requisitos previos

Categoría	Requisitos
Acceso al proyecto	Miembro de un proyecto.
Permisos	- Ver código en proyectos privados: al menos acceso básico. - Clone o contribuya al código en proyectos privados: miembro del grupo de seguridad de Colaboradores o de los permisos correspondientes del proyecto. - Establecer permisos de rama o repositorio: Administrar permisos son permisos para la rama o el repositorio. - Cambiar rama predeterminada: las directivas de edición son permisos para el repositorio. - Importar un repositorio: miembro del grupo de seguridad Administradores de proyectos o con permisos de crear repositorio de nivel de proyecto de Git establecidos en Permitir. Para obtener más información, consulte Establecimiento de permisos de repositorios Git.
Servicios	Repositorios habilitados.
Herramientas	Optional. Uso de `az repos` comandos: CLI de Azure DevOps.

Nota:

En proyectos públicos, los usuarios con acceso a las partes interesadas tienen acceso completo a Azure Repos, incluida la visualización, la clonación y la contribución al código.

Categoría	Requisitos
Acceso al proyecto	Miembro de un proyecto.
Permisos	- Ver código: acceso al menos básico. - Clone o contribuya al código: miembro del grupo de seguridad Contributors o de los permisos correspondientes del proyecto.
Servicios	Repositorios habilitados.

En el portal web, seleccione Repos>Archivos.
En la lista desplegable del repositorio, seleccione Administrar repositorios.
Seleccione el nombre del repositorio en la lista Repositorios , seleccione los puntos suspensivos ... para obtener más acciones y, a continuación, seleccione Cambiar nombre del repositorio.
Cambie el nombre del repositorio escribiendo el nuevo nombre del repositorio y seleccionando Cambiar nombre.

Puede usar az repos update para actualizar la rama predeterminada o cambiar el nombre de un repositorio.

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

Parámetros

Parámetro	Descripción
`repository`	Nombre o identificador de un repositorio.
`default-branch`	Especifique la rama predeterminada que se va a establecer para el repositorio. Un ejemplo es `refs/heads/live` o `live`.
`detect`	Detecta automáticamente la organización. Los valores aceptados son: `false` y `true`.
`name`	Nuevo nombre del repositorio.
`org`, `organization`	URL de la organización de Azure DevOps. Puede configurar la organización predeterminada mediante `az devops configure -d organization=<ORG_URL>`. Obligatorio si no está configurado como predeterminado o se recoge a través de `git config`. Un ejemplo es `https://dev.azure.com/MyOrganizationName/`.
`project`, `p`	Nombre o id. del proyecto. Puede configurar el proyecto predeterminado mediante `az devops configure -d project=<NAME_OR_ID>`. Obligatorio si no está configurado como predeterminado o se recoge a través de `git config`.
`subscription`	Nombre o ID de la suscripción. Puede configurar la suscripción predeterminada mediante `az account set -s <NAME_OR_ID>`.

Ejemplo

El comando siguiente cambia el nombre contosoREPO a contosoFabrikam para la configuración az devops configure --defaults organization=https://dev.azure.com/fabrikamprime project="Fabrikam Fiber"predeterminada.

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

Para obtener más información, escriba el comando siguiente:

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"
}

Los comandos de la CLI de Azure DevOps no son compatibles con Azure DevOps Server.

Actualiza las referencias remotas de Git en tus máquinas de desarrollo

Git usa referencias remotas para capturar e insertar cambios entre la copia local de un repositorio y la versión remota almacenada en el servidor. Después de cambiar el nombre de un repositorio o proyecto de Git, debe actualizar las referencias remotas. Actualice las referencias a la dirección URL del repositorio remoto que contiene el proyecto y el nombre del repositorio.

Cada miembro del equipo deberá actualizar sus repositorios Git locales para poder seguir conectándose desde sus máquinas de desarrollo al repositorio del proyecto. En las instrucciones siguientes se muestra cómo actualizar los remotos del repositorio fabrikam Mobile cuyo nombre se cambió a Fabrikam.

Obtención de la nueva dirección URL del repositorio

Seleccione Repos>Archivos.
En la esquina superior derecha de la ventana Archivos , seleccione Clonar y copie la dirección URL de clonación.

Actualizar tu remoto en Visual Studio

Para actualizar su control remoto:

En el menú Git de la barra de menús, seleccione Administrar remotos.
En el cuadro de diálogo Opciones , seleccione el control remoto que desea editar y, a continuación, seleccione Editar.
Reemplace las referencias remotas de captura e inserción por la dirección URL que copió del repositorio remoto.
Seleccione Guardar y, después, Aceptar.

Visual Studio 2019, versión 16.8 y versiones posteriores, proporcionan una experiencia de control de versiones de Git mientras se mantiene la interfaz de usuario de Git de Team Explorer. Para usar Team Explorer, en la barra de menús, vaya a Herramientas>Opciones>Características de vista previa y desactive la casilla Nueva experiencia de usuario de Git . Puede usar las funcionalidades de Git de manera intercambiable desde una de las dos interfaces.

Para actualizar el control remoto desde Visual Studio Team Explorer:

Para conectarse al repositorio, seleccione Conectar.
Para abrir la configuración del proyecto, seleccione Configuración.
Para abrir la configuración del repositorio, seleccione Configuración del repositorio.
Edite las referencias remotas de captura e inserción y pegue la dirección URL que copió del repositorio remoto.

Preguntas y respuestas

¿Puedo volver a cambiar el nombre de mi repositorio? ¿Puedo reutilizar un nombre de repositorio antiguo?

Sí.

Establecer configuración y directivas del repositorio de Git

Comentarios

¿Le ha resultado útil esta página?

Last updated on 2026-03-26