How-to-use-Github

In this repository we will learn a few essential things for Github. We are going to do step by step three things. The first one: Create a Repository on Github. Second One: Do a commit. Third One: Sign Commits with a GPG Key. Good Luck 😁

Uso básico de Git

Se aprenderán las funciones esenciales para dar un desarrollo y desenvolverse de manera óptima en el hámbito de trabajo junto a Nautilus Cyberneering.

Tareas

Crear un repo en Github
Hacer commits
Firmar commits con clave GPG.

Crear Repositorio en Github

• Crear cuenta en GitHub.com y comprobar la dirección de correo electrónico.
• Acceder a Inicio
• Clickar en el +
  • New Repository
• Rellenar los campos: - Repository Name - Description (opcional) - Pública o Privada - Añadir un Readme.md (recomendable)
• Create Repository

Vista final del primer paso(Crear un repositorio.)

Hacer Commits

Hay varias maneras de hacer commits, en este caso veremos dos, subiendo el propio archivo arrastrándolo desde la carpeta donde la tengamos hasta Github (eficaz pero poco práctico) y también desde la propia consola o github Desktop en mi caso usaré github Desktop.

Desde Github

• Entramos al repositorio
• Clickamos en Add file - Upload Files
• Arrastramos el archivo a esta zona:
• Esperamos a que cargue
• Rellenamos los campos del commit
• Seleccionamos si queremos que el commit vaya directamente al main o a una rama.(Yo lo haré a una nueva rama y le asignaré el nombre de Primer commit de prueba).
• Clickas en Propose changes
• Seleccionamos create pull request
• Finalmente le damos a merge pull request
• Y le damos a Confirm merge Debería aparecer lo siguiente

Desde GitHub Desktop

• Entramos en GitHub Desktop
• Iniciamos sesión con nuestro GitHub que creamos anteriormente
• Seleccionamos el repositorio en el que estamos trabajando
• se vería de la siguiente manera: No tenemos ningún cambio hecho para hacer el commit por lo tanto tendremos que añadir algo a nuestro proyecto.
• Una vez hechos los cambios se verá de la siguiente manera: Ya esá todo listo para el siguiente commit
• Debemos rellenar las casillas de abajo para poder realizar el commit
• Le damos a Commit to main para mandar los cambios y pasarlos a la rama principal
• Clickamos en push origin
• Ya estaría el commit realizado.

No hay que olvidar que también se puede hacer con comandos desde la terminal sin embargo GitHub Desktop es mucho más intuitiva y fácil de usar, siendo así más óptimo en tiempo y evitando o disminuyendo considerablemente la posibilidad de cometer errores.

Firmar Commits con clave GPG

Seguiremos los pasos de este tutorial: https://secure-git.guide/

En mi caso lo instalé en MAC, ahora deberemos continuar con este otro tutorial para configurar las claves GPG mediante este tutorial: https://docs.github.com/en/authentication/managing-commit-signature-verification/generating-a-new-gpg-key Comenzamos con la generación de claves y su configuración

Escribimos en consola gpg para comprobar que está instalado.

- Creamos un par de claves

gpg --full-generate-key

Pulsamos enter y se pondrá la elección por defecto Volvemos a pulsar enter y se gardará el tamaño de key por defecto Ahora continuaremos eligiendo tiempo de caducidad de la key

Por seguridad es recomendable ponerle fecha de caducidad

Le pusimos una fecha de caducidad de 1 año

Nos dirá que tenemos que añadir una id:

GnuPG needs to construct a user ID to identify your key.

Nos dirá de crear una passphrase (contraseña) de al menos 8 carácteres.

- Listar la forma larga de las claves GPG

gpg --list-secret-keys --keyid-format=long

Mi clave en este caso es la larga: 37EF7936C57B357C

• Copiamos el siguiente texto y en lugar de mi clave pone la suya

    gpg --armor --export 37EF7936C57B357C 
  

• Copiamos la clave GPG, empezando por [-----BEGIN PGP PUBLIC KEY BLOCK-----] y terminando por [-----BEGIN PGP PUBLIC KEY BLOCK-----]

    La parte de consola a estaría terminada
  

• Entramos en Github

  • Clickamos en nuestra foto de perfil en la parte superior a la derecha
  • 
  • Settings
  • En la parte de Acces, vamos a SSH and GPG keys.
  • 
  • New GPG key
  • 
  • En title ponemos un nombre a nuestra clave GPG
  • EN Key se pone toda la clave pública añadiendo también el texto de begin y end
  • Add GPG key

• Autorizamos la key

• Ya quedaría hecha la key

Firma del commit con GPG Key

---

Subimos git global nuestro nombre y correo(este debe ser el mismo que usamos en github). Activamos el gpg a la hora de activarse un commit además de su tag y dreccion de gpg

Buscamos la ubicación de gpg

Comprobamos el funconamiento

Ejecutamos en la terminal de Visual Studio Code los siguientes comandos

Entramos en github y comprobamos que esté verificado el cambio

Eso sería todo.