Primeros pasos con git y github

13 septiembre, 2024 0 Por admin

1.Instalación en Windows.
2. Creando tu primer programa.
3. Los comandos que debes aprender
4. Creando cuenta en github
5. Las claves ssh, git bash y probando la conexión
6. VScode y su complemento integrado git
7.Borrando un proyecto en github
8. Manual de git y ayuda

Git y github

Git es el versionador o rastreador (no te procupes) de nuestros archivos y github es una especie de centro de código donde todos los del equipo meten mano.

Nuestro objetivo es aprender los comandos básicos que nos van a permitir conectarnos con github y subir nuestros proyectos, también borrarlo todo y volver a empezar.

Este tutorial está orientado a personas sin conocimientos de desarrollo de aplicaciones.

Instalación en Windows

1.Vamos a git (https://git-scm.com/) para descargarnos el instalador y pinchamos en download:

Para ins

Para instalar pinchamos siempre en Next, estos pasos te los puedes saltar ya que es siempre «Next»:

2.Creando tu primer programa

En este apartado vamos a crear un proyecto, tu puedes crear el que quieras, por ejemplo en python, elegiré uno que no necesite ninguna instalación adicional.

Creamos una carpeta en nuestro escritorio llamada test

Entramos en ella y pinchamos en la barra de direcciones para que se ponga azul:

Pulsamos la tecla borrar y escribimos cmd e intro:

En el cmd que aparece escribimos «echo . >miPrograma.bat» para crear el archivo desde el cmd:

Para abrirlo escribimos «notepad miPrograma.bat»:

rem comando para que no aparezcan las instrucciones
@echo off
rem comando para borrar la pantalla
cls
echo introduce tu nombre:
rem comando para alcenar en la variable nombre lo que escribes por teclado
set /p nombre=
echo Tu nombre es: %nombre%
rem comando para poner en pausa hasta que se pulse una tecla
PAUSE

Pinchamos en archivo->guardar o Control +G y cerramos

Hacemos 2 clicks en el archivo para ejecutarlo:

Ya tenemos nuestro programa para pasárselo a nuestros amigos.

Ahora vamos a comitearlo.

3.Los comandos que debes aprender

Git es un sistema de fotos de los archivos que forman parte de nuestro proyecto de tal forma que podemos volver a un estado anterior y recuperar el código o los archivos antiguos.

Si borras la carpeta oculta llamada «.git» que está en la raíz de tu proyecto puedes empezar de cero con git init.

Una vez aprendido los siguientes 7 comandos ya podrás crear y manejar tus proyectos en github.

git init

git init nos crea una carpeta oculta llama .git en la raiz de nuestro proyecto donde se almacenan los cambios o versiones, es decir, inicializa el git en nuestro proyecto:

De nuevo vamos al cmd y ahora escribimos git init

Para ver la carpeta oculta que nos crea, vamos a Vista->Opciones->cambiar opciones de carpeta y búsqueda, pinchamos en la pestaña ver y marcamos Mostrar archivo, carpetas y unidades ocultas:

Nos aparecerá el archivo que contiene nuestros los estados y commits, borrándolo le quitamos el git o controlador de versiones a nuestro programa:

git status

Este comando nos muestra el estado de nuestro proyecto

Si escribimos «git status» podemos ver que nuestro programa no está versionado o restreado o sin seguimiento:

git add (git add . o git add all)

Este comando nos permite añadir al rastreador los archivos que le indiquemos, github dice que esta acción es añadir los archivos al «stage area».

Para rastrear o versionar o añadir al stage area todos los archivos a la vez que haya dentro de nuestra carpeta escribimos «git add .» (el punto es para decirle que lo añada todo a partir del directorio raiz) o git add all:

Si escribimos «git status», de nuevo veremos que ya se está rastreando y que solo falta echarle la foto o commitearlo:

git commit (git commit -m “Mi primer commit»)

Este comando nos permite hacerle una foto al estado actual y asociarla a un código llamado hash, de tal forma que podamos volver a un estado anterior con otro comando que veremos más adelante.

Ahora escribimos git commit -m “Mi primer commit» , el -m es de -message, para hacerle la foto, no lo copies ya que he comprobado que las cmillas dobles no se copian bien en el terminal, escríbelas a mano:

Pero, un momento! Nos dice que no sabe quien es el autor ni su email!!! Hay que decírselo para poder seguir…

git config

Este comando nos permite configurar algunas opciones generales del programa git y que serán guardadas para siempre y de manera global en nuestro pc. Una vez escritas ya no tendrás que volver a escribirlas.

Nos dice que no sabe quien es el autor ni su email!!! Hay que decírselo para poder seguir, en mi caso avanza@tipolisto.es y avanza:

Escribe:

git config –global user.email “tu@correo”

git config –global user.name “tu_usuario”

Ahora si:

Pulsamos intro:

Una vez comiteado, escribimos «git status» para ver lo que pasa:

En nuestro caso nos dice que en la rama main (no te preocupes por eso de las ramas) no hay nada que commitear.

git log, head, índice

Nos muestra todos los commits que hemos hecho con su hash.

Ahora git log:

Fíjate en este código, cuando hagamos muchos commits nos tendremos que mover ayudándonos de él (solo de los 4 rimero dígitos) llamado hash:

Dentro aparecen dos palabras nuevas;

El HEAD que es el commit más reciente de la rama actual.

El índice es el stage area o la zona donde se meten los archivos en seguimiento y que tiene el nombre de la rama.

4.Creando cuenta en github

Es como el centro donde todos se guían, todos los colaboradores que estén autorizados a hacer cambios en él tendrán que hacer constantes actualizaciones con git pull para que sus proyectos estén al día.

Github es la central donde van a estar todos nuestros proyectos versionados, vamos a github (https://github.com/) y pinchamos en Sign up para crear una cuenta en github:

Le ponemos nuestro correo, en mi caso avanza@tipolisto.es:

Una contraseña:

Un usuario que esté disponible:

Y continuar:

Pinchamos en Verificar:

Hacemos las tontearías que nos pide:

Vamos a ver el correo que nos dice que nos ha mandado un código:

Le ponemos el código del correo:

Vale, iniciamos sesión:

Rellenamos más tontearías:

Ya lo tenemos!!

Vamos a subir nuestro programa, pinchamos en public (para que todo el mundo vea lo que hemos hecho) y en Create new repository:

Aunque varios de estos comandos ya los tenemos hechos, vamos copiando y pegando en el cmd uno a uno los comandos que salen pero en lugar de git add README.md escribimos git add .:

Lamentablemente la opción para conectarnos vía https se deshabilitó en 2021:

Para poder autenticarnos a través de la API de github (la API es como una puerta trasera para comunicarnos, está el API y la web), y que nos dé acceso desde nuestro pc, tenemos varias formas, como los access token, los actions workflow, etc.. pero la forma más habitual es la de las claves ssh:

5. Las claves ssh, probando la conexión

SSH (securty shell) es una mini aplicación integrada dentro de git bash.

Gitbash es programa que se instala junto con el instalador de git:

Abrimos gitbash y escribimos:

ssh-keygen -t rsa -C “tu_email_que_le_pusiste_a_github@tu_dominio”, en mi caso avanza@tipolisto.es

Aquí nos pide el nombre del archivo que contendrá la clave privada, pulsamos intro:

Para la contraseña pulsamos dos intros más para dejarla en blanco ya que no queremos una contraseña:

En este punto nos ha creado los archivos de id_rsa y id_rsa.pub en la ruta “C:\Users\tu_usuario\.ssh”:

Abrimos el archivo id_rsa.pub y con vscode y copiamos el contenido:

Ahora vamos al github y pinchamos en nuestro perfil para mostrar el menú:

2, pinchamos en settings:

Vamos a SSH and GPG keys y pinchamos en New SSH key:

Vamos de nuevo al gitbash y para probar que funciona escribimos:

ssh -T git@github.com

A partir de este punto ya podremos hacer un «git push origin main» pero en lugar de la dirección https, tendrás que usar el usuario@equipo que es git@dirección_repositorio, el comando git push sabe lo que hacer con él, fíjate en la foto:

Ahora al pinchar en nuestro programa, podremos ver que nuestros archivos se han subido:

A partir de este punto ya no tienes que hacer nada más que crear y borrar repositorios (o tus proyectos en github) para probar y ver lo que pasa.

El punto 6 «Vscode» , 7 «borrando repositorios» y 8 «La ayuda» es opcional.

6. VScode y su complemento integrado git

Nos lo bajamos (https://code.visualstudio.com/download) y lo cerramos todo:

Marca estas 2 casillas para que aprezca en el menú conecttual de windows al hacer click en el botón derecho del ratón:

Arrastramos nuestra carpeta dentro para poder trabajar dentro de ella:

Vamos a crear un archivo nuevo solo por modificar nuestro proyecto y que aparezca en github:

Pinchamos en Terminal->New terminal:

En el terminal escribimos «git add .» o «git add all», «git commit -m «Segundo commit» y «git push -u origin main» :

No copies y pegues las comillas dobles que salen mal en el terminal, escríbelas a amano.

Nos saldrá un mensaje que dice que la extensión o complemento de git que tiene integrado el Vscode quiere conectar con github, le decimos que permitir:

Se abre una web y pinchamos en «Continue»:

Ahora pinchamos en «Authorize Visual-Studio_Code»

y en «Abrir Visual Studio Code»:

Ahora ya funcionará la parte del git dentro de vscode:

Fíjate que ya no es necesario utilizar la terminal, crea otro archivo de prueba , aparece en el icono de git un pequeño globo con un 1 y las letras «otro.txt» en verde, te está diciendo que son cambiaos que no han sido versionados o rastreados :