Skip to content

Latest commit

 

History

History
148 lines (98 loc) · 5.33 KB

setup.md

File metadata and controls

148 lines (98 loc) · 5.33 KB

Setup necesario

Para el taller es necesario que puedas interactuar en GitHub utilizando Git. Para esto es necesario que tengas 2 cosas:

  • Una cuenta en GitHub
  • Una manera de correr Git

A continuación te explicamos como hacerlo, y más abajo podrás ver como probar que todo funciona.

❗ Importante: Aquí se asume que conoces que es un terminal y como correr los comandos que se muestran.

Crear una cuenta en GitHub

GitHub es una plataforma para trabajar y compartir código. Puedes crearte una cuenta en github.com.

💡 ProTip: Luego de crear tu cuenta, puedes solicitar beneficios para estudiantes del GitHub Student Developer Pack.

Utilizar Git

Git es un programa para controlar las versiones de código y otros archivos de texto plano. En el taller se explicará su funcionamiento.

Para poder probarlo durante el taller, tienes 2 opciones:

  • Configurar Git en tu computador
  • Utilizar GitHub Codespaces para correr Git en la nube

Configurar Git en tu computador

Instalar Git

Puedes leer la sección 1.5 y 1.6 del libro Pro Git que entra en más detalles sobre la instalación de Git.

  1. Instala Git
  2. Configura tu nombre, correo, editor y rama por defecto: 
    # TU nombre y mail
git config --global user.name "Tu nombre"
git config --global user.email [email protected]

# El editor que se abrirá en ciertas situaciones
git config --global core.editor code  # por ejemplo vscode

# La rama por defecto
git config --global init.defaultBranch main

Vincular la cuenta de GitHub con Git

Uno puede vincularse a GitHub de 3 maneras: HTTPS, SSH y GitHub cli.

HTTPS

HTTPS utiliza un sistema de tokens para autenticar a los usuarios. Para clonar este repositorio por HTTPS, se usa:

git clone https://github.com/open-source-uc/taller-git-y-github-2023-2.git

Uno puede clonar un repositorio público utilizando HTTPS sin ingresar ninguna credencial, pero al momento de querer subir cambios o clonar un repositorio privado, deberás usar credenciales para autenticarte.

❗ Importante: GitHub no pedirá tu contraseña, sino que te pedirá que ingreses un token.

Puedes crear e ingresar un token cada vez que lo necesites, pero es más conveniente instalar Git Credential Manager para que maneje la autentificación por ti. Viene instalado por defecto en Windows, en macOS y Linux puedes instalarlo siguiendo estas instrucciones.

SSH

SSH utiliza un sistema de llaves para autenticar a los usuarios. Para clonar este repositorio por SSH, se usa:

git clone [email protected]:open-source-uc/taller-git-y-github-2023-2.git

No vamos a entrar en detalle sobre SSH aquí, pero puedes aprender sobre como se usa leyendo la sección 4.3 y 6.1 de Pro Git, la documentación de GitHub sobre SSH y la guía de BenjaVicente sobre SSH.

GitHub CLI

GitHub CLI es una herramienta propia de GitHub que te permite interactuar con GitHub desde la terminal. Puedes instalarla en su página principal y configurarlo siguiendo las instrucciones de su manual, que se resumen en correr:

gh auth login

Luego podrás clonar este repositorio con:

gh repo clone open-source-uc/taller-git-y-github-2023-2

Utilizar GitHub Codespaces

GitHub Codespaces es un entorno de desarrollo instantáneo que corre en la nube para que puedas hacer, básicamente, todo lo que haces en tu IDE, pero en tu buscador ✨ Esto signfica que puedes llevar tu experiencia de VSCode a tu buscador, para así programar en máquinas en la nube más potentes y contenidas.

Para empezar a utilizar GitHub Codespaces -tal como lo indica esta guía oficial- puedes hacerlo al crear un nuevo repositorio y se te dará la opción. Igualmente, si quieres utilizar un Codespace en un repositorio ya existente, puedes hacerlo haciendo click en el botón "Code" para clonar un repositorio, ahí podrás ver la opción para utilizar tu Codespace.

image

Si deseas aprender más en profunidad en cómo utilizar GitHub Codespaces, puedes hacerlo acá.

Pro Tip: ¡Prueba jugar creando un Codespace! 🎏

Como comprobar que todo funciona

  1. Crea un repositorio en GitHub.
  2. Clona el repositorio (git clone <url>).
  3. Abre el repositorio localmente o en GitHub Codespaces.
  4. Edita un archivo.
  5. Añade los cambios (git add . && git commit -m "setup")
  6. Sube los cambios (git push)
  7. Ve que los cambios aparecen en GitHub.