DEV Community

Cover image for 🚀 Guía para principiantes: instalación y uso de GitHub CLI 🛠️
The Eagle 🦅
The Eagle 🦅

Posted on

2

🚀 Guía para principiantes: instalación y uso de GitHub CLI 🛠️

¿Por qué usar GitHub CLI?

GitHub CLI lleva GitHub a tu terminal. Te permite clonar, crear, bifurcar y ver repositorios, así como manejar issues y pull requests con comandos para listar, crear, ver y fusionar estos. También puedes gestionar gists, activar y revisar los workflows de GitHub Actions, y hacer solicitudes directas a la API. Además, tienes opciones de autenticación y configuración disponibles para gestionar el acceso y los settings, mientras que las funcionalidades de búsqueda te ayudan a encontrar repositorios, issues y más.


Parte 1: Instalar GitHub CLI 🔨

macOS 🍎

gh está disponible a través de Homebrew, MacPorts, Conda, Spack, Webi, y como un binario descargable que incluye el instalador para Mac OS .pkg desde la página de lanzamientos.

# Homebrew
brew install gh

# MacPorts
sudo port install gh

# Conda
conda install gh --channel conda-forge

# Spack
spack install gh

# Webi
curl -sS https://webi.sh/gh | sh
Enter fullscreen mode Exit fullscreen mode

Windows 🪟

gh está disponible a través de WinGet, scoop, Chocolatey, Conda, Webi, y como instalador MSI.

# WinGet
winget install --id GitHub.cli

# scoop
scoop install gh

# Chocolatey
choco install gh

# Conda
conda install gh --channel conda-forge

# Spack
spack install gh

# Webi
curl -sS https://webi.sh/gh | sh
Enter fullscreen mode Exit fullscreen mode

Linux 🐧

Aquí realmente depende de lo que estés usando; puedes leer la documentación de instalación para Linux para encontrar lo que necesitas, o verificar aquí los comandos dependiendo de la distribución que estés usando.

# Arch
sudo pacman -S github-cli

# Debian, Ubuntu Linux, Raspberry Pi OS (apt)
(type -p wget >/dev/null || (sudo apt update && sudo apt-get install wget -y)) \
&& sudo mkdir -p -m 755 /etc/apt/keyrings \
&& wget -qO- https://cli.github.com/packages/githubcli-archive-keyring.gpg | sudo tee /etc/apt/keyrings/githubcli-archive-keyring.gpg > /dev/null \
&& sudo chmod go+r /etc/apt/keyrings/githubcli-archive-keyring.gpg \
&& echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/githubcli-archive-keyring.gpg] https://cli.github.com/packages stable main" | sudo tee /etc/apt/sources.list.d/github-cli.list > /dev/null \
&& sudo apt update \
&& sudo apt install gh -y
# Actualizar
sudo apt update
sudo apt install gh

# Fedora, CentOS, Red Hat Enterprise Linux (dnf)
sudo dnf install 'dnf-command(config-manager)'
sudo dnf config-manager --add-repo https://cli.github.com/packages/rpm/gh-cli.repo
sudo dnf install gh --repo gh-cli
# Alternativamente, instalar desde el repositorio comunitario:
sudo dnf install gh
# Actualizar
sudo dnf update gh

# openSUSE/SUSE Linux (zypper)
sudo zypper addrepo https://cli.github.com/packages/rpm/gh-cli.repo
sudo zypper ref
sudo zypper install gh
# Actualizar
sudo zypper ref
sudo zypper update gh
Enter fullscreen mode Exit fullscreen mode

Parte 2: Iniciar sesión 🔐

Primero escribe en tu terminal:

gh auth login
Enter fullscreen mode Exit fullscreen mode

Te pedirá:

? ¿En qué cuenta deseas iniciar sesión?  [Usa las flechas para moverte, escribe para filtrar]
> GitHub.com
  GitHub Enterprise Server
Enter fullscreen mode Exit fullscreen mode

Si eliges GitHub.com, te pedirá:

? ¿Cuál es tu protocolo preferido para las operaciones de Git en este host?  [Usa las flechas para moverte, escribe para filtrar]
> HTTPS
  SSH
Enter fullscreen mode Exit fullscreen mode

A continuación, te preguntará tu protocolo y preferencia personal. Recomiendo SSH.

? ¿Cuál es tu protocolo preferido para las operaciones de Git en este host?  [Usa las flechas para moverte, escribe para filtrar]
  HTTPS
> SSH
Enter fullscreen mode Exit fullscreen mode

Ahora solo crea la contraseña para tu clave SSH, el título y selecciona cómo te gustaría autenticarte, y si es la primera vez, solo usa Iniciar sesión con un navegador web.

? ¿Generar una nueva clave SSH para agregar a tu cuenta de GitHub? (Y/n) Y

 Ingresa una frase de contraseña para tu nueva clave SSH (Opcional): **************************

? Título para tu clave SSH: (GitHub CLI) TheMachine-Desktop

? ¿Cómo te gustaría autenticar GitHub CLI?  [Usa las flechas para moverte, escribe para filtrar]
> Iniciar sesión con un navegador web
  Pegar un token de autenticación

! Primero copia tu código de un solo uso: 1234-ABCD
Presiona Enter para abrir github.com en tu navegador... 
Enter fullscreen mode Exit fullscreen mode

🎉 ¡Felicidades! 🎉, ahora puedes usar GitHub desde tu terminal 🖥️. Si escribes gh auth status, deberías obtener algo como esto:

$ gh auth status
github.com
   Conectado a la cuenta github.com nombredeusuario (/home/username/.config/gh/hosts.yml)
  - Cuenta activa: true
  - Protocolo de operaciones de Git: ssh
  - Token: ...
  - Ámbitos del token: ....
Enter fullscreen mode Exit fullscreen mode

Parte 3: Comandos útiles 📝

Aquí te daré ⭐Mis 5 comandos principales en GitHub CLI🏅 para que te hagas una idea de lo que eres capaz de hacer, pero siéntete libre de revisar la documentación para obtener un conocimiento más profundo de esta herramienta.

1 - Clonar un repositorio de GitHub 🥇: gh repo clone owner/repo

gh repo clone chrislgarry/Apollo-11
Enter fullscreen mode Exit fullscreen mode

Bonus 🎁:
Como estás usando ssh, también puedes ir a esta sección de un repositorio de GitHub:

Mostrando el repositorio de GitHub, la pestaña donde puedes seleccionar http, ssh o github cli
Y git clone de esta manera:

git clone git@github.com:chrislgarry/Apollo-11.git
Enter fullscreen mode Exit fullscreen mode

Y puedes ver el README.md del repositorio:

 gh repo view chrislgarry/Apollo-11
Enter fullscreen mode Exit fullscreen mode

Terminal mostrando la descripción de GitHub
2 - Crear un nuevo repositorio en GitHub 🥈: gh repo create repo, puedes usar opciones como --public, private, --description <string> y más.

gh repo create my-new-repo --public
Enter fullscreen mode Exit fullscreen mode

3 - Crear un nuevo gist 🥉: gh gist create <file>

gh gist create file.txt
Enter fullscreen mode Exit fullscreen mode

Bonus 🎁:
También puedes listar los gists:

gh gist list
Enter fullscreen mode Exit fullscreen mode

4 - Crear un nuevo issue 🏅: gh issue create --title <title> --body <body>

gh issue create --title "Título del issue" --body "Cuerpo del issue"
Enter fullscreen mode Exit fullscreen mode

Bonus 🎁:
También puedes crear issues:

gh issue create --title "Título del issue" --body "

Cuerpo del issue"
Enter fullscreen mode Exit fullscreen mode

ver issues:

gh issue view <número-del-issue>
Enter fullscreen mode Exit fullscreen mode

Y cerrar issues:

gh issue close <número-del-issue>
Enter fullscreen mode Exit fullscreen mode

5 - Listar pull requests 🌟: gh pr list

gh pr list
Enter fullscreen mode Exit fullscreen mode

Bonus 🎁:
También puedes ver la pull request:

gh pr view <número-del-pr>
Enter fullscreen mode Exit fullscreen mode

fusionar una pull request:

gh pr merge <número-del-pr>
Enter fullscreen mode Exit fullscreen mode

Y revisarla:

gh pr review --approve --body "¡Se ve bien!"
Enter fullscreen mode Exit fullscreen mode

Pensamientos finales 🎉

GitHub CLI lleva GitHub a tu terminal, ¡haciendo que sea increíblemente poderoso! 🚀 Espero que hayas encontrado útil este post y que te haya inspirado a sacar el máximo provecho de esta herramienta. ¡No olvides suscribirte para recibir más actualizaciones de mis futuros posts! 🙌🖥️


Fuentes 📚

Instalar GitHub CLI
Instalar GitHub CLI en Linux
Manual de GitHub CLI
Código de Apollo 11


Aquí me gustaría agregar una frase personal, pero todavía estoy pensando/buscando una 😂

Top comments (0)

Sentry image

See why 4M developers consider Sentry, “not bad.”

Fixing code doesn’t have to be the worst part of your day. Learn how Sentry can help.

Learn more