Generalidades
Cuando inicias un nuevo repositorio de git vía SSH en un servidor de DreamHost, la primera rama es nombrada master. Esto es por que el software de git actualmente predetermina el nombre de la rama.
Muchas companías que usan el software de git como base de sus plataformas, como github.com, gitlab.com, y bitbucket.org, han renombrado la primera rama a main. Los siguientes enlaces te dan más información sobre esto:
- git-scm.com/book/en/v2/Git-Branching-Branch-Management
- github.com/github/renaming
- sfconservancy.org/news/2020/jun/23/gitbranchname/
- about.gitlab.com/blog/2021/03/10/new-git-default-branch-name/
- bitbucket.org/blog/moving-away-from-master-as-the-default-name-for-branches-in-git
¿Qué significa esto?
Cuando creas un repositorio en tu servidor de DreamHost, la rama principal es nombrada master. Esto continuará funcionando normalmente en tu servidor DreamHost sin ningún problema.
Sin embargo, se recomienda que, de ahora en adelante, cambies el nombre de rama principal a main de tus repositorios. Esto asegurará la futura compatibilidad con otros programas de software, como se mencionó anteriormente.
Cambiar la rama principal para usar 'main'
Los repositorios recién creados usan el nombre master como la rama principal. Para asegurar compatibilidad futura, se recomienda que actualices el nombre de esta rama a main.
- Revisa el nombre de tu rama corriendo el siguiente comando en el computador de tu hogar o servidor de DreamHost.
[server]$ git branch -a
- Si hay varias ramas, la rama activa mostrará un * a la izquierda. Si ves que la rama principal es master, corre los siguientes comandos para actualizarlo a main.
- Asegúrate de que la rama activa sea master.
[server]$ git checkout master
- Renombralo usando la opción -m.
[server]$ git branch -m main
Si la rama principal existe por alguna razón, puedes usar -M para forzar el cambio de nombre.
- Actualiza los symbolic refs para usar main.
[server]$ git symbolic-ref HEAD refs/heads/main
Actualizar repositorios remotos
Si has enviado este repositorio local a un repositorio remoto (como github.com), debes enviarlo nuevamente para restablecer la rama ascendente.
Cambia REMOTENAME al nombre de tu repositorio remoto. Corre git remote para ver los remotos existentes.
[server]$ git push -u REMOTENAME main
Luego, debes eliminar la rama maestra antigua.
[server]$ git push REMOTEBRANCH --delete master
RFevisa el siguiente enlace para más detalles.
Actualizar tu archivo config de git (en el computador de tu hogar)
El siguiente comando solo funciona con las versiones de git 2.28 o superiores. Los servidores DreamHost ejecutan la versión git instalada con el sistema operativo del servidor, que actualmente se encuentra por debajo de la versión 2.28. Para confirmar, inicia sesión en su servidor a través de SSH y corre el siguiente comando:
[server]$ git --version
Si la versión es anterior a 2.28, debes usar la opción anterior para renombrar manualmente la rama.
Si la versión de git en el computador de tu hogar es superior a 2.28, puedes ejecutar el siguiente comando para agregar una línea a tu archivo config de git. Esto garantizará que todos los repositorios futuros que crees (en el computador de tu hogar) usen main como la rama principal. Luego puedes enviarlos a tu servidor DreamHost siguiendo las instrucciones de los siguientes artículos:
- Enviar tu repositorio local de Git a un servidor de DreamHost — Linux & Mac OS X
- Enviar tu repositorio local de Git a un servidor DreamHost — Windows
Correr el comando
- Abre una terminal en el computador de tu hogar.
- Corre el siguiente comando:
[server]$ git config --global init.defaultBranch main
Ahora, cuando inicies un nuevo repositorio corriendo git init, se usará main en lugar de master como la primera rama.