Skip to main content

Renombrar una rama

Puedes cambiar el nombre de una rama en un repositorio.

Who can use this feature

People with write permissions to a repository can rename a branch in the repository unless it is the default branch. People with admin permissions can rename the default branch.

Acerca de renombrar las ramas

Puedes renombrar una rama en un repositorio de your GitHub Enterprise Server instance. Para más información sobre las ramas, vea "Acerca de las ramas".

Cuando renombras una rama en your GitHub Enterprise Server instance, cualquier URL que contega el nombre de la rama antigua se redireccionará automáticamente a la URL equivalente para la rama que se renombró. También se actualizan las políticas de protección de rama, así como la rama base para las solicitudes de cambios abriertas (incluyendo aquellas para las bifurcaciones) y para los borradores de lanzamientos. Después de que se completa el renombramiento, GitHub proporciona instrucciones en la página principal del repositorio y dirige a los colaboradores a actualizar sus ambientes locales de Git.

Aunque las URL de archivo se redirigen automáticamente, las URL de archivo sin procesar no se redirigirán. Además, GitHub no realiza ninguna redirección si los usuarios realizan ejecutan git pull para el nombre de rama anterior.

Los flujos de trabajo de GitHub Actions no siguen los cambios de nombre, de forma que si el repositorio publica una acción, cualquiera que la use con @{old-branch-name} sufrirá una interrupción. Debes considerar agregar una rama nueva con el contenido original más una confirmación adicional que reporte que el nombre de rama está obsoletizado y que sugiera que los usuarios se migren al nombre de la rama nueva.

Renombrar una rama

  1. En your GitHub Enterprise Server instance, vaya a la página principal del repositorio. 1. Encima de la lista de archivos, haz clic en Ramas. Vínculo de ramas en la página de información general
  2. En la lista de ramas, a la derecha de la rama que quieras renombrar, da clic en . Icono de lápiz a la derecha de la rama que se quiere cambiar de nombre
  3. Teclea un nombre nuevo para la rama. Campo de texto para escribir un nombre de rama nuevo
  4. Revise la información sobre los entornos locales y luego haga clic en Renombrar rama. Información del entorno local y botón "Renombrar rama"

Actualizar un clon local después de que cambie el nombre de una rama

Después de que renombras una rama en un repositorio con GitHub Enterprise Server, cualquier colaborador con un clon local del repositorio necesitará actualizar dicho clon.

Desde el clon local del repositorio en una computadora, ejecuta los siguientes comandos para actualizar el nombre de la rama predeterminada.

$ git branch -m OLD-BRANCH-NAME NEW-BRANCH-NAME
$ git fetch origin
$ git branch -u origin/NEW-BRANCH-NAME NEW-BRANCH-NAME
$ git remote set-head origin -a

Opcionalmente, ejecuta el siguiente comando para eliminar las referencias de rastreo al nombre de la rama antigua.

$ git remote prune origin