Git Init: Cómo inicializar y configurar un repositorio Git

¿Alguna vez has borrado un archivo por error o has sobrescrito tu código sin forma de recuperarlo? Sin control de versiones, esos errores pueden ser catastróficos. Ahí es donde entra git init: transforma tu carpeta de proyecto en un repositorio Git, garantizando que cada cambio sea rastreable y recuperable. 

En este tutorial, te mostraré cómo configurar Git, compartiré consejos personales de mi viaje y te ayudaré a crear un flujo de trabajo sólido desde el principio.

¿Qué es Git Init?

El comando git init pone en marcha tu viaje por el control de versiones. Cuando lo ejecutas, Git crea una carpeta oculta .git dentro del directorio de tu proyecto que almacena los datos de configuración, el historial de confirmaciones y todos los metadatos necesarios para hacer un seguimiento de tus cambios. 

Con cada modificación registrada, puedes bifurcar, fusionar y colaborar con confianza, sabiendo que el historial completo de tu proyecto está siempre a sólo un comando de distancia.

Imagen del autor

Cómo utilizar Git Init

Antes de entrar en temas avanzados, es esencial comprender cómo utilizar git init en la práctica.

Uso básico de git init

Sigue estos pasos para crear un nuevo repositorio Git desde cero:  

• Abre tu terminal: Inicia tu interfaz de línea de comandos preferida.
• Navega hasta el directorio de tu proyecto:

cd /path/to/your/project

Esto cambia tu carpeta actual por la que quieres rastrear.

• Inicializa el repositorio: 

git init

Tras ejecutar este comando, se crea una carpeta oculta .git. Esa carpeta almacena toda la información de seguimiento de Git.

• Verifica el estado del repositorio:

git status

En esta fase, Git está configurado pero no rastrea ningún archivo.

Inicializar un repositorio con un proyecto existente

Para los proyectos que aún no están bajo control de versiones, puedes inicializar Git y empezar a seguir los cambios del siguiente modo:

• Navega hasta el directorio de tu proyecto:

cd /path/to/your/project

• Convierte el proyecto en un repositorio Git:

git init

Como ya hemos dicho, el comando anterior crea la carpeta oculta .git que permite el seguimiento de Git.

• Pon en escena tus archivos: Como git init no rastrea automáticamente los archivos, añádelos con:

git add .

• Confirma tus archivos: Guarda la instantánea inicial ejecutando  

git commit -m "Initial commit"

Este proceso convierte un proyecto no gestionado en uno con un historial completo de versiones, listo para nuevos desarrollos y colaboraciones.

Configurar Git (si es necesario)

Si encuentras el error "Identidad del autor desconocida", significa que Git no sabe quién eres. Para solucionarlo, configura tu identidad de usuario:

• Configura la información de usuario de Git: 

git config --global user.email "your_email@example.com"
git config --global user.name "Your Name"

Si utilizas --global, estos ajustes se aplicarán a todos los repositorios de tu máquina. Si lo omites, sólo se establecerá la identidad del repositorio actual.

• Verifica tu configuración:  

git config --global user.email
git config --global user.name

• Reintenta la confirmación:  

git commit -m "First Commit"

Me encontré con este error cuando empecé a utilizar Git por primera vez: configurando mi identidad lo resolví.

El commit inicial de Git se ejecutó correctamente en PowerShell.

Conectarse a un repositorio remoto

Una vez que hayas inicializado un repositorio Git localmente, es probable que quieras hacer una copia de seguridad o colaborar con otros conectándolo a un repositorio remoto (por ejemplo, GitHub, GitLab, Bitbucket).

• Añade un repositorio remoto: Para enlazar tu repositorio local con uno remoto, utiliza

git remote add origin <repository-url>

Sustituye por la URL de tu repositorio remoto. origin es el alias por defecto del repositorio remoto, pero puedes utilizar cualquier nombre.

• Puedes verificar la conexión con:

git remote -v

• Empuja tus cambios al repositorio remoto:

# Push the first commit and track the remote branch
git push -u origin $(git branch --show-current)  # Works for 'main' or 'master' 

El comando anterior empuja la rama actual y la pone a seguir la rama remota.

Si utilizas una versión anterior de Git que no admite $(git branch --show-current), utiliza:

git push -u origin main  # Or 'master' depending on your default branch  

A medida que sigas trabajando en tu proyecto, necesitarás fusionar cambios de distintas ramas cuando colabores con un equipo. Aprende a manejar las fusiones de forma eficazcon este tutorial sobre fusiones en Git.

Autenticación y acceso

Si estás enviando a GitHub, GitLab o Bitbucket, puede que necesites autenticarte. Según tu configuración, puedes

• Utiliza claves SSH en lugar de autenticación HTTPS (recomendado por seguridad):

git remote set-url origin git@github.com:your-username/your-repo.git

• Utiliza un Token de Acceso Personal (PAT) en lugar de una contraseña cuando utilices HTTPS. Para GitHub, sustituye la contraseña por un token:

git push https://your-username@github.com/your-repo.git

Conectarme a un repositorio remoto fue un punto de inflexión para mí: validó que mi trabajo local estaba respaldado de forma segura y listo para la colaboración. Además, me daba confianza en el control de versiones, sabiendo que mi historial se conservaba aunque fallara mi máquina local.